IncludeRegistryKey

IT Asset Management (Cloud)

Command line | Registry

Set IncludeRegistryKey to instruct the FlexNet Inventory Agent to return the contents of the specified registry keys or values in the uploaded .ndi (inventory) file. (Applies to Microsoft Windows devices only, and is ignored on UNIX-like platforms.)

Note: This setting is useful only in on-premises implementations.

In order to collect all values under a specified key, the (case sensitive) key path specified must end with a trailing backslash. If the path specified corresponds to a key (rather than a registry value) but does not end with a trailing backslash, only the (Default) value (if it is set) for the specified key will be collected.

Tip: In the registry, default values are typically not set.

For example:

• HKLM\SOFTWARE\ManageSoft Corp\ManageSoft\ will track all values under the specified key (because it has a trailing backslash)
• HKLM\SOFTWARE\ManageSoft Corp\ManageSoft will only track the (Default) values under the specified key (where they exist).

Important: If you choose to set this preference on a 64-bit target inventory device, add only the 32-bit registry path (as shown in the above examples), and omit the Wow6432Node path. From this one 32-bit setting, the FlexNet Inventory Agent gathers registry keys from both the 32-bit and 64-bit registry paths. In the uploaded .ndi file, these are differentiated with pseudo-root values of HKLM32 and HKLM64, with the remainder of the paths the same (that is, Wow6432Node does not appear in the reported paths).

When setting this preference, you can use:

• The * wildcard to replace a key or value (including multiple times for different key elements in a single path)
• The abbreviations HKLM, HKCU, HKCR, HKU, HKCC – these will be automatically expanded to appropriate values
• A semicolon or comma to separate multiple registry paths.

Tip: Although in the FlexNet Inventory Scanner case, ndtrack.exe does not read preferences from the registry to modify its own behavior, it can still be instructed to collect registry keys and values to return in inventory. To modify the default value (shown below) for registry key(s) to be read by FlexNet Inventory Scanner, set the special case on the command line.

Important: While IncludeRegistryKey controls inclusion of registry values in the uploaded inventory .ndi file, there is no way in the cloud implementation to import those registry values into either the inventory database or the compliance database.

Values

Values / range

Valid registry key or value

Default value

If no value is specified, the FlexNet Inventory Agent (and FlexNet Inventory Scanner) use the 'Uninstall' registry entries, typically:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\

and include any keys and values thereunder in the returned inventory.

Note: If you modify the value of IncludeRegistryKey, be sure to include the default value as well, as this is used during collection of software inventory on the inventory device. Separate multiple paths in this preference with semicolons.

Example values

Track all registry keys and values under HKEY_LOCAL_MACHINE\SOFTWARE:

HKLM\SOFTWARE\*\

Track all values (only) under HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft:

HKLM\SOFTWARE\Microsoft\*

Use multiple wildcards:

HKLM\SOFTWARE\*\CurrentVersion\*\*

Command line

Tool

Inventory component (ndtrack)

Example

-o IncludeRegistryKey="HKEY_LOCAL_MACHINE\
SOFTWARE\Microsoft\Command Processor\"

Registry

Installed by	Manual configuration (without which, code internals supply the default)
Computer preference	[Registry]\ManageSoft\Tracker\CurrentVersion