SCCM を使用して VDA をインストールする
概要
マイクロソフト エンドポイント コンフィグレーション マネージャー (旧称 システム センター コンフィグレーション マネージャー (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 を展開する方法について説明します。
ステップ 1: VDA をインストールする
すべての前提条件を特定した後、SCCM Task Sequencer を使用して次のタスクを完了します。
-
インストールメディアのアクセス可能なコピーから、または VDA スタンドアロンインストーラーのいずれかから VDA をインストールします。
VDAWorkstationSetup_XXXX.exeVDAServerSetup_XXXX.exeVDAWorkstationCoreSetup_XXXX.exe
VDA インストーラーの詳細については、「インストーラー」を参照してください。
注:
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
エスシーシーエム ブイディーエー(/ja-jp/citrix-virtual-apps-desktops/2411/media/sccm-vda.png)
-
マイクロソフト コンフィグレーション マネージャーで、
\Administration\Overview\Hierarchy Configuration\Discovery Methods\に移動します。 -
Active Directory System Discoveryをクリックし、Enable Active Directory System Discoveryチェックボックスを選択して、新しく作成された仮想マシンの自動検出を有効にします。
-
新しいコンテナーを選択するには、
アイコンをクリックします。 -
「Location」セクションで、SCCM仮想マシンが配置されている「Path」を追加します。
-
\Administration\Overview\Site Configuration\Sitesに移動し、SCCM VDAを右クリックします。 -
「クライアントインストール設定 > クライアントプッシュインストール」を選択します。「クライアントプッシュインストールプロパティ」ウィンドウが開きます。
-
VMが
Enabledに設定されると、次の図に示すようにVMのリストが表示されます。

-
OUを作成するために「Device collection」を作成します。コレクション名の「Name」を入力します。

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

OUが作成されます。

-
作成されたVMを新しく作成されたデバイスコレクションに追加します。
-
Right-click the VM. Select Add Selected Items > Add Selected Items to Existing Device Collection.

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

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

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

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

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

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

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

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

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

-
コンテンツの配布ウィザードウィンドウで、作成したパッケージのソースファイルの場所を選択します。この例では、
2019-SCCMです。次へをクリックします。
-
パッケージ (この例では、
Zodiac) が展開可能であることを確認します。(/ja-jp/citrix-virtual-apps-desktops/2411/media/sccm-distribute-content-window-successful.png)
次の画像は、パッケージが展開可能であることを示しています。

詳細については、MicrosoftドキュメントのConfiguration Manager のコンテンツの展開と管理 を参照してください。
SCCM を使用したインストールシーケンスの例
次の例は、インストールシーケンスを示しています。
-
コンピューターの再起動: マシンを再起動して準備します。

-
VDAのインストール(初回試行): VDAのインストールを開始します。
-
/quiet、/noreboot、および/noresumeオプションをコマンドラインオプションに追加します。 -
選択したVDAインストーラー(ローカルイメージまたは最小インストーラーのいずれか)を実行します。

-
SCCMはリターンコードをキャプチャする必要があります。
-
リターンコードが0または8の場合、インストールは完了しており、再起動が必要です。

-
リターンコードが3の場合、マシンを再起動し、VDAのインストール(2回目試行)に制御を渡します。

-
-
-
VDAのインストール(2回目試行): VDAのインストールを続行します。
-
VDAのインストール(初回試行)の後、ファイル
%programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlが存在する場合、インストールは完了しておらず、再起動が完了した後に続行する必要があります。
-
VDAのインストール(2回目試行)は、ファイル
%programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlが存在しなくなるか、0または8以外のリターンコードが返されるまで繰り返されます。その他のリターンコードはエラーとして扱い、VDAのインストール(2回目試行)はエラーを報告して停止する必要があります。 -
適切なVDAインストーラー(ほとんどの場合
XenDesktopVdaSetup.exe、またはVDAWorkstationCoreSetup_XXXX.exeが使用された場合はXenDesktopRemotePCSetup.exe)を、ファイル%programdata%\ Citrix\XenDesktopSetup\ディレクトリから、コマンドラインパラメーターなしで実行して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