Skip to content

Installing the Anyware Remote Workstation Card Agent for Windows

Download the Remote Workstation Card Agent for Windows Installer

The Remote Workstation Card Agent for Windows installs at the system level and is available to all users. You must have administrator privileges to install it. You can download the installer directly onto the machine, or download it separately and transfer it yourself.

The installer can be downloaded here.

Install or Update the Remote Workstation Card Agent for Windows

Once the installer is present on the desktop, you can run the setup wizard or install it silently using a script. The procedure is the same for new installations and system upgrades.

Installing the Remote Workstation Card Agent for Windows using the Wizard

If you're installing the Remote Workstation Card Agent for Windows via the Windows interface and would prefer to use a graphical interface and guided setup, use the Remote Workstation Card Agent for Windows setup wizard.

Important: Required ports will be automatically opened

The Remote Workstation Card Agent for Windows installer will add firewall exceptions for the following required PCoIP ports during installation: TCP 443, TCP 4172, UDP 4172, and TCP 60443.

To install the Remote Workstation Card Agent for Windows using the setup wizard:

  1. Temporarily connect a physical display, mouse, and keyboard to the machine for installation.

  2. Navigate to the Remote Workstation Card Agent for Windows installer file and launch it. The setup wizard will appear.

  3. Select an installer language and click OK.

  4. Click Next at the welcome screen.

  5. Review and accept the license agreement by clicking I agree.

  6. Specify an installation directory and click Install.

    By default, the software will be installed in the C:\Program Files (x86)\Teradici\Remote Workstation Card Agent for Windows directory.

  7. Provide your licensing information on the License Registration screen.

    Type or paste a registration code in the Registration code field and click Next for the proxy settings screen.

    Important: Local license server users

    If you are using a local License Server, do not enter a registration code here. Select Not now and then click Next instead. You will configure your license server information later.

    • If you use a proxy server to access the internet, select Use a proxy server for Internet connection and specify the address and port numbers of the proxy server, then click Next to register the license.

    • If your system does not use a proxy server, leave this screen unchanged and click Next to register the license.

  8. The Windows desktop must be rebooted to complete installation; you can choose to do that now, or do it yourself later. Some features may not work until the system is restarted.

  9. Click Finish to exit the installer.

  10. If you skipped license registration, complete registration by following one of the procedures listed here.

  11. Disconnect the monitor, keyboard, and mouse.

Scripted Installations

The Remote Workstation Card Agent for Windows can be installed on the desktop programmatically, without using a graphical interface. The installation will proceed silently and the system will reboot when finished.

Scripted installation requires access to the Windows Command Prompt or PowerShell.

Important: Required ports will be automatically opened

The Remote Workstation Card Agent for Windows installer will add firewall exceptions for the following required PCoIP ports during installation: TCP 443, TCP 4172, UDP 4172, and TCP 60443.

To install the Remote Workstation Card Agent for Windows via a script:

  1. Temporarily connect a physical display, mouse, and keyboard to the machine for installation.

  2. Copy the agent installer file to the desktop.

  3. Run the agent installer using one of the following methods:

    • Windows BAT: Open a Windows command line tool and enter the following:

          start /WAIT <path_to_installer> /S /NoPostReboot
    echo %ERRORLEVEL%

      ...where <path_to_installer> is the system filepath of the installer file.

    • Windows PowerShell: Open a PowerShell window and enter the following:

          $process = Start-Process -FilePath <path_to_installer> -ArgumentList "/S /NoPostReboot _?<path_to_installer>" -Wait -PassThru $process.ExitCode
      ...where <path_to_installer> is the system filepath of the installer file. Note that this argument is used twice!

    Both methods will return one of these process return codes:

    code description
    0 success
    1 installation aborted by user (user cancel)
    2 installation aborted due to error
    1641 success, reboot required

  4. If you are using Cloud Licensing, register the Remote Workstation Card Agent for Windows's license by running the pcoip-register-host.ps1 script:

    C:\Program Files (x86)\Teradici\Remote Workstation Card Agent for Windows\pcoip-register-host.ps1 [‑ProxyServer <String>] [‑ProxyPort <String>] ‑RegistrationCode <String> [<CommonParameters>]

    Where:

    • -RegistrationCode sets the registration code to use.
    • -ProxyServer sets the address of your proxy server, if you have one.
    • -ProxyPort sets the port number of your proxy server, if you have one.

    Important: PowerShell execution policy

    PowerShell scripts must be permitted to run on your machine. If your execution policy prevents pcoip-register-host.ps1 from running, you can temporarily enable PowerShell script execution with the following command:

        powershell.exe ‑InputFormat None ‑ExecutionPolicy Bypass ‑Command .\pcoip-register-host.ps1

Register a License After Installation

In most cases, a PCoIP license is registered during installation. If you are using a local license server, or if you skipped registration during installation, you can register your agent using the methods described next.