CMS_AddHardwareInventory
Description
Section titled “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
Section titled “Syntax”CMS_AddHardwareInventory(category, entry, value, valuetype) As Boolean[bool] CMS_AddHardwareInventory -category <string> -entry <string> -value <string> -valuetype <string>Parameters
Section titled “Parameters”category (String)
Section titled “category (String)”Category name
entry (String)
Section titled “entry (String)”variable name
value (string)
Section titled “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)
Section titled “valuetype (string)”The type of the value
Valid valuetypes are;
- “S” for string
- “I” for integer
- “T” for time
Any other value type makes the function fail. If the entry already exists, its value is updated.
Return value
Section titled “Return value”Boolean, TRUE if function completed successfully.
Boolean, TRUE if function completed successfully.
Example
Section titled “Example”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")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")}Related functions
Section titled “Related functions”CMS_RemoveHardwareInventory Constants Package Property Variables Business Unit support