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