You can add an endpoint and configure the PowerShell plug-in to connect to a running PowerShell host, so that you can call PowerShell scripts and cmdlets from vRealize Orchestrator actions and workflows, and work with the result.

Before you begin

  • Verify that you have access to a Windows PowerShell host. For more information about Microsoft Windows PowerShell, see the Windows PowerShell documentation.

  • Log in to the vRealize Automation console as a tenant administrator.

Procedure

  1. Select Administration > Endpoints > OrchestratorEndpoints.
  2. Click the New icon (Add).
  3. Select PowerShell from the Plug-in drop-down menu.
  4. Click Next.
  5. Enter a name and, optionally, a description.
  6. Click Next.
  7. Specify the PowerShell host details.
    1. Enter the name of the host in the Name text box.
    2. Enter the IP address or the FDQN of the host in the Host/IP text box.
  8. Select the PowerShell host type to which the plug-in connects.

    Option

    Action

    WinRM

    1. Enter the port number to use for communication with the host in the Port text box under the PowerShell host details.

    2. Select a transport protocol from the Transport protocol drop-down menu.

      Note:

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

    3. Select the authentication type from the Authentication drop-down menu.

      Note:

      To use Kerberos authentication, enable it on the WinRM service. For information about configuring Kerberos authentication, see Using the PowerShell Plug-In.

    SSH

    None.

  9. Enter the credentials for a shared session communication with the PowerShell host in the User name and Password text boxes.
  10. Click Finish.

Results

You added an Windows PowerShell host as an endpoint. XaaS architects can use the XaaS to publish PowerShell plug-in workflows as catalog items and resource actions.