SCCM を使用した VDA のインストール
概要
マイクロソフト エンドポイント コンフィグレーション マネージャー (旧称 System Center Configuration Manager (SCCM)) は、企業全体のデバイスとアプリケーションの管理、展開、セキュリティを可能にする Windows 製品です。
注:
以下の記事では、Citrix® が環境をテストした方法に基づいた推奨事項のみを説明しています。これらの手順は、お客様のニーズに合わせてカスタマイズできます。Citrix は、お客様のニーズに合わせてこれに必要な更新や調整について責任を負いません。
推奨事項
-
SCCM または類似のソフトウェア配布ツールを使用して Virtual Delivery Agent (VDA) を正常に展開するには、Citrix は一連の手順で VDA インストーラーを使用することを推奨します。
-
Citrix は、VDA のインストールまたはアップグレードの一部として VDA Cleanup Utility を使用することを推奨しません。VDA Cleanup Utility は、VDA インストーラーが以前に失敗した場合の限られたケースでのみ使用してください。
開始する前に
VDA のインストール中に必要な再起動の回数は、環境によって異なります。例:
- 以前のソフトウェアのインストールによる保留中の更新や再起動のために、再起動が必要になる場合があります。
- 他のプロセスによって以前にロックされたファイルは更新が必要になる場合があり、追加の再起動が強制されます。
- VDA インストーラーの一部のオプションコンポーネント (Citrix Profile Management や Citrix Files など) は、再起動が必要になる場合があります。
- VDA をアップグレードする場合、それがインストールされているマシンは、セッションがない状態でメンテナンスモードである必要があります。
- マシンで VDA のインストールが初めて実行されると、使用されている VDA インストーラーがそのマシンにコピーされます。 VDA のインストールに関する詳細については、インストーラーを参照してください。
SCCM Task Sequencer は、必要なすべての再起動を管理します。
SCCM を使用して VDA を展開するための主な手順
以下の手順では、仮想マシンに SCCM を使用して VDA を展開する方法について説明します。
- (/ja-jp/citrix-virtual-apps-desktops/2511/install-configure/install-vdas/third-party-vda-deployment-methods/install-vdas-sccm.html#step-1-install-the-vda)VDA をインストールする。
- (/ja-jp/citrix-virtual-apps-desktops/2511/install-configure/install-vdas/third-party-vda-deployment-methods/install-vdas-sccm.html#step-2-create-an-organization-unit-ou)組織単位 (OU) を作成する。
- (#step-3-verify-the-machines)マシンを検証する。
- (#step-4-use-vda-to-distribute-content)VDA を使用してコンテンツを配信する。
ステップ 1: VDA をインストールする
すべての(#before-you-begin)前提条件を特定した後、SCCM Task Sequencer を使用して、以下のタスクを完了します。
-
インストールメディアのアクセス可能なコピーから、または VDA スタンドアロンインストーラーのいずれかから VDA をインストールします。
VDAWorkstationSetup_XXXX.exeVDAServerSetup_XXXX.exeVDAWorkstationCoreSetup_XXXX.exe
VDA インストーラーの詳細については、(/ja-jp/citrix-virtual-apps-desktops/2511/install-configure/install-prepare#installers)インストーラーを参照してください。
注:
VDAをアップグレードする場合、インストールされているマシンはメンテナンスモードであり、セッションがない状態である必要があります。
- マシンでVDAのインストールが初めて実行されると、使用されているVDAインストーラーがそのマシンにコピーされます。
-
VDAWorkstationCoreSetup_XXXX.exe以外のVDAインストーラーを使用する場合、VDAインストーラーは%ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exeにコピーされます。 -
VDAWorkstationCoreSetup_XXXX.exeを使用する場合、VDAインストーラーは%ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe.にコピーされます。
-
-
VDAインストーラーのディレクトリの場所は、レジストリ
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”にも保存されます。 -
コマンドラインオプション
/NOREBOOT、/NORESUME、および/QUIETをコマンドラインオプションに追加します。-
/QUIET: インストール中にユーザーインターフェイスを表示しないことで、SCCMがインストールプロセスを制御できるようにします。 -
/NOREBOOT: VDAインストーラーが自動的に再起動するのを抑制します。SCCMは必要に応じて再起動をトリガーします。 -
/NORESUME: 通常、インストール中に再起動が必要な場合、VDAインストーラーはrunonceレジストリキー(\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce)を設定します。Windowsは、マシンが再起動したときにそのキーを使用してVDAインストーラーを開きます。これはSCCMにとって問題です。なぜなら、SCCMはインストールを監視して終了コードをキャプチャできないからです。
-
ステップ2: 組織単位 (OU) を作成する
-
OUに追加するドメイン参加済み仮想マシンを2台作成します。仮想マシンは最初に作成されたとき、Computersフォルダーにあります。仮想マシンをSCCMフォルダーに移動します。 例: WIN10EN-BB80MJ4.cseblr.com W2K19ST-EBPR3UG.cseblr.com

-
マイクロソフト コンフィギュレーション マネージャーで、
\Administration\Overview\Hierarchy Configuration\Discovery Methods\に移動します。 -
Active Directoryシステム検出をクリックし、Active Directoryシステム検出を有効にするチェックボックスをオンにして、新しく作成された仮想マシンの自動検出を有効にします。
-
アイコンをクリックして、新しいコンテナーを選択します。 -
「場所」セクションで、SCCM仮想マシンが配置されている「パス」を追加します。
-
\Administration\Overview\Site Configuration\Sitesに移動し、SCCM VDAを右クリックします。 -
「クライアントインストール設定 > クライアントプッシュインストール」を選択します。「クライアントプッシュインストールのプロパティ」ウィンドウが開きます。
-
VMが
Enabledに設定されると、次の図に示すようにVMのリストが表示されます。

-
OUを作成するために「デバイスコレクション」を作成します。コレクション名の「名前」を入力します。

-
ウィザードの指示に従います。

OUが作成されます。

-
作成されたVMを新しく作成されたデバイスコレクションに追加します。
-
VMを右クリックします。「選択した項目を追加 > 選択した項目を既存のデバイスコレクションに追加」を選択します。

-
「コレクションの選択」ウィンドウで、必要なデバイス名を選択します。この例では、
Devices-SCCMです。
Devices-SCCMは、「資産とコンプライアンス > 概要 > デバイスコレクション」にリストされています。
-
-
デバイスコレクターで「クライアントのインストール」を選択します。

-
必要なインストールサイトを選択します。

-
ウィザードの指示に従います。「Configuration Manager クライアントのインストールウィザード」が正常に完了しました。

詳細については、Microsoftドキュメントのコレクションの管理を参照してください。
ステップ3:マシンの確認
-
クライアントマシンで、
CCMExecプロセスが実行されているかどうかを確認して、クライアントがインストールされていることを確認します。
-
SCCM上のVMに対してクライアントが実行されていることを確認します。
ステップ4: VDAを使用してコンテンツを配布する
以下の手順では、展開されたVDAを使用して、関連する仮想マシンにコンテンツを配布する方法について説明します。
-
パッケージを作成する(#create-a-package)
-
コンテンツを配布する(#distribute-content)
パッケージを作成する
-
パッケージを作成するには、目的のVDAを右クリックし、パッケージの作成をクリックします。

-
このパッケージのソースファイルの場所を、参照をクリックして指定します。

-
目的のパッケージの種類を選択します。

-
パッケージの名前とコマンドラインを入力します。

-
次へをクリックします。

詳細については、Microsoft ドキュメントの Configuration Manager のパッケージとプログラム を参照してください。
コンテンツの配布
-
作成したパッケージ名を右クリックします。
-
コンテンツの配布を選択します。

-
コンテンツの配布ウィザードウィンドウで、作成したパッケージのソースファイルの場所を選択します。この例では、
2019-SCCMです。次へをクリックします。
-
パッケージ(この例では
Zodiac)が展開可能であることを確認します。
次の図は、パッケージが展開可能であることを示しています。

詳細については、Microsoft ドキュメントの Configuration Manager のコンテンツを展開および管理する を参照してください。
SCCM を使用したインストールシーケンスの例
次の例は、インストールシーケンスを示しています。
-
コンピューターの再起動: マシンを再起動して準備します。
「コンピューターを再起動」(/ja-jp/citrix-virtual-apps-desktops/2511/media/restart-computer.png)
-
VDAのインストール(初回試行): VDAのインストールを開始します。
-
コマンドラインオプションに
/quiet、/noreboot、および/noresumeオプションを追加します。 -
選択したVDAインストーラー(ローカルイメージまたは最小インストーラーのいずれか)を実行します。
「VDAのインストール(初回試行)」(/ja-jp/citrix-virtual-apps-desktops/2511/media/install-vda-first-attempt.png)
-
SCCMはリターンコードをキャプチャする必要があります。
-
リターンコードが0または8の場合、インストールは完了しており、再起動が必要です。
「SCCMがリターンコードをキャプチャ」(/ja-jp/citrix-virtual-apps-desktops/2511/media/sccm-return-code.png)
-
リターンコードが3の場合、マシンを再起動し、VDAのインストール(2回目試行)に制御を渡します。
「マシンの再起動」(/ja-jp/citrix-virtual-apps-desktops/2511/media/restart-machine.png)
-
-
-
VDAのインストール(2回目試行): VDAのインストールを続行します。
-
VDAのインストール(初回試行)の後、ファイル
%programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlが存在する場合、インストールは完了しておらず、再起動が完了した後に続行する必要があります。「VDAのインストール(2回目試行)」(/ja-jp/citrix-virtual-apps-desktops/2511/media/install-vda-second-attempt.png)
-
VDAのインストール(2回目試行)は、ファイル
%programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlが存在しなくなるか、0または8以外のリターンコードが返されるまで繰り返されます。その他のリターンコードはエラーとして扱い、INSTALL VDA SECOND ATTEMPTはエラーを報告して停止する必要があります。 -
コマンドラインパラメーターなしで、ファイル
%programdata%\ Citrix\XenDesktopSetup\ディレクトリから適切なVDAインストーラー(ほとんどの場合XenDesktopVdaSetup.exe、VDAWorkstationCoreSetup_XXXX.exeが使用された場合はXenDesktopRemotePCSetup.exe)を実行して、VDAのインストールを再開します。(VDAインストーラーは、インストーラーの初回実行時に保存したパラメーターを使用します。)
-
VDAインストーラーからのリターンコードを確認してください。
-
0または8:成功、インストール完了、再起動が必要です。

-
3:インストールは完了していません。マシンを再起動し、ファイル
%programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlが存在しなくなるか、0または8が返されるまで INSTALL VDA SECOND ATTEMPT を繰り返します。その他のリターンコードはエラーとして扱い、INSTALL VDA SECOND ATTEMPT はエラーを報告して終了する必要があります。
-
-
リターンコードの詳細については、Citrix インストールリターンコード を参照してください。
VDAインストールコマンドの例
利用可能なインストールオプションは、使用するインストーラーによって異なります。コマンドラインオプションの詳細については、以下の記事を参照してください。
Remote PC Access のインストールコマンド
-
次のコマンドは、シングルセッションコアVDAインストーラー (
VDAWorkstationCoreSetup.exe) を使用します。VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot -
次のコマンドは、シングルセッションフルVDAインストーラー (
VDAWorkstationSetup.exe) を使用します。VDAWorkstationSetup.exe /quiet /remotepc /physicalmachine /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot
専用VDIのインストールコマンド
-
次のコマンドは、シングルセッションの完全なVDAインストーラー (
VDAWorkstationSetup.exe) を使用します。VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot