Collector MSI parameters reference table

Mandatory parameters

These parameters are mandatory to establish connection with your Nexthink instance.

Parameter name	Default value	Description
CRD_KEY	–	Customer key of the Nexthink instance.
CRD_PORT	443	Nexthink instance port number for the TCP channel.
DATA_OVER_TCP	enable	Send end-user data over the TCP channel of Collector. Values: disable enable
DRV_IP	–	Fully Qualified Domain Name (FQDN) of the Nexthink instance.

Parameters managed from the Nexthink platform

Once a device is migrated to device configuration profiles, you can only manage the following settings in the Nexthink UI. The system then ignores the equivalent MSI parameters, including new installations.

Refer to the Device configuration profiles documentation.

MSI parameter	Device configuration profile setting
ANONYMIZE_USERNAME	User name
UPN_PRIVACY	User Principal Name (UPN)
WINDOW_FOCUS_TIME_MONITORING	Application focus time
USER_INTERACTION_TIME_MONITORING	User interaction time
ANONYMIZE_WIFI_NETWORK	Wi-Fi network names
CONNECTIONS_REPORTING	Network connections
DOMAIN_NAME_REPORTING	Network connections
DATA_PRIVACY_FILTER	Network connections (advanced filtering)

Optional parameters

Parameters marked Managed in device configuration profiles stop applying once your tenant migrates to device configuration profiles, including on new installations.

Parameter name	Collector built-in default values	Description
ANONYMIZE_USERNAME	cleartext	Manages the reporting of the user logon name from the device. See Collector level anonymization for more details. Values: cleartext hashed no_import ℹ️ Setting managed in device configuration profiles. Refer to the Device configuration profiles documentation.
ANONYMIZE_WIFI_NETWORK	enable	Manages the reporting of the identification details for both the SSID and the BSSID with Wi-Fi performance metrics. See Collector level anonymization for more details. Values: enable disable ℹ️ Setting managed in device configuration profiles. Refer to the Device configuration profiles documentation.
APP_STARTUP_DURATION	disable	Enable or disable the Application Startup Duration feature.
APP_STARTUP_DURATION_ALLOWLIST	chrome.exe,firefox.exe,msedge.exe, winword.exe,excel.exe,powerpnt.exe, outlook.exe,olk.exe,onenote.exe,acrobat.exe,acrord32.exe,ms-teams.exe,msteams.exe,zoom.exe	The list of applications for which the application startup duration is measured.
ARPNOMODIFY	1	Disables the Add or Remove Programs functionality in the Control Panel. This functionality modifies the product. In Windows 2000, this disables the Modify button for the product in Add or Remove Programs in the Control Panel. In earlier operating systems, clicking the Add or Remove Programs button uninstalls the product rather than entering the maintenance mode wizard. ℹ️ The Collector MSI package does not support this feature. You must set ARPNOMODIFY to 1.
ARPNOREMOVE	–	Setting the ARPNOREMOVE property disables the Add or Remove Programs functionality in the Control Panel. This functionality removes the product. In Windows 2000, this disables the Remove button for the product from the Add or Remove Programs in the Control Panel. In earlier operating systems, it removes the product from the list of installed products on the Add or Remove Programs in the Control Panel.
ARPNOREPAIR	–	Disables the Repair button in the Programs Wizard.
ARPSYSTEMCOMPONENT	–	Prevents the application from being displayed in the Add or Remove Programs list of the Control Panel.
CFG_INSTALL	1	Install the Nxtcfg tool to change the Collector configuration from the Command Line Interface (CLI). Values: 0 – Do not install 1 – Install
CONNECTIONS_REPORTING	enable	Enable or disable the connections data reporting from Application Connectivity. ℹ️ Setting managed in device configuration profiles. Refer to the Device configuration profiles documentation.
CUSTOM_SHELLS	0	Enable reporting user logon events and user interactions in virtualized and embedded environments, for example, in kiosk mode. Values: 0 – Disable 1 – Enable
DATA_PRIVACY_FILTER	““	Reports network connections according to user-defined ALLOW / BLOCK rules. See Collector level anonymization for more details. ℹ️ Setting managed in device configuration profiles. Refer to the Device configuration profiles documentation.
DISK_EXCLUSION_LIST	L"NVMe BC711 NVMe SK hynix"	Comma-separated list of disk drivers to exclude from SMART analysis.
DOMAIN_NAME_REPORTING	disable	Enable or disable the reporting of domain names from Application Connectivity. See Collector level anonymization for more details. ℹ️ Setting managed in device configuration profiles. Refer to the Device configuration profiles documentation.
DRV_ACTIVATE_DMP	0	Specifies whether the target system should be configured to generate memory dumps in case of a STOP message, for example, a System crash. Values: 0 – Disable 1 – Full memory dump 2 – Kernel memory dump; Nexthink recommends this value 3 – Memory minidump ℹ️ This setting is non-reversible. Uninstalling Collector 3 does not roll it back to its initial value. The MSI package does not change the system setting to a less verbose memory dump. For example, take the following settings: The system setting generates kernel memory dumps. DRV_ACTIVATE_DMP is set to 3, which is memory minidump. In this case, the system setting takes precedence.
DRV_BFBD	0	The delay in seconds during driver initialization before Collector starts communicating with the Nexthink instance. Maximum value: 240 (equal to 4 minutes)
DRV_CGPI	240	The CrashGuard Protection Interval Value. This is the time interval in minutes since booting, after which a dirty reboot does not increase the CrashGuard. The default value of 240 minutes equals to 4 hours.
DRV_CRASHGUARD	5	The maximum CrashGuard count that Collector can reach before canceling the load of the driver at boot-time. 0 – Disable CrashGuard feature
DRV_DESC	0	Specifies whether to delay communication socket creation. To avoid traffic blocking by certain firewalls, the system creates the Collector socket layer during the last steps of the initialization. Values: 0 – Disable 1 – Enable
DRV_DWEF	0	Disables the Windows enumerate functionality. Values: 0 – Disable function 1 – Collector does not report when Windows freezes or when the application stops responding. Finder does not display any information about the application not responding.
DRV_LOGMODE	0	Specifies the logging mode. Values: 0 – Silent 1 – Verbose 2 – Debug; this value is not recommended
DRV_LOGSIZE	32	Add log rotation when enabling DRV_LOGMODE for logging. Value range in megabytes: 1–512
DRV_PKGI	1	The period in hours during which Collector checks for new installed packages and updates, and reports them. Values range from 0–24, as follows: 0 – Never report packages 1 – Report packages after Collector initializes and then every 1 hour 2–24 – Report packages 45 minutes after Collector initializes; then every 2 to 24 hours
DRV_PREFERIPV6	0	Favor either IPv6 or IPv4 for communicating with the Nexthink instance when the DNS lookup resolves to both IPv6 and IPv4 addresses. Values: 0 – Use IPv4 1 – Use IPv6
DRV_REACTIVATION	168	Reactivate Collector once the set time has elapsed, after reaching the maximum CrashGuard count. Time is given in hours. The default value of 168 hours equals to 7 days. Maximum value in hours: 8766 (equals to 1 year)
DRV_STRING_TAG	–	A string that identifies and organizes installations of Collector. Values: any string with up to 2048 characters
DRV_TAG	0	An integer that identifies and organizes installations of Collector. Value range: 0–2147483647
DRV_WEB_AND_CLOUD_DATA	1	(classic) Gather Web and Cloud information. Values: 0 – Do not record the web connections of devices 1 – Gather and send the data; requires the Web and Cloud product; default value
DRV_WEB_AND_CLOUD_HOSTS	–	(classic) A list of comma-separated host names. The system sends the full URL of each web request for these hosts. This requires the Web and Cloud product and the parameter DRV_WEB_AND_CLOUD_DATA set to 1.
ENGAGE	enable_except_on_server_os	Enable features to engage with end-users either on: All devices Devices that are not running a server operating system Values: disable enable enable_except_on_server_os
INSTALL_BROWSER_EXTENSION	not_set	Deploys the Application Experience Extension when set to enable. Values: enable disable
PROXY_ADDRESS	–	The FQDN or IP address of the proxy in manual proxy configuration.
PROXY_PAC_ADDRESS	–	URL of the PAC file to automatically configure the proxy settings.
PROXY_PORT	–	The port number where the proxy is listening in manual proxy configuration.
RA_EXECUTION_POLICY	signed_trusted_or_nexthink	The execution policy of remote actions. Values: disabled signed_trusted signed_trusted_or_nexthink unrestricted
REBOOT	–	Suppresses certain prompts for system restart. An administrator typically uses this property with a series of installations to install several products at the same time, with only one restart at the end. The ForceReboot and ScheduleReboot actions inform the installer to prompt the user to restart the system. The installer can also determine that a restart is necessary based on whether there are any ForceReboot or ScheduleReboot actions in the sequence. For example, the installer automatically prompts a restart if it needs to replace any files in use during the installation. Values: Force – Always prompt for a restart at the end of the installation. If there is no user interface, and the installation is not a multiple-package installation, the system automatically restarts at the end. If the installation is a multiple-package installation, there is no automatic system restart and the installer returns the ERROR_SUCCESS_REBOOT_REQUIRED error message. Suppress – Suppress prompts for a restart at the end of the installation. For example, restart prompts when trying to install a file currently in use. The installer still prompts the user with an option to restart during the installation whenever it encounters the ForceReboot action. If there is no user interface, the system automatically restarts at each ForceReboot. ReallySuppress – Suppress all restarts and restart prompts initiated by ForceReboot during the installation. For example, restart prompts when trying to install a file in use. Suppress all restarts and restart prompts at the end of the installation.
RECONNECT_DELAY	60	Maximum delay between reconnects in seconds.
UPN_PRIVACY	no_import	Controls User Principal Name (UPN) reporting policy. See Collector level anonymization for more details. Values: cleartext hashed no_import ℹ️ Setting managed in device configuration profiles. Refer to the Device configuration profiles documentation.
USER_INTERACTION_TIME_MONITORING	enable	Controls the reporting of the time the user was interacting with the mouse, touchpad or keyboard. See Collector level anonymization for more details. Values: enable disable ℹ️ Setting managed in device configuration profiles. Refer to the Device configuration profiles documentation.
VDI_CLIENT_PLUGIN_PING_ADDRESS	–	Set the host to ping from the client to calculate ISP and WAN latency. This information is pushed from the VM to the client. Populated NQL data model field: client.network.wan_latency
VDI_PLATFORM_TYPE	–	Force the detection of Citrix or Azure Virtual Desktop (AVD) / Cloud PC (CPC) if there are multiple agents in a given VM. Values: Auto — Auto detection using agent registry keys when available AVD — Forces AVD detection; prevents Windows365 detection Citrix — Forces Citrix detection Horizon — Forces Horizon detection Windows365 — Forces Windows 365 / CloudPC detection Missing or unknown value — Auto detection using agent registry keys when available
WINDOW_FOCUS_TIME_MONITORING	disable	Reports the application focus duration while the application’s windows were in focus. See Collector level anonymization for more details. Values: enable disable ℹ️ Setting managed in device configuration profiles. Refer to the Device configuration profiles documentation.

Deprecated parameters

Parameter name	Default value	Comment
CRD_ROOT_CA	–	Do not use this feature when using the Nexthink cloud platform.
DRV_PORT	–	Do not use this feature when using the Nexthink cloud platform.
USE_ASSIGNMENT	disable	Disables the rule-based Collector assignment. Set the option to enable to activate rule-based assignment in Collector. Values: enable disable

Execution remark

In unattended execution mode, all choices are silently accepted. For example, if the parameter REBOOT is set to Force, the computer automatically reboots after MSI package installation.

Casing of properties

Always specify MSI parameter names in capital letters. MSI parameters with lowercase letters in an MST are considered private properties. This means you cannot modify them from the CLI.