# Sys_GetSerialNumber

> Gets the computers serial number from BIOS, and returns it in gsValue.

Source: https://docs.capaone.com/capainstaller/vb-scripting-library/osd-scripting-library/system-functions-osd/sys-getserialnumber/  
Product: CapaInstaller — a separate CapaSystems product; do not apply this page to any other.

[VB Scripting Library](/capainstaller/vb-scripting-library/) > [OSD Scripting Library](/capainstaller/vb-scripting-library/osd-scripting-library/) > [System functions (OSD)](/capainstaller/vb-scripting-library/osd-scripting-library/system-functions-osd/)

### Sys_GetSerialNumber()

Gets the computers serial number from BIOS, and returns it in gsValue.  
If a serial number can be located in BIOS, gbValue is TRUE, otherwise it returns FALSE.

### Arguments

No arguments provided.

### Return Type

Boolean, TRUE if function completed successfully.

### Remarks

Typpically used in the PreBootScript.wsf

### Example

The following example will retrieve the serial number and display a warning to the user if no serial number can be found.

:::note
This function is called by the OSD_Initialize function, which stores the serial number in the gsSerialNumber variable.
:::

**VBScript**

```vb
Private Function IncludeScript(sScriptFile)
 '...
End Function

'Begin
  bStatus=True
  If bStatus Then bStatus=IncludeScript("customlib.cis")
  If bStatus Then bStatus=IncludeLibrary("Capalib.cin")
  If bStatus Then bStatus=IncludeLibrary("Osdlib.cin")
  If bStatus Then bStatus=Job_Start("WS","Script Name","1.0","ScriptName.log","INSTALL")
  If bStatus Then bStatus=OSD_Initialize()

  If bStatus Then bStatus=Sys_GetSerialNumber()
  If bStatus and NOT gbValue Then bStatus=Dialog_ShowWarning("No serial number found in BIOS")

  Job_End(bStatus)
'End main

```

### See Also

[Scripting Guidelines](/capainstaller/vb-scripting-library/scripting-guidelines/), [Dialog_ShowWarning](/capainstaller/vb-scripting-library/osd-scripting-library/dialog-functions-osd/dialog-showwarning/) [Constants](/capainstaller/vb-scripting-library/addendum/constants/) [Package Property](/capainstaller/vb-scripting-library/addendum/package-property/) [Variables](/capainstaller/vb-scripting-library/addendum/variables/)
