SCCM を使用して VDA をインストールする

最終公開日 : Nov 13, 2026
Related information
../../../install-configure/install-vdas/third-party-vda-deployment-methods.md

概要

Microsoft Endpoint Configuration Manager (旧称 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 タスクシーケンサーは、必要なすべての再起動を管理します。

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

以下の手順では、仮想マシン上で SCCM を使用して VDA を展開する方法について説明します。
  1. VDA をインストールする。
  2. 組織単位 (OU) を作成する。
  3. マシンを検証する。
  4. VDA を使用してコンテンツを配布する。

ステップ 1: VDA をインストールする

すべての前提条件を特定した後、「SCCM タスクシーケンサー」を使用して以下のタスクを完了します。
  1. インストールメディアのアクセス可能なコピーから、またはVDAスタンドアロンインストーラーのいずれかからVDAをインストールします。
    • VDAWorkstationSetup_XXXX.exe
    • VDAServerSetup_XXXX.exe
    • VDAWorkstationCoreSetup_XXXX.exe
    VDA インストーラーの詳細については、インストーラーを参照してください。
    注:
    VDAをアップグレードする場合、VDAがインストールされているマシンは、セッションがないメンテナンスモードである必要があります。
  2. マシンでVDAのインストールが初めて実行されると、使用されているVDAインストーラーがそのマシンにコピーされます。
    • VDAWorkstationCoreSetup_XXXX.exe以外のVDAインストーラーを使用すると、VDAインストーラーは%ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exeにコピーされます。
    • VDAWorkstationCoreSetup_XXXX.exeを使用すると、VDAインストーラーは%ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe.にコピーされます。
  3. VDAインストーラーのディレクトリの場所は、レジストリHKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation”にも保存されます。
  4. コマンドラインオプションに/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) を作成する

  1. OU に追加するドメイン参加済み仮想マシンを 2 台作成します。仮想マシンが最初に作成されると、Computers フォルダーにあります。仮想マシンを SCCM フォルダーに移動します。 例: WIN10EN-BB80MJ4.cseblr.com W2K19ST-EBPR3UG.cseblr.com
    SCCM VDA
  2. Microsoft Configuration Manager で、\Administration\Overview\Hierarchy Configuration\Discovery Methods\ に移動します。
  3. Active Directory System Discoveryをクリックし、Enable Active Directory System Discoveryチェックボックスをオンにして、新しく作成された仮想マシンの自動検出を有効にします。
  4. icon アイコンをクリックして、新しいコンテナーを選択します。
  5. 「場所」セクションで、SCCM仮想マシンが配置されているパスを追加します。
  6. \Administration\Overview\Site Configuration\Sites に移動し、SCCM VDA を右クリックします。
  7. クライアントインストール設定 > クライアントプッシュインストールを選択します。「クライアントプッシュインストールのプロパティ」ウィンドウが開きます。
  8. VM が Enabled に設定されると、次の図に示すように VM のリストが表示されます。
    SCCMSCCM-2
  9. OU を作成するためにデバイスコレクションを作成します。コレクション名の名前を入力します。
    デバイスコレクション
  10. ウィザードの指示に従います。
    メンバーシップルール(/en-us/citrix-virtual-apps-desktops/2411/media/sccm-membership-rules.png)
    OU が作成されました。
    OUの作成(/en-us/citrix-virtual-apps-desktops/2411/media/sccm-create-device-collection-wizard.png)
  11. 作成した VM を新しく作成したデバイスコレクションに追加します。
    1. VM を右クリックします。選択したアイテムの追加 > 選択したアイテムを既存のデバイスコレクションに追加を選択します。
      項目の追加(/en-us/citrix-virtual-apps-desktops/2411/media/sccm-add-item-to-device-collection.png)
    2. 「コレクションの選択」ウィンドウで、必要なデバイス名を選択します。この例では、Devices-SCCMです。
      デバイスリスト(/en-us/citrix-virtual-apps-desktops/2411/media/sccm-list.png)
    Devices-SCCMは、「資産とコンプライアンス > 概要 > デバイスコレクション」に表示されます。
    デバイスがリストされました(/en-us/citrix-virtual-apps-desktops/2411/media/devices-sccm.png)
  12. デバイスコレクターで「クライアントのインストール」を選択します。
    クライアントのインストール(/en-us/citrix-virtual-apps-desktops/2411/media/sccm-install-client.png)
  13. 必要なインストール「サイト」を選択します。
    サイトのインストール(/en-us/citrix-virtual-apps-desktops/2411/media/sccm-install-client-1.png)
  14. ウィザードの指示に従います。Install Configuration Manager Client Wizard が正常に完了しました。
    インストール完了
詳細については、Microsoft ドキュメントの コレクションの管理 を参照してください。

ステップ 3: マシンの検証

  1. クライアントマシンで、CCMExecプロセスが実行されていることを確認して、クライアントがインストールされていることを検証します。
    CCMexe.exe
  2. SCCM 上の VM でクライアントが実行されていることを確認します。

ステップ 4: VDA を使用してコンテンツを配布する

以下の手順では、展開されたVDAを使用して、関連する仮想マシンにコンテンツを配布する方法について説明します。
  1. パッケージの作成
  2. コンテンツの配布

パッケージの作成

  1. パッケージを作成するには、目的の VDA を右クリックし、 をクリックします。
    パッケージの作成
  2. をクリックして、このパッケージのソースファイルの場所を指定します。
    パッケージの参照
  3. 必要なパッケージの種類を選択します。
    パッケージとプログラムの作成ウィザード
  4. パッケージの名前とコマンドラインを入力します。
    パッケージの詳細を指定
  5. Nextをクリックします。
    パッケージの成功
詳細については、Microsoft ドキュメントの「Configuration Manager のパッケージとプログラム」を参照してください。

コンテンツの配布

  1. 作成したパッケージ名を右クリックします。
  2. を選択します。
    コンテンツの配布
  3. ウィンドウで、作成したパッケージのソースファイルの場所を選択します。この例では、2019-SCCM です。 をクリックします。
    場所を指定
  4. パッケージ (この例では Zodiac) が展開可能であることを確認します。
    検証
    以下の画像は、パッケージが展開可能であることを示しています。
    展開するパッケージ
詳細については、Microsoft ドキュメントの「Configuration Manager のコンテンツの展開と管理」を参照してください。

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

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