Citrix Virtual Apps and Desktops

SCCMを使用したVDAのインストール

February 17, 2025

寄稿者:

概要

Microsoft Endpoint Configuration Manager（旧称System Center Configuration Manager（SCCM））は、企業全体のデバイスとアプリケーションの管理、展開、セキュリティを可能にするWindows製品です。

メモ:

以下の記事では、Citrixが環境をテストした方法に基づいた推奨事項のみについて説明します。これらの手順は、必要に応じてカスタマイズできます。 Citrixは、お客様がニーズに合わせて追加された更新や調整については責任を負いません。

推奨事項

SCCMまたは同様のソフトウェア配信ツールを使用してVirtual Delivery Agent（VDA）を正常に展開するには、VDAインストーラーを手順どおりに使用することをCitrixではお勧めします。
VDAのインストールまたはアップグレードの一部としてVDA Cleanup Utilityを使用することはお勧めしません。 VDA Cleanup Utilityは、以前にVDAインストーラーで失敗した場合にのみ使用してください。

はじめに

VDAのインストール中に必要な再起動回数は、環境によって異なります。例:

以前のソフトウェアインストールからの更新や再起動が保留になっている場合は、再起動が必要になることがあります。
以前に別のプロセスによってロックされていたファイルは、更新が必要になり追加で再起動が必要になる場合があります。
VDAインストーラーの一部のオプションコンポーネント（Citrix Profile Management、Citrix Filesなど）は、再起動が必要な場合があります。
VDAをアップグレードする場合、VDAがインストールされているマシンは、セッションがなく、メンテナンスモードである必要があります。
マシン上でVDAインストールを初めて実行すると、使用されているVDAインストーラーがそのマシン上にコピーされます。 VDAのインストールについて詳しくは、「インストーラー」を参照してください。

SCCMのタスクシーケンサーにより、必要なすべての再起動が管理されます。

SCCMを使用してVDAを展開するための主な手順

次の手順では、仮想マシン上でSCCMを使用してVDAを展開する方法について説明します。

手順1：VDAのインストール

すべての前提条件を確認したら、SCCMのタスクシーケンサーを使用して次の作業を完了します：

インストールメディアのアクセス可能なコピーから、またはVDAスタンドアロンインストーラーの1つからインストールします：
- VDAWorkstationSetup_XXXX.exe
- VDAServerSetup_XXXX.exe
- VDAWorkstationCoreSetup_XXXX.exe
VDAインストーラーについて詳しくは、「インストーラー」を参照してください。

メモ:

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
Microsoft Configuration Managerで、「\Administration\Overview\Hierarchy Configuration\Discovery Methods\」に移動します。
［Active Directory System Discovery］をクリックし、［Enable Active Directory System Discovery］チェックボックスを選択して、新しく作成された仮想マシンの自動検出を有効にします。
アイコンをクリックして新しいコンテナを選択します。
［Location］セクションで、SCCM仮想マシンが格納されている場所へのパスを追加します。
\Administration\Overview\Site Configuration\Sitesに移動して、SCCM VDAを右クリックします。
［Client Installation Settings］>［Client Push Installation］ を選択します。 ［クライアントプッシュインストールのプロパティ］ウィンドウが開きます。
仮想マシンをEnabledに設定すると、次の図に示すように仮想マシンの一覧が表示されます。
OUを作成するには、デバイスコレクションを作成します。コレクション名の名前を入力します。
ウィザードの手順に従います。

OUが作成されます。
作成した仮想マシンを新しく作成したデバイスコレクションに追加します。
1. 仮想マシンを右クリックします。 ［Add Selected Items］>［Add Selected Items to Existing Device Collection］を選択します。
2. ［コレクションの選択］ウィンドウで、必要なデバイス名を選択します。この例では、Devices-SCCMです。
Devices-SCCMは［Assets and Compliance］>［Overview］>［Device Collections］に表示されます。
デバイスコレクションで［クライアントのインストール］を選択します。
必要なインストールサイトを選択します。
ウィザードの手順に従います。 Configuration Managerクライアントのインストールウィザードが正常に完了しました。

詳細については、Microsoftドキュメントの「コレクションの管理」を参照してください。

手順3：マシンの検証

クライアントマシンで、CCMExecプロセスが実行されているかどうかを確認して、クライアントがインストールされていることを確認します。
SCCM上の仮想マシンに対してクライアントが実行されているかどうかを確認します。

手順4：VDAを使用したコンテンツの配布

次の手順では、展開されたVDAを使用して、関連付けられた仮想マシンにコンテンツを配布する方法について説明します。

パッケージを作成する
コンテンツを配布する

パッケージを作成する

パッケージを作成するには、必要なVDAを右クリックし、［パッケージの作成］をクリックします。
［参照］をクリックして、このパッケージのソースファイルの場所を指定します。
必要なパッケージタイプを選択します。
パッケージの名前とコマンドラインを入力します。
［次へ］ をクリックします。

詳細については、Microsoftドキュメントの「Configuration Managerのパッケージとプログラム」を参照してください。

コンテンツを配布する

作成したパッケージ名を右クリックします。
［コンテンツを配布］を選択します。
コンテンツの配布ウィザードウィンドウで、作成したパッケージのソースファイルの場所を選択します。この例では2019-SCCMです。 ［次へ］ をクリックします。
パッケージ（この例ではZodiac）が利用可能であることを確認します。

次の画像は、パッケージを展開できることを示しています。

詳細については、Microsoftドキュメントの「Configuration Managerのコンテンツを展開および管理する」を参照してください。

SCCMを使用したインストールシーケンスの例

以下は、インストールシーケンスの例です。

Restart Computer：マシンを再起動することでマシンを準備します。
Install VDA First Attempt：VDAのインストールを開始します。
1. /quiet、/noreboot、/noresumeオプションをコマンドラインオプションに追加します。
2. 任意のVDAインストーラー（ローカルイメージ、または最小限のインストーラーの1つ）を実行します。
3. SCCMがリターンコードをキャプチャする必要があります。
  - リターンコードが0または8の場合、インストールは完了しており、再起動が必要です。
  - リターンコードが3の場合は、マシンを再起動してから、［Install VDA Second Attempt］に制御を渡します。
Install VDA Second Attempt：VDAのインストールを続行します。
1. ［Install VDA First Attempt］後、%programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlファイルが存在する場合、インストールは完了していないため、再起動の完了後に続行される必要があります。
2. %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlファイルが存在しなくなるか、0または8以外のリターンコードが返されるまで、［Install VDA Second Attempt］が繰り返されます。その他のリターンコードはエラーとして扱われ、INSTALL VDA SECOND ATTEMPTは、エラーを報告して停止します。
3. 適切なVDAインストーラー（ほとんどの場合は、XenDesktopVdaSetup.exe、またはVDAWorkstationCoreSetup_XXXX.exeが使用されている場合はXenDesktopRemotePCSetup.exeを）、ファイル「%programdata%\ Citrix\XenDesktopSetup\」ディレクトリから、コマンドラインパラメーターなしで実行することでVDAのインストールを再開します。（VDAインストーラーは、その初回実行時に保存されたパラメーターを使用します。）
4. VDAインストーラーからのリターンコードを確認します。
  - 0または8：成功し、インストールが完了し、再起動が必要です。
  - 3：インストールが完了していません。ファイル%programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xmlが存在しなくなるか、0または8のリターンコードが返されるまで、マシンを再起動してINSTALL VDA SECOND ATTEMPTが繰り返されます。その他のリターンコードはエラーとして扱われ、INSTALL VDA SECOND ATTEMPTは、エラーを報告して終了します。

リターンコードについて詳しくは、「Citrixインストールリターンコード」を参照してください。

VDAインストールコマンドの例

使用可能なインストールオプションは、使用するインストーラーによって異なります。コマンドラインオプションの詳細については、次の記事を参照してください。

リモートPCアクセス用のインストールコマンド

次のコマンドでは、シングルセッションコア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

このコンテンツの正式なバージョンは英語で提供されています。Cloud Software Groupドキュメントのコンテンツの一部は、お客様の利便性のみを目的として機械翻訳されています。Cloud Software Groupは機械翻訳されたコンテンツを管理していないため、誤り、不正確な情報、不適切な用語が含まれる場合があります。英語の原文から他言語への翻訳について、精度、信頼性、適合性、正確性、またはお使いのCloud Software Group製品またはサービスと機械翻訳されたコンテンツとの整合性に関する保証、該当するライセンス契約書またはサービス利用規約、あるいはCloud Software Groupとのその他すべての契約に基づき提供される保証、および製品またはサービスのドキュメントとの一致に関する保証は、明示的か黙示的かを問わず、かかるドキュメントの機械翻訳された範囲には適用されないものとします。機械翻訳されたコンテンツの使用に起因する損害または問題について、Cloud Software Groupは責任を負わないものとします。

この情報は役に立ちましたか?

SCCMを使用したVDAのインストール

February 17, 2025

寄稿者:

この記事の概要

この情報は役に立ちましたか?