CMS\_AddHardwareInventory

Description

Adds a HardwareInventory row to the database that is persistent, meaning that the data will not be flushed out the next time that the HardwareInventory package is run.

Syntax

:vb: CMS_AddHardwareInventory(category, entry, value, valuetype)

:ps: [bool]CMS_AddHardwareInventory -category <string> -entry <string> -value <string> -valuetype <string>

Parameters

category (String)

Category name

entry (String)

variable name

value (string)

value (string)

If you are inserting a Time (valuetype: “T”) it must be set in epoch-time, meaning seconds since January 1. 1970. The scripting library has a function called GetEpochTime, which will convert a date to seconds since 1-1-1970.

If you want to use ‘now’ as the value, you can either insert;

an empty string ("")
or the value (“0”)

valuetype (string)

The type of the value

Valid valuetypes are;

“S” for string
“I” for integer
“T” for time

Return value

:vb: Boolean, TRUE if function completed successfully.

:ps: Boolean, TRUE if function completed successfully.

Example

:vb: VBScript

If bStatus Then bStatus = CMS_AddHardwareInventory("BIOS Information", "Socket type", "Mill-A" "S")
If bStatus Then bStatus = CMS_AddHardwareInventory("CPU", "Fan speed", "1360" "I")
If bStatus Then bStatus = CMS_AddHardwareInventory("Sound Adapter", "SoundBlaster compatiple", "True" "S")

:ps: PowerShell

CMS_AddHardwareInventory 'BIOS Information' 'Socket type' 'Mill-A' 'S'

CMS_AddHardwareInventory -category 'CPU -entry 'Fan speed' -value '1360' -valuetype 'I'

if (CMS_AddHardwareInventory 'Sound Adapter' 'SoundBlaster compatiple' 'True' 'S') {
  $cs.Job_WriteLog("Added", "Added SoundBlaster adapter to Hardware inventory")
}

Scripting Guidelines

CMS_RemoveHardwareInventory