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

最終公開日 : Nov 13, 2026
注:
Citrixは、顧客の運用環境に合わせて調整されたMicrosoft System Center Configuration Manager (SCCM)などのソフトウェア配布ツールを使用してVirtual Delivery Agent (VDA)を展開することによって発生する問題について責任を負いません。インストール関連のCitrixの問題については、Citrixサポートポータルを使用して関連するインストールログを添えてテクニカルサポートケースをオープンしてください。

概要

Microsoft System Center Configuration Manager (SCCM)または類似のソフトウェア配布ツールを使用してVirtual Delivery Agent (VDA)を正常に展開するには、Citrix®はVDAインストーラーを段階的に使用することを推奨します。
Citrix は、VDA のインストールまたはアップグレードの一部として VDA Cleanup Utility を使用することを推奨しません。VDA インストーラーが以前に失敗した場合にのみ、VDA Cleanup Utility を使用してください。

再起動

VDA のインストール中に必要な再起動の回数は、環境によって異なります。例:
  • 保留中の更新や以前のソフトウェアインストールからの再起動のために、再起動が必要になる場合があります。
  • 他のプロセスによって以前にロックされていたファイルは更新が必要になる場合があり、追加の再起動を強制します。
  • VDA インストーラーの一部のオプションコンポーネント (Citrix Profile Management や Citrix Files など) は、再起動が必要になる場合があります。
SCCMタスクシーケンサーは、必要なすべての再起動を管理します。

タスクシーケンスを定義する

すべての前提条件と再起動を特定したら、SCCMタスクシーケンサーを使用して以下を完了します。
  • VDAは、インストールメディアのアクセス可能なコピーから、またはVDAスタンドアロンインストーラーのいずれかからインストールできます。
    • VDAWorkstationSetup_XXXX.exe
    • VDAServerSetup_XXXX.exe
    • VDAWorkstationCoreSetup_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はインストールを監視して終了コードをキャプチャできないためです。

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

次の例は、インストールシーケンスを示しています。
  1. SCCM TASK1: マシンを再起動して準備します。
  2. SCCM TASK2: VDAのインストールを開始します。
    1. コマンドラインオプションに/quiet、/noreboot、および/noresumeオプションを追加します。
    2. 選択した VDA インストーラー (ローカルイメージまたは最小インストーラーのいずれか) を実行します。
    3. SCCM はリターンコードをキャプチャする必要があります。
      • リターンコードが 0 または 8 の場合、インストールは完了しており、再起動が必要です。
      • 戻りコードが3の場合、マシンを再起動し、SCCM TASK3に制御を渡します。
  3. SCCM TASK3: VDAのインストールを続行します。
    1. SCCM TASK2が0または8を返さない場合、再起動が完了した後にインストールを続行する必要があります。
    2. VDAインストーラーが0または8(インストールが成功したことを示す)または3(SCCM TASK3を繰り返す必要があることを示す)を返すまで、SCCM TASK3は繰り返されます。その他の戻りコードはエラーとして扱い、SCCM TASK3はエラーを報告して停止する必要があります。
    3. コマンドラインパラメーターなしで、コピーされた場所(タスクシーケンスの定義で説明)から適切なVDAインストーラー(ほとんどの場合XenDesktopVdaSetup.exe、VDAWorkstationCoreSetup_XXXX.exeが使用された場合はXenDesktopRemotePCSetup.exe)を実行して、VDAのインストールを再開します。(VDAインストーラーは、インストーラーの初回実行時に保存したパラメーターを使用します。)
    4. VDAインストーラーからのリターンコードを確認します。
      • 0または8:成功、インストール完了、再起動が必要です。
      • 3: インストールが完了していません。マシンを再起動し、0または8が返されるまでSCCM TASK3を繰り返します。その他の戻りコードはエラーとして扱い、SCCM TASK3はエラーを報告して終了する必要があります。
リターンコードの詳細については、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 /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