Standard Agent for Windows Administrators' Guide

Windows Installer の標準エージェントをダウンロードする

Anyware Agentはシステムレベルでインストールされ、すべてのユーザーが利用できます。インストールには管理者権限が必要です。インストーラーをコンピューターに直接ダウンロードするか、または別途ダウンロードして自分で転送することができます。

インストーラは ここをダウンロードできます。

Windows 用標準エージェントのインストールまたはアップデート

リモートマシンにファイルが表示されたら、 スクリプトを使用してセットアップ ウィザードを実行 するか、 静かにインストール します。新しいインストールとシステムアップグレードでも同じ手順です。

続行する前に、次の点に注意してください。

  • 動作中にインストーラーがハングする場合があります。少なくとも1分待つと完了します。

  • インストーラーが動作中に RDP セッションから切断されることがあります。インストールが停止せず、すぐに再接続することができます。

  • ESXi ユーザー向け: Anyware Agent の実行中は、デスクトップのグラフィックサブシステムが破損している可能性があります。Anywareクライアントで接続している場合のみ、システム GUI を表示できます。

    例えば、vファクス経由で ESXi 仮想マシンコンソールを表示できません。PCoIP を使用してマシンに接続する必要があります。

ウィザードを使用して Anyware Agent をインストールする

重要: 必要なポートが自動的に開きます

Windows インストーラーの標準エージェントでは、インストール中に以下の必要な PCoIP ポートについてファイアウォールの例外を追加します。TCP 443、TCP 4172、UDP 4172、および TCP 60443。

Windows インターフェイス経由で Anyware エージェントをインストールしている場合で、グラフィカルユーザーインターフェイスとガイド付きセットアップを使用したい場合は、Anyware Agent セットアップ ウィザードを使用してください。この方法は RDP 経由でのみ使用できます。そのため、既存のインストールを更新している場合、RDPセッションでウィザードを実行するか、代わりに スクリプトインストールを実行 します。

セットアップウィザードを使用して Anyware Agent をインストールする方法:

  1. まだ RDP セッションに入っていない場合は、RDPクライアントでデスクトップに接続します。

  2. Anywareエージェントインストーラファイルを開き、起動します。セットアップ ウィザードが表示されます。

    重要: USBサポートを使用せずにインストールする

    USBサポートなしで Anyware Agent をインストールするには、コマンドラインからインストーラを実行し、パラメータDisableUSBを含めます。インストーラーは実行されますが、USBサポートコンポーネントはすべてスキップします。この方法でインストールすると、デスクトップは標準キーボードやマウス以外のUSBデバイスをサポートできません。

  3. インストーラ言語を選択して、[ OK] をクリックします。

  4. [ようこそ] 画面で [ 次へ ] をクリックします。

  5. [同意します] をクリックして使用許諾契約書を確認し 、同意します

  6. インストール ディレクトリを指定し、[ インストール] をクリックします。

    デフォルトでは、ソフトウェアは C:\Program Files\Teradici\PCoIP Agent ディレクトリにインストールされます。

  7. [ライセンス登録] 画面でライセンス情報を提供します。

    重要: ローカル ライセンス サーバーのユーザー

    ローカル ライセンスサーバーを使用している場合は、ここで登録コードを入力しないでください。[ 今はしない] を選択し、代わりに [ 次へ ] をクリックします。ライセンスサーバー情報は 後ほど設定します。

    [登録コード ] フィールドに 登録コードを入力または貼り付け、[プロキシ設定] 画面の [ 次へ ] をクリックします。

    • プロキシサーバーを使用してインターネットにアクセスする場合は、[ インターネット接続にプロキシサーバーを使用 する] を選択し、プロキシサーバーのアドレスとポート番号を指定し、[ 次へ ] をクリックしてライセンスを登録します。

    • お使いのシステム プロキシサーバーが使用されない場合、この画面は変更されず、[ 次へ ] をクリックしてライセンスを登録します。

  8. インストールを完了するには、Windows デスクトップを再起動する必要があります。今すぐ実行するか、後で自分で実行するか選択することができます。一部の機能は、システムが再起動されるまで動作しないことがあります。

  9. [完了] をクリックして、インストーラを終了します。

  10. ライセンス登録を省略した場合は、下記のいずれかの手順に従って登録を完了 してください

  11. RDPセッションを切断します。

Anywareエージェントがインストールされ、ライセンス認証されると、それを 設定 するか、または Anyware クライアントと 接続 できます。

スクリプトインストール

Anyware Agentは、グラフィック インターフェースを使用せずに、デスクトップにすぐにインストールすることができます。インストールがサイレントに進み、完了するとシステムが再起動します。

スクリプトによるインストールには、Windows コマンド プロンプトまたは PowerShell へのアクセスが必要です。

重要: 必要なポートが自動的に開きます

Windows インストーラーの標準エージェントでは、インストール中に以下の必要な PCoIP ポートについてファイアウォールの例外を追加します。TCP 443、TCP 4172、UDP 4172、および TCP 60443。

スクリプトを介して Anyware Agent をインストールする方法:

  1. RDPまたはウェブカムのコンソールツールを使用してデスクトップに接続します。

  2. エージェントのインストーラーファイルをデスクトップにコピーします。

  3. 以下のいずれかの方法を使用してエージェントインストーラーを実行します。

    GPUプロンプトのトラブルシューティング

    インストーラーのGPUプロンプトを回避する必要がある場合は、以下のコマンドに /Force フラグを追加します。これは、GPU プロンプトが適用されない場合に、Windows 用標準エージェントを使用してPCを使用する際に便利です。

    About /NoPostReboot

    以下のコマンドに示される /NoPostReboot フラグは、インストーラにマシンを再起動しないように伝えます。省略した場合、インストーラーが終了するとマシンは再起動されます。

    • Windows BAT: Windows コマンドライン ツールを開き、以下を入力します。

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

      ...ここで <path_to_installer> はインストーラー ファイルのシステム ファイルパスです。

    • Windows PowerShell: [PowerShell] ウィンドウを開き、以下を入力します。

          $process = Start-Process -FilePath <path_to_installer> -ArgumentList "/S /NoPostReboot _?<path_to_installer>" -Wait -PassThru; $process.ExitCode
      

      ...ここで <path_to_installer> はインストーラー ファイルのシステム ファイルパスです。このご利用は2回ご注意ください!

    両方の方法でこれらのプロセスリターンコードのいずれかが返されます。

    コード説明
    0 成功
    1 ユーザーによりインストールが中止された (ユーザーのキャンセル)
    2 エラーのためインストールは中止されました
    1641 成功、リブートが必要
  4. クラウド ライセンスを使用している場合は、以下の pcoip-register-host.ps1 スクリプトを実行して Anyware エージェントのライセンスを登録します。

        "C:\Program Files\Teradici\PCoIP Agent\pcoip-register-host.ps1" [‑ProxyServer <String>] [‑ProxyPort <String>] ‑RegistrationCode <String> [<CommonParameters>]
    

    どこ:

    • -RegistrationCode 使用する登録コードを設定します。
    • -ProxyServer お使いのプロキシ サーバーがある場合は、そのアドレスを設定します。
    • -ProxyPort ある場合は、プロキシサーバーのポート番号を設定します。

    重要: PowerShell 実行ポリシー

    PowerShell スクリプトは、お使いのマシンで実行を許可されている必要があります。実行ポリシーにより pcoip-register-host.ps1 が実行できない場合は、次のコマンドで PowerShell スクリプトの実行を一時的に有効にしてください。

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

Anywareエージェントがインストールされ、ライセンス認証されると、それを 設定 するか、または Anyware クライアントと 接続 できます。

インストール後にライセンスを登録する

ほとんどの場合、インストール中に PCoIP ライセンスが登録されます。ローカルライセンスサーバーを使用している場合、またはインストール中に登録を省略した場合、次に記載される方法を使用してエージェントを登録することができます。


Last updated: Saturday, November 9, 2024