App Layering エージェントをインストールする

最終公開日 : Oct 24, 2026
App Layering エージェントを使用すると、アプライアンスまたはパッケージングマシンで PowerShell コマンドをローカルで実行できます。適切な資格情報を指定すると、エージェントは特定のユーザーとして PowerShell コマンドを実行できます。

エージェントが必要な場合

次の操作を計画している場合は、App Layering エージェントが必要です。
  • コネクタ構成を使用してスクリプトを起動する。
  • Microsoft Hyper-V で App Layering アプライアンスを実行する。
  • レイヤー化されたイメージを Citrix Provisioning に公開する。
エージェントは次の場所にインストールします。
  • レイヤー作成またはイメージ公開に使用する予定のすべての Hyper-V サーバー。
  • レイヤー化されたイメージを公開する予定のすべての Citrix Provisioning サーバー。
  • コネクタ構成が PowerShell スクリプトを実行する場所。

エージェントをアプライアンスに登録する

App Layering エージェントインストーラーは、エージェントを App Layering アプライアンスに登録するように求めます。インストール中にエージェントを登録しなかった場合でも、後で手動で登録できます。ただし、エージェントがアプライアンスに登録されるまで、PowerShell スクリプトは実行されません。

前提条件

App Layering エージェントをインストールする前に、エージェントをインストールするシステムが次の要件を満たしていることを確認してください。
  • 管理者権限を持つアカウント
  • .NET 4.5
  • PowerShell 3.0 以降
  • PowerShell スナップイン。Citrix Provisioning Services サーバーで App Layering エージェントを使用する前に、PowerShell スナップインがインストールされていることを確認する必要があります。アプライアンスに(/ja-jp/citrix-app-layering/4/install-agent.html#manually-register-the-app-layering-agent-with-the-appliance)エージェントを手動で登録する手順を参照してください。
以前に App Layering エージェントをインストールしたことがある場合は、Citrix® ダウンロードページから更新バージョンをダウンロードできます。エージェントのインストールパッケージは、App Layering ZIP ダウンロードに含まれています。

App Layering エージェントをダウンロードするには

  1. Citrix のホームページにアクセスし、サインインをクリックします。
  2. ダウンロードをクリックし、リストから Citrix App Layering™ を選択します。
  3. Citrix App Layering ページで、Citrix App Layering > 製品ソフトウェアの下にある Citrix App Layering をクリックします。
  4. ページの下部にあるツールをクリックします。
  5. Citrix App Layering エージェントのダウンロードファイルをクリックします。 citrix_app_layering_agent_installer.exe ファイルがコンピューターにダウンロードされます。

App Layering エージェントをインストールする

App Layering エージェントインストーラーは、App Layering アプライアンスにエージェントを登録するように求めます。インストール中にエージェントを登録しなかった場合でも、後で手動で登録できます。ただし、PowerShell スクリプトを実行するには、エージェントがアプライアンスに登録されている必要があることに注意してください。
  1. 管理者権限を持つアカウントを使用して、エージェントをインストールするシステムにログオンします。
  2. Citrix_app_layering_agent_installer.exe ファイルをサーバー上の任意の場所にコピーします。
  3. Citrix_app_layering_agent_installer.exe を管理者として実行し、プロンプトが表示されたら、App Layering エージェントをインストールするディレクトリへのパスを入力します。デフォルトの場所は C:\\Program Files (x86)\Citrix\Agent です。
    エージェントインストーラーは、すべての前提条件が揃っているかを確認します。いずれかの前提条件が不足している場合、インストーラーはそれを報告し、インストールせずに終了します。
  4. インストーラーはエージェントポート番号の入力を求めます。デフォルトのポート番号 (8016) を受け入れるか、デフォルトポートが既に使用されている場合は別のポート番号を指定できます。
  5. インストーラーは、App Layering アプライアンスの資格情報 (アドレス、ユーザー名、パスワード) の入力を求めます。管理者権限を持つアプライアンス上の管理コンソールユーザーの IP アドレスとログオン資格情報 (たとえば、管理コンソールにログオンするために使用する資格情報) を入力して、App Layering エージェントをアプライアンスに登録します。
    注:
    App Layering アプライアンスが利用できない場合、または今すぐ登録しないことを選択した場合でも、「App Layering アプライアンスへの手動登録」で説明されている手順を使用して、後で手動で登録できます。
  6. ウィザードを終了するには、 をクリックします。

App Layering エージェントをアプライアンスに手動で登録する

App Layering エージェントをアプライアンスに登録します。
App Layering エージェントがインストール中に App Layering アプライアンスに登録されなかった場合、以下の手順を使用して後で登録できます。
  1. 管理者として、App Layering エージェントをインストールしたサーバーにログオンします。
  2. 管理者としてコマンドウィンドウ (cmd.exe) を開き、App Layering エージェントがインストールされているディレクトリに移動します。デフォルトの場所は C:\\Program Files (x86)\Citrix\Agent です。
  3. 次の PowerShell コマンドを実行します。
    Enable-PSRemoting
  4. このコマンドを実行して、ポート 8016 が開いていることを確認します。
    netstat -a
  5. 管理者としてコマンドウィンドウ (cmd.exe) を開き、App Layering Agent がインストールされているディレクトリに移動します。デフォルトの場所は次のとおりです。
    C:\Program Files (x86)\Citrix\Agent
  6. 示されたアプライアンスの IP アドレスを使用して、次のコマンドを実行します。
    Citrix.AppLayering.Agent.Service.exe register /i /e:IP_address_of_appliance /u:Administrator
  7. プロンプトが表示されたら、アプライアンスの管理コンソールで管理者権限を持つユーザーのパスワードを入力します。
  8. 登録プロセスが完了すると、成功したことを知らせるメッセージが表示されます。App Layering エージェントの登録は、管理サービスの監査ログに表示されます。
    プロセスが成功しない場合は、インストールディレクトリにあるエージェントログファイルを確認してください。
    C:\\Program Files (x86)\Citrix\agent\Logs\applayering.agent.log
    次のコマンドを実行すると、App Layering エージェントのコマンドラインオプションのヘルプを表示することもできます。
    Citrix.AppLayering.Agent.Service.exe /??
  9. Citrix Provisioning Server で適切な DLL ファイルをロードするために PowerShell コマンドを実行します。
    PVS 7.7 以降の場合:
    1. 次に移動します。
      C:\program files\citrix\provisioning services console
    2. コマンドを実行します。
      C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe Citrix.PVS.snapin.dll
    PVS 7.1~7.6の場合:
    1. 以下に移動します:
      C:\program files\citrix\provisioning services console
    2. コマンドを実行します:
      C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe McliPSSnapIn.dll
    Citrix ProvisioningおよびBrokerのスナップインの一部が、例えば大規模なWindowsアップデート後に登録解除されている場合は、どれが登録解除されているかを確認してください。
  10. 登録されているスナップインを一覧表示するには、次のコマンドを実行します:
    get-pssnapin -registered
  11. すべてのスナップインを再登録する手順については、この記事を参照してください。