スクリプトを使用してVDAをインストールする

最終公開日 : Nov 13, 2026
注:
Citrixは、お客様の運用環境に合わせて変更されたスクリプトによって引き起こされる問題について責任を負いません。インストール関連のCitrixの問題については、Citrixサポートポータルを使用して、関連するインストールログとともにテクニカルサポートケースをオープンしてください。
この記事は、Windowsオペレーティングシステムを搭載したマシンへのVDAのインストールに適用されます。Linuxオペレーティングシステム用VDAの詳細については、Linux Virtual Delivery Agentのドキュメントを参照してください。
インストールメディアには、Active Directory内のマシンにVirtual Delivery Agent（VDA）をインストール、アップグレード、または削除するサンプルスクリプトが含まれています。これらのスクリプトは、Machine Creation Services™およびCitrix Provisioning（旧Provisioning Services）で使用されるマスターイメージの保守にも使用できます。
必要なアクセス権:
  • スクリプトには、VDAインストールコマンドが配置されているネットワーク共有へのEveryone読み取りアクセス権が必要です。インストールコマンドは、完全な製品ISOではXenDesktopVdaSetup.exe、スタンドアロンインストーラーではVDAWorkstationSetup.exeまたはVDAServerSetup.exeです。
  • ログの詳細は各ローカルマシンに保存されます。レビューと分析のために結果を一元的にログに記録するには、スクリプトに適切なネットワーク共有へのEveryone読み取りおよび書き込みアクセス権が必要です。
スクリプトの実行結果を確認するには、中央ログ共有を調べます。キャプチャされたログには、スクリプトログ、インストーラーログ、およびMSIインストールログが含まれます。各インストールまたは削除の試行は、タイムスタンプ付きのフォルダーに記録されます。フォルダーのタイトルは、PASSまたはFAILのプレフィックスで操作結果を示します。標準のディレクトリ検索ツールを使用して、中央ログ共有で失敗したインストールまたは削除を見つけることができます。これらのツールは、ターゲットマシンでローカルに検索する代替手段を提供します。
インストールを開始する前に、インストールの準備のタスクを読み、完了してください。
Related information
VDAをインストールする

スクリプトを使用してVDAをインストールまたはアップグレードする

  1. インストールメディアの\\Support\\AdDeploy\\からサンプルスクリプトInstallVDA.batを入手します。Citrixは、スクリプトをカスタマイズする前に元のスクリプトのバックアップを作成することをお勧めします。
  2. スクリプトを編集します。
    • インストールするVDAのバージョンを指定します: SET DESIREDVERSION。完全な値は、インストールメディアのProductVersion.txtファイルで確認できます。ただし、完全な一致は必須ではありません。
    • インストーラーが呼び出されるネットワーク共有を指定します。レイアウトのルート（ツリーの最上位）を指します。スクリプトの実行時に、インストーラーの適切なバージョン（32ビットまたは64ビット）が自動的に呼び出されます。例: SET DEPLOYSHARE=\\fileserver1\share1。
    • 任意で、一元化されたログを保存するためのネットワーク共有の場所を指定します。例: SET LOGSHARE=\\fileserver1\log1)。
    • コマンドラインを使用したインストールで説明されているように、VDA構成オプションを指定します。/quietおよび/norebootオプションは、スクリプトにデフォルトで含まれており、必須です: SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT /NORESUME。
  3. グループポリシーのスタートアップスクリプトを使用して、マシンを含むOUにスクリプトを割り当てます。このOUには、VDAをインストールするマシンのみを含める必要があります。そのOU内のマシンが再起動されると、スクリプトはすべてのマシンで実行されます。サポートされているオペレーティングシステムを持つ各マシンにVDAがインストールされます。

スクリプトを使用してVDAを削除する

  1. インストールメディアの\\Support\\AdDeploy\\からサンプルスクリプトUninstallVDA.batを取得します。Citrixでは、元のスクリプトをカスタマイズする前にバックアップを作成することをお勧めします。
  2. スクリプトを編集します。
    • 削除するVDAのバージョンを指定します: SET CHECK\_VDA\_VERSION。完全な値は、インストールメディアのProductVersion.txtファイル（例: 7.0.0.3018）にあります。ただし、完全一致は必須ではありません。
    • 任意で、一元化されたログを保存するためのネットワーク共有の場所を指定します。
  3. グループポリシーのスタートアップスクリプトを使用して、マシンを含むOUにスクリプトを割り当てます。このOUには、VDAを削除するマシンのみを含める必要があります。OU内のマシンが再起動されると、スクリプトはすべてのマシンで実行されます。各マシンからVDAが削除されます。

トラブルシューティング

  • スクリプトは、スクリプトの実行状況を記述する内部ログファイルを生成します。スクリプトは、展開の開始から数秒以内にKickoff_VDA_Startup_Scriptログを中央ログ共有にコピーします。全体的なプロセスが機能していることを確認できます。このログが期待どおりに中央ログ共有にコピーされない場合は、ローカルマシンを検査してさらにトラブルシューティングを行ってください。スクリプトは、各マシンの%temp%フォルダーに2つのデバッグログファイルを配置します:
    • Kickoff_VDA_Startup_Script_<DateTimeStamp>.log
    • VDA_Install_ProcessLog_<DateTimeStamp>.log
    スクリプトが次の状態であることを確認するために、これらのログを確認します。
    • 期待どおりに実行されている。
    • ターゲットオペレーティングシステムを適切に検出する。
    • DEPLOYSHARE共有のROOTを指すように正しく構成されていること（AutoSelect.exeという名前のファイルが含まれています）。
    • DEPLOYSHAREとLOGの両方の共有に対して認証できること。
  • コンポーネントのインストール結果がCitrixによってどのように報告されるかについては、「Citrixインストールリターンコード」(/ja-jp/citrix-virtual-apps-desktops/2407/install-configure/install-prepare.html#citrix-installation-return-codes)を参照してください。
  • デリバリーグループのStudio表示では、詳細ペインのインストール済みVDAバージョンエントリが、マシンにインストールされているバージョンと異なる場合があります。マシンのプログラムと機能の表示には、実際のVDAバージョンが表示されます。
  • VDAがインストールされても、Delivery Controllerに登録されるまでは、ユーザーにアプリやデスクトップを配信できません。
    VDA登録方法と登録問題のトラブルシューティングについては、「VDA登録」(/ja-jp/citrix-virtual-apps-desktops/2407/manage-deployment/vda-registration.html)を参照してください。