You can run a workflow to add a PowerShell host and configure the host connection parameters. 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, select 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.
  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.

    Per User Session

    The Orchestrator client retrieves credentials from the user who is logged in.

  10. Click Submit to run the workflow.


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