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")
}