Windows Discovery parameters

These parameters control several aspects of Windows discovery..

Table 1. Windows Discovery parameters
Label Names Description
Enable or Disable the enforcement of UTF-8 for command output. mid.powershell.enforce_utf8 Enable this parameter to force commands on a target Windows system to return UTF-8 encoded output. Disabling it allows the target system to use its default encoding. This parameter is only valid when PowerShell is enabled.
Setting this value to false may result in incorrect values in the CMDB when non-ASCII characters are returned by a probe.
  • Type: True | False
  • Default value: true
Enable PowerShell for Discovery. mid.use_powershell Specifies whether to enable PowerShell for Discovery. The MID Server requires PowerShell version 2 to operate. If the MID Server cannot find the correct version of PowerShell, it uses WMIRunner instead.
  • Type: True | False
  • Default value: false
Enable/Disable automatically falling back to the MID Server service user credential if all other credentials fail. mid.powershell.local_mid_service_credential_fallback Specifies the login credentials the MID Server uses if all other credentials fail.
  • Type: True | False
  • Default value: false
Timeout for Windows probes. mid.windows.probe_timeout Specifies the timeout value for the Windows probe, in seconds. The default value is 5 minutes.
  • Type: Integer
  • Default value: 300 seconds
MSSQL credentials for PowerShell. mid.powershell.use_mssqlauth Determines whether PowerShell should use Integrated Windows Authentication, also known as Windows Integrated Security, or SQL authentication when attempting to log into the MSSQL instance. PowerShell uses Windows Integrated Security by default.
  • Type: True | False
  • Default value: false
Powershell use credentials table. mid.powershell.use_credentials Specifies whether PowerShell Discovery should use the Windows credentials from the credentials table. To use PowerShell Discovery on a single domain, set this parameter to false, and then restart the MID Server . In this case, the MID Server runs the probes with the credentials of the user for the MID Server process.
  • Type: True | False
  • Default value: true
Path to Powershell executable. mid.powershell.path

Enables an administrator to point to a specific PowerShell on a MID Server in cases where more than one PowerShell is installed. Supply the path to the directory containing the PowerShell executable, for example, C:\mypowershell or C:\mypowershell\. ServiceNow automatically appends the string powershell.exe to the path.

This parameter might be necessary when both 32-bit and 64-bit PowerShells are active on the same MID Server , and it becomes necessary to launch the correct PowerShell for the context. Note that 64-bit Windows employs file system redirection and the MID Server runs as a 32-bit application. If the path is in %WinDir%\System32, Windows automatically redirects to %WinDir%\SysWOW64. To avoid redirection, specify the path as %WinDir%\Sysnative. An example would be to specify C:\WINDOWS\sysnative\WindowsPowerShell\v1.0\ instead of C:\WINDOWS\system32\WindowsPowerShell\v1.0\.
Note: On a 64-bit version of Windows Server 2003 or Windows XP, a Microsoft hotfix may be required to enable this capability.
  • Type: String (path)
  • Default value: none
Set the protocol MID Servers use to communicate with remote Windows hosts. mid.windows.management_protocol
Enables administrators to select the Windows management protocol used for device and process classification. Options include:
  • WMI
  • WinRM
  • Type: String
  • Default value: WMI
Set the port WinRM will use to connect to remote hosts. mid.powershell_api.winrm.remote_port Specifies the communications port the MID Server uses to communicate with Windows Remote Management (WinRM) protocol.
  • Type: Integer
  • Default value: 5985
Maximum number of sessions allowed in the pool per target. mid.powershell_api.session_pool.target.max_size

Specifies the maximum number of sessions allowed in the pool per target host.

Note: Setting or changing this parameter requires restarting the MID Server.
  • Type: Integer
  • Default value: 2
Maximum number of sessions allowed in the session pool. mid.powershell_api.session_pool.max_size

Specifies the maximum number of sessions allowed in the session pool.

Note: Setting or changing this parameter requires restarting the MID Server.
  • Type: Integer
  • Default value: 25
Idle Powershell session timeout (seconds). mid.powershell_api.idle_session_timeout

Specifies the timeout value of idle Powershell sessions in seconds.

Note: Setting or changing this parameter requires restarting the MID Server.
  • Type: Integer
  • Default value: 60
Timeout for all Windows probes on a MID Server. windows_probe_timeout Sets the timeout interval for all Windows probes on a specific MID Server . This value is overridden by the values configured for individual probes with the wmi_timeout probe parameter.
  • Type: Integer
  • Default value: none