App Layering エージェントのインストール
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スナップインがインストールされていることを確認する必要があります。アプライアンスへのエージェントの手動登録の手順を参照してください。
以前にApp Layeringエージェントをインストールしたことがある場合は、Citrix®ダウンロードページから更新バージョンをダウンロードできます。エージェントのインストールパッケージは、App Layering ZIPダウンロードに含まれています。
App Layering エージェントのダウンロード
- Citrixのホームページにアクセスし、[サインイン]をクリックします。
- [ダウンロード]をクリックし、リストから[Citrix App Layering™]を選択します。
- Citrix App Layeringページで、[Citrix App Layering] > [製品ソフトウェア]の下にある[Citrix App Layering]をクリックします。
- ページの下部にある[ツール]をクリックします。
- Citrix App Layeringエージェントの[ファイルのダウンロード]をクリックします。
ファイル
citrix_app_layering_agent_installer.exeがコンピューターにダウンロードされます。
App Layering エージェントのインストール
App Layering エージェントのインストーラーは、App Layeringアプライアンスにエージェントを登録するように求めます。インストール中にエージェントを登録しない場合でも、後で手動で登録できます。ただし、PowerShellスクリプトを実行するには、エージェントがアプライアンスに登録されている必要があることに注意してください。
-
管理者権限を持つアカウントを使用して、エージェントをインストールするシステムにログオンします。
-
Citrix_app_layering_agent_installer.exeファイルをサーバー上の任意の場所にコピーします。 -
Citrix_app_layering_agent_installer.exeを管理者として実行し、プロンプトが表示されたら、App Layeringエージェントをインストールするディレクトリへのパスを入力します。デフォルトの場所はC:\\Program Files (x86)\Citrix\Agentです。エージェントインストーラーは、すべての前提条件が存在するかどうかを確認します。前提条件が不足している場合、インストーラーはそれを報告し、インストールせずに終了します。
-
インストーラーはエージェントのポート番号を求めます。デフォルトのポート番号（8016）を受け入れるか、デフォルトのポートがすでに使用されている場合は別のポートを指定できます。
-
インストーラーは、App Layeringアプライアンスの資格情報（アドレス、ユーザー名、パスワード）を求めます。管理者権限を持つアプライアンスの管理コンソールユーザーのIPアドレスとログオン資格情報（たとえば、管理コンソールにログオンするために使用する資格情報）を入力して、App Layeringエージェントをアプライアンスに登録します。
注：
App Layeringアプライアンスが利用できない場合、または今すぐ登録しないことを選択した場合は、「アプライアンスへのApp Layeringエージェントの手動登録」で説明されている手順を使用して、後で手動で登録できます。
-
[完了]をクリックしてウィザードを終了します。
アプライアンスへのApp Layeringエージェントの手動登録
App Layeringエージェントをアプライアンスに登録します。
インストール中にApp LayeringエージェントがApp Layeringアプライアンスに登録されなかった場合は、以下の手順を使用して後で登録できます。
-
管理者として、App Layeringエージェントをインストールしたサーバーにログオンします。
-
管理者としてコマンドウィンドウ（
cmd.exe）を開き、App Layeringエージェントがインストールされているディレクトリに移動します。デフォルトの場所はC:\\Program Files (x86)\Citrix\Agentです。 -
次のPowerShellコマンドを実行します。
Enable-PSRemoting <!--NeedCopy--> -
次のコマンドを実行して、ポート8016が開いていることを確認します。
netstat -a <!--NeedCopy--> -
管理者としてコマンドウィンドウ（
cmd.exe）を開き、App Layeringエージェントがインストールされているディレクトリに移動します。デフォルトの場所は次のとおりです。C:\Program Files (x86)\Citrix\Agent <!--NeedCopy--> -
示されているアプライアンスのIPアドレスを使用して、次のコマンドを実行します。
Citrix.AppLayering.Agent.Service.exe register /i /e:IP_address_of_appliance /u:Administrator <!--NeedCopy--> -
プロンプトが表示されたら、アプライアンスの管理コンソールで管理者権限を持つユーザーのパスワードを入力します。
-
登録プロセスが完了すると、成功したことを通知するメッセージが表示されます。App Layeringエージェントの登録は、管理サービスの監査ログに表示されます。
プロセスが成功しない場合は、インストールディレクトリにあるエージェントログファイルを確認してください。
C:\\Program Files (x86)\Citrix\agent\Logs\applayering.agent.log次のコマンドを実行して、App Layeringエージェントのコマンドラインオプションのヘルプを表示することもできます。
Citrix.AppLayering.Agent.Service.exe /? <!--NeedCopy--> -
Citrix Provisioning Serverで適切なDLLファイルをロードするためにPowerShellコマンドを実行します。
PVS 7.7以降の場合：
-
次の場所に移動します。
C:\program files\citrix\provisioning services console <!--NeedCopy--> -
次のコマンドを実行します。
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe Citrix.PVS.snapin.dll <!--NeedCopy-->
PVS 7.1～7.6の場合：
-
次の場所に移動します。
C:\program files\citrix\provisioning services console <!--NeedCopy--> -
次のコマンドを実行します。
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe McliPSSnapIn.dll <!--NeedCopy-->
メジャーなWindowsアップデート後などに、一部のCitrix ProvisioningおよびBrokerスナップインが登録解除された場合は、それらを見つけてください。
-
-
登録されているスナップインを一覧表示するには、次のコマンドを実行します。
get-pssnapin -registered <!--NeedCopy--> -
すべてのスナップインを再登録する手順については、この記事を参照してください。