Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Use Windows Remote Management for classification

You can configure the discovery of Windows hosts using the Windows Remote Management (WinRM) protocol.

Before you begin

  • Install and configure a Windows MID Server on the local network.
  • WinRM service must be enabled on all discoverable Windows hosts.

Roles required: discovery_admin, agent_admin, admin

About this task

By default, the system uses the WMI protocol for device classification of Windows hosts. Administrators can instead use the WinRM protocol for more efficient lightweight data transfer and remote command execution.

Procedure

  1. Enable the WinRM service on all Windows hosts you want to discover.

  2. Navigate to Discovery > MID Servers.

  3. Select the MID Server you will use for discovery of Windows hosts.

    The system displays the MID Server record.

  4. From the Configuration Parameters related list click New.

    The system displays a MID Server Configuration Parameter record.

  5. In the Parameter name field, select the mid.windows.management_protocol parameter from the choice list.

  6. Enter a value of WinRM.

Image omitted: MIDServerConfigParameter.png
MID Server configuration parameter
  1. Click Submit.

    The system displays the MID Server record.

  2. Add other Windows Remote Management protocol parameters as needed.

    ParameterDescriptionDefaultRequires MID Server restart
    mid.powershell_api.winrm.remote_portSpecifies the communications port the MID Server uses to communicate with the WinRM protocol.5985No
    mid.powershell_api.session_pool.target.max_sizeSpecifies the maximum number of sessions allowed in the pool per target host.2Yes
    mid.powershell_api.session_pool.max_sizeSpecifies the maximum number of sessions allowed in the session pool.25Yes
    mid.powershell_api.idle_session_timeoutSpecifies the timeout value of idle Powershell sessions in seconds.60Yes

What to do next

Run a discovery from the Discovery schedule to find Windows machines on your network.