$cs.CustomInventory_GetCategoryNames

CapaOne

Description

Returns the names of the custom inventory categories on the device. Returns an empty array if there are none. Takes no parameters. Windows-only.

For how custom inventory is stored in categories, instances and values, see $cs.CustomInventory_SetValue.

Collected only by CapaOne

The function works on any Windows device, also under CapaInstaller, and reads the data in the registry under HKLM\SOFTWARE\CapaSystems\CapaOneAgent\CustomInventory. Only the CapaOne agent collects that data, with its hardware inventory. On a device without the CapaOne agent, the data stays in the registry.

Syntax

$cs.CustomInventory_GetCategoryNames()

Parameters

None.

Return value

Array of category names (string[]). Empty array if the device has no custom inventory.

Example

• PowerShell

$categories = $cs.CustomInventory_GetCategoryNames()
$cs.Job_WriteLog("Custom inventory categories: $($categories -join ', ')")

Logging the instances of every category:

foreach ($category in $cs.CustomInventory_GetCategoryNames()) {
    $instances = $cs.CustomInventory_GetInstanceNames($category)
    $cs.Job_WriteLog("$category has $($instances.Count) instances: $($instances -join ', ')")
}

Related functions

$cs.CustomInventory_GetCategory $cs.CustomInventory_GetInstanceNames $cs.CustomInventory_RemoveCategory