コマンドラインを使用してVDAをインストールする

はじめに

コマンドラインからVDAをインストールする

1. VDAをインストールするマシンで、Citrix Cloudにサインインします。
2. 左上のメニューで、ソリューション > DaaSを選択します。
3. 右上にあるダウンロードをクリックし、VDAのダウンロードを選択します。VDAダウンロードページにリダイレクトされます。目的のVDAインストーラーを見つけて、ファイルのダウンロードをクリックします。
4. ダウンロードが完了したら、その名前を実行します。この記事で説明されているオプションを使用してください。
   • マルチセッションOS Virtual Delivery Agentの場合は、VDAServerSetup.exeを実行します。
   • シングルセッションOS Virtual Delivery Agentの場合は、VDAWorkstationSetup.exeを実行します。
   • シングルセッションOS Core Services Virtual Delivery Agentの場合は、VDAWorkstationCoreSetup.exeを実行します。

• VDAServerSetup_XXXX.exeの場合は、<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exeを実行します。
• VDAWorkstationCoreSetup_XXXX.exe の場合は、<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopRemotePCSetup.exe を実行します
• VDAWorkstationSetup_XXXX.exe の場合は、<extract folder>\Extract\Image-Full\x64\XenDesktop Setup\XenDesktopVDASetup.exe を実行します

VDA をインストールするためのコマンドラインオプション

• /コンポーネント コンポーネント\[,コンポーネント\]
  インストールまたは削除するコンポーネントのコンマ区切りリスト。有効な値は次のとおりです。
  • VDA: 仮想配信エージェント
  • プラグイン: Citrix Workspace™ app for Windows
  VDA と Citrix Workspace アプリをインストールするには、/components vda,plugins を指定します。
  plugins オプションを省略した場合、VDA のみがインストールされます (Citrix Workspace アプリはインストールされません)。
  このオプションは、VDAWorkstationCoreSetup.exe インストーラーを使用する場合は無効です。このインストーラーでは Citrix Workspace アプリをインストールできません。
• /controllers "コントローラー ..."
  VDA が通信できる Citrix Cloud Connector のスペース区切りの FQDN を、引用符で囲んで指定します。/site_guid と /controllers の両方のオプションを指定しないでください。
• /ディスエーブルエクスペリエンスメトリクス
  インストール、アップグレード、または削除中に収集された分析がCitrixに自動的にアップロードされるのを防ぎます。
• /enable_hdx_ports
  Windows ファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、VDAおよび有効な機能（Windows リモートアシスタンスを除く）に必要なポートをWindows ファイアウォールで開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、ネットワークポートを参照してください。
  HDXアダプティブトランスポートが使用するUDPポートを開くには、/enable_hdx_portsオプションに加えて、/enable_hdx_udp_portsオプションを指定します。
• /enable_hdx_udp_ports
  Windows ファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、HDXアダプティブトランスポートが必要とするUDPポートをWindows ファイアウォールで開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、ファイアウォールを手動で構成する必要があります。ポート情報については、ネットワークポートを参照してください。
  VDAが使用するポートを開くには、/enable_hdx_udp_portsオプションに加えて、/enable_hdx_portsオプションを指定します。
• /enable\_real\_time\_transport
  オーディオパケットにUDPを使用するかどうかを有効または無効にします（オーディオ用のリアルタイムオーディオトランスポート）。この機能を有効にすると、オーディオパフォーマンスが向上する可能性があります。Windows ファイアウォールサービスが検出されたときにUDPポートを自動的に開く場合は、/enable_hdx_portsオプションを含めます。
• /enable\_remote\_assistance
  Monitor機能で使用するために、Windows リモートアシスタンスのシャドウ機能を有効にします。このオプションを指定すると、Windows リモートアシスタンスはファイアウォールで動的ポートを開きます。
• /enablerestore または /enablerestorecleanup
  （シングルセッションVDAにのみ有効）VDAのインストールまたはアップグレードが失敗した場合に、復元ポイントへの自動復帰を有効にします。
  インストール/アップグレードが正常に完了した場合：
  • /enablerestorecleanupは、インストーラーに復元ポイントを削除するよう指示します。
  • /enablerestoreは、使用されなかった場合でも、インストーラーに復元ポイントを保持するよう指示します。
  詳細については、インストールまたはアップグレードの失敗時の復元を参照してください。
• /enable\_ss\_ports
  Windows ファイアウォールサービスが検出された場合、ファイアウォールが有効になっていなくても、画面共有に必要なポートをWindows ファイアウォールで開きます。別のファイアウォールを使用している場合、またはファイアウォールを使用していない場合は、手動でファイアウォールを構成する必要があります。
• /exclude "コンポーネント"\[,"コンポーネント"\]
  コンマで区切られた1つ以上のオプションコンポーネント（それぞれを引用符で囲む）のインストールを防止します。たとえば、MCS管理イメージにVDAをインストールまたはアップグレードする場合、マシンIDサービスコンポーネントが必要です。有効な値は次のとおりです。
  • マシンIDサービス
  • Citrix プロファイル管理
  • Citrix Profile Management WMIプラグイン
  • Citrix App-V向けパーソナライゼーション - VDA
  • Citrix MCS IOドライバー
  • Citrix VDA アップグレードエージェント
  • シトリックス ランデブー V2
  インストールからCitrix Profile Managementを除外すると (/exclude "Citrix Profile Management")、MonitorコンソールからのVDAの監視とトラブルシューティングに影響します。ユーザー詳細ページとエンドポイントページでは、パーソナライゼーションパネルとログオン期間パネルが機能しません。ダッシュボードページとトレンドページでは、平均ログオン期間パネルはProfile Managementがインストールされているマシンのみのデータを表示します。
  サードパーティ製のProfile Managementソリューションを使用している場合でも、CitrixはCitrix Profile Management Serviceをインストールして実行することをお勧めします。Citrix Profile Management Serviceを有効にする必要はありません。
  MCSを使用してVMをプロビジョニングする予定がある場合は、マシンIDサービスを除外しないでください。
  同じコンポーネント名で/excludeと/includeadditionalの両方を指定した場合、そのコンポーネントはインストールされません。
  このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用している場合は無効です。このインストーラーは、これらの項目の多くを自動的に除外します。
• /h または /help
  コマンドのヘルプを表示します。
• /includeadditional "コンポーネント"\[,"コンポーネント"\] ...
  1つまたは複数のコンマ区切りのオプションコンポーネントのインストールを含めます。各コンポーネントは、ストレート引用符で囲む必要があります。コンポーネント名は大文字と小文字を区別します。
  このオプションは、リモートPCアクセス展開を作成していて、デフォルトで含まれていないコンポーネントをインストールしたい場合に役立ちます。有効な値は次のとおりです。
  • Citrix プロファイル管理
  • Citrix プロファイル管理 WMI プラグイン
  • Citrix App-V 向けパーソナライゼーション - VDA
  • シトリックス MCS IOドライバー
  • Citrix VDA アップグレードエージェント
  • シトリックス ランデブー V2
  • ユーザーパーソナライゼーションレイヤー
  • Citrix WebSocket VDA 登録ツール
  同じコンポーネント名で/excludeと/includeadditionalの両方を指定した場合、そのコンポーネントはインストールされません。
• /installdir ディレクトリ
  コンポーネントがインストールされる既存の空のディレクトリ。デフォルト = c:\Program Files\Citrix。
• /install_mcsio_driver
  使用しないでください。代わりに/includeadditional "Citrix MCS IODriver"または/exclude "Citrix MCS IODriver"を使用してください。
• /logpath パス
  ログファイルの場所。指定されたフォルダーは存在している必要があります。インストーラーは作成しません。デフォルト = "%TEMP%\Citrix\XenDesktop Installer"
  このオプションはグラフィカルインターフェイスでは使用できません。
• /マスターイメージ
  VMにVDAをインストールする場合にのみ有効です。VDAをイメージとして設定します。このオプションは/mastermcsimageと同等です。
  このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用している場合は無効です。
• /マスターMCSイメージ
  このマシンがMachine Creation Servicesでイメージとして使用されることを指定します。このオプションは/masterimageと同等です。
• /マスターPVSイメージ
  このマシンがCitrix Provisioning™またはサードパーティのプロビジョニングツール（Microsoft System Center Configuration Managerなど）でイメージとして使用されることを指定します。
• /no_mediafoundation_ack
  Microsoft Media Foundationがインストールされておらず、いくつかのHDX™マルチメディア機能がインストールされておらず、動作しないことを認識します。このオプションを省略し、Media Foundationがインストールされていない場合、VDAのインストールは失敗します。ほとんどのサポートされているWindowsエディションには、Nエディションを除き、Media Foundationがすでにインストールされています。
• デスクトップエクスペリエンスなし
  マルチセッションOS VDAをインストールする場合にのみ有効です。拡張デスクトップエクスペリエンス機能の有効化を防止します。この機能は、拡張デスクトップエクスペリエンスCitrixポリシー設定でも制御されます。
• 再起動なし
  インストール後の再起動を防止します。VDAは再起動するまで使用できません。
• 再開しない
  デフォルトでは、インストール中にマシンの再起動が必要な場合、再起動が完了するとインストーラーは自動的に再開します。デフォルトを上書きするには、/noresumeを指定します。これは、メディアを再マウントする必要がある場合や、自動インストール中に情報を取得したい場合に役立ちます。
• ポート番号 port
  /reconfigオプションが指定されている場合にのみ有効です。VDAとController間の通信を有効にするポート番号。以前に構成されたポートは、ポート80でない限り無効になります。
• プロキシ設定 "address or PAC file path"
  コマンドに/includeadditional "Citrix Rendezvous V2"が含まれている場合にのみ有効です。Rendezvousプロトコルで使用するプロキシのアドレスまたはPACファイルのパス。機能の詳細については、Rendezvous protocolを参照してください。
  • プロキシアドレスの形式: http://<url-or-ip>:<port>
  • PACファイルの形式: http://<url-or-ip>:<port>/<path>/<filename>.pac
• サイレント または パッシブ
  インストール中にユーザーインターフェイスは表示されません。インストールと構成プロセスの唯一の証拠は、Windowsタスクマネージャーにあります。このオプションを省略すると、グラフィカルインターフェイスが起動します。
• /再構成
  /portnumber、/controllers、または/enable_hdx_portsオプションと組み合わせて使用すると、以前に構成されたVDA設定をカスタマイズします。このオプションを/quietオプションも指定せずに指定すると、VDAをカスタマイズするためのグラフィカルインターフェイスが起動します。
• /リモートPC
  リモートPCアクセス展開（シングルセッションOS）またはブローカー接続（マルチセッションOS）の場合にのみ有効です。
  このオプションは、VDAWorkstationCoreSetup.exeインストーラーを使用する場合は無効です。そのインストーラーは、これらのコンポーネントのインストールを自動的に除外します。
• /remove_appdisk_ack
  AppDisks™ VDAプラグインがインストールされている場合、VDAインストーラーがそれをアンインストールすることを承認します。
• /remove_pvd_ack
  Personal vDiskがインストールされている場合、VDAインストーラーがそれをアンインストールすることを承認します。
• /削除
  /componentsオプションで指定されたコンポーネントを削除します。
• /すべて削除
  VDAを削除します。Citrix Workspaceアプリ（インストールされている場合）は削除しません。
• /エクスペリエンスメトリックを送信
  インストール、アップグレード、または削除中に収集された分析データをCitrixに自動的に送信します。このオプションが省略された場合（または/disableexperiencemetricsオプションが指定された場合）、分析データはローカルで収集されますが、自動的には送信されません。
• サーバーVDI
  サポートされているWindowsサーバーにシングルセッションOS VDAをインストールします。WindowsサーバーにマルチセッションVDAをインストールする場合は、このオプションを省略してください。このオプションを使用する前に、Server VDIを参照してください。
• サイトGUID guid
  サイトのActive Directory組織単位（OU）のグローバル一意識別子。これは、検出にActive Directoryを使用している場合に、仮想デスクトップをサイトに関連付けます（自動更新が推奨されるデフォルトの検出方法です）。サイトGUIDは、Studioに表示されるサイトプロパティです。/site_guidと/controllersの両方のオプションを指定しないでください。
• 一時ディレクトリ directory
  インストール中に一時ファイルを保持するディレクトリ。デフォルト = c:\Windows\Temp。
  このオプションはグラフィカルインターフェイスでは利用できません。
• 仮想マシン
  VDAをVMにインストールする場合にのみ有効です。BIOS情報がVMに渡されることで物理マシンとして表示される、インストーラーによる物理マシンの検出を上書きします。
  このオプションはグラフィカルインターフェイスでは利用できません。
• XenDesktopクラウド
  VDAがCitrix DaaS (Citrix Cloud™) 展開にインストールされていることを示します。

例: VDAのインストール

• マルチセッションOSにVDAをインストールする。 次のコマンドは、マルチセッションOSにVDAをインストールします。
  VDAServerSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /masterimage
  VDAはイメージとして使用されます。
• マルチセッションOS VDAまたはシングルセッションOS VDAをインストールします。 次のコマンドは、マルチセッションOS VDAまたはシングルセッションOS VDAをインストールします。
  VDAServerSetup_XXXX.exe /quiet /controllers "ddc1.abc.com","ddc2.abc.com" /enable_hdx_ports /enable_Remote_Assistance /enable_real_time_transport /enable_ss_ports /noreboot
  各デリバリーコントローラー™のFQDNをコンマで区切ります。XXXXはVDAのバージョンを表します。
• シングルセッションOSにコアサービスVDAをインストールします。 次のコマンドは、リモートPCアクセスまたはVDA展開で使用するために、シングルセッションOSにコアサービスVDAをインストールします。
  VDAWorkstationCoreSetup.exe /quiet /controllers "Contr-East.domain.com" /enable_hdx_ports /noreboot
  Citrix Workspaceアプリおよびその他の非コアサービスはインストールされません。Cloud Connectorのアドレスが指定され、Windowsファイアウォールサービス内のポートが自動的に開かれます。再起動は管理者が処理します。

コマンドラインを使用してVDAをカスタマイズする

• /reconfigure (VDAをカスタマイズする際に必須)
• /h または /help
• /quiet
• /noreboot
• /controllers
• /portnumber port
• /enable_hdx_ports

次のステップ

• マシンカタログの作成
• 構成プロセス全体を確認するには、展開の計画と構築を参照してください。