CMS_AddHardwareInventory
- Martin Gudme Søndergaard
- Torben Busk Sørensen
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.
Please note
Please note, that this is an expensive call, seen from the Frontend/database perspective. Calling this function repeatedly from a package could result in overall slower performance. This function should be used with care.
Syntax
CMS_AddHardwareInventory(category, entry, value, valuetype)
[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
Boolean, TRUE if function completed successfully.
Boolean, TRUE if function completed successfully.
Example
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")
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")
}