You add a PowerShell host and configure the host connection parameters by running a workflow. You can set up a connection to a remote or a local PowerShell host.


  1. Log in to the Orchestrator client as an administrator.
  2. Click the Workflows view in the Orchestrator client.
  3. In the workflows hierarchical list, expand Library > PowerShell > Configuration and navigate to the Add a PowerShell host workflow.
  4. Right-click the Add a PowerShell host workflow and select Start workflow.
  5. In the Name text box, type the name of the host.
  6. In the Host / IP text box, type the address of the host.

    The Kerberos authentication requires a Fully Qualified Domain Name (FQDN) host address.

  7. (Optional) In the Port text box, type the port of the host.

    You use port 5985 for the HTTP or 5986 for the HTTPS protocol.

  8. Select the PowerShell host type that the plug-in connects to.
    1. Select a transport protocol.

      If you use the HTTPS transport protocol, the certificate of the remote PowerShell host is imported into the Orchestrator keystore.

    2. Select the authentication type.

      If you want to use Kerberos authentication, you must enable it on the WinRM service.

  9. Select the type of session mode that the plug-in uses to connect to the PowerShell host.



    Shared Session

    The plug-in uses shared credentials to connect to the remote host. You must provide the PowerShell host credentials for the shared session.

    Session per User

    The Orchestrator client retrieves credentials from the user who is logged in. You must log in with a user@domain format to Orchestrator to use the Session per User mode.

  10. From the Shell Code Page drop-down menu, select the type of encoding that the PowerShell uses.
  11. Click Submit to run the workflow.


After the workflow runs successfully, the PowerShell host appears in the Inventory view.