Virtual desktop integration (VDI) PowerShell agents integrate with external virtual desktop system, such as XenDesktop and Citrix. Use a VDI PowerShell agent to manage the XenDesktop machine.

Prerequisites

Procedure

  1. Right-click the setup__vra-va-hostname.domain.name@5480.exe setup file and select Run as administrator.
  2. Click Next.
  3. Accept the license agreement and click Next.
  4. On the Log in page, supply administrator credentials for the vRealize Appliance and verify the SSL Certificate.
    1. Type the user name, which is root, and the password.

      The password is the password that you specified when you deployed the vRealize Appliance.

    2. Select Accept Certificate.
    3. Click View Certificate.

      Compare the certificate thumbprint with the thumbprint set for the vRealize Appliance. You can view the vRealize Appliance certificate in the client browser when the management console is accessed on port 5480.

  5. Click Next.
  6. Select Custom Install on the Installation Type page.
  7. Select Proxy Agents in the Component Selection pane.
  8. Accept the root install location or click Change and select an installation path.
  9. Click Next.
  10. Log in with administrator privileges for the Windows services on the installation machine.

    The service must run on the same installation machine.

  11. Click Next.
  12. Select VdiPowerShell from the Agent type list.
  13. Enter an identifier for this agent in the Agent name text box.

    Maintain a record of the agent name, credentials, endpoint name, and platform instance for each agent. You need this information to configure endpoints and to add hosts in the future.

    Important:

    Do not duplicate agent names unless you are installing redundant, identically configured agents for high availability.

    Option

    Description

    Redundant agent install

    Install redundant agents on different servers, but name and configure them identically to provide high-availability.

    Single agent install

    Select a unique name for this agent.

  14. Configure a connection to the Manager Service component.

    Option

    Description

    If you are using a load balancer

    Enter the fully qualified domain name and port number of the load balancer for the Manager Service component. For example, manager-load-balancer.eng.mycompany.com:443. IP addresses are not recognized.

    With no load balancer

    Enter the fully qualified domain name and port number of the machine where you installed the Manager Service component. For example, manager_service.mycompany.com:443. IP addresses are not recognized.

    The default port is 443.

  15. Configure a connection to the Manager Website component.

    Option

    Description

    If you are using a load balancer

    Enter the fully qualified domain name and port number of the load balancer for the Manager Website component. For example, website-load-balancer.eng.mycompany.com:443. IP addresses are not recognized.

    With no load balancer

    Enter the fully qualified domain name and port number of the machine where you installed the Manager Website component. For example, website_component.mycompany.com:443. IP addresses are not recognized.

    The default port is 443.

  16. Click Test to verify connectivity to each host.
  17. Select the VDI version.
  18. Enter the fully qualified domain name of the managed server in the VDI Server text box.
  19. Click Add.
  20. Click Next.
  21. Click Install to begin the installation.

    After several minutes a success message appears.

  22. Click Next.
  23. Click Finish.
  24. Verify that the installation is successful.
  25. (Optional) : Add multiple agents with different configurations and an endpoint on the same system.

What to do next

For high-availability, you can install and configure a redundant agent for your endpoint. Install each redundant agent on a separate server, but name and configure the agents identically.