レジストリで管理される HDX™ 機能
注:
レジストリを誤って編集すると、オペレーティングシステムの再インストールが必要になるような深刻な問題が発生する可能性があります。Citrix® は、レジストリエディターの誤った使用によって生じる問題が解決されることを保証できません。レジストリエディターの使用は、お客様ご自身の責任において行ってください。編集する前に、必ずレジストリをバックアップしてください。
レジストリエディターを開くには、サーバーで
regedit.exe を実行します。次に、設定を追加または編集するためにレジストリキーに移動します。
デバイス
Bloomberg キーボード
Citrix Virtual Apps and Desktops™ は、Bloomberg モデル 4 およびモデル 3 のスターボードキーボードをサポートしています。デフォルトでは、拡張 Bloomberg キーボードのサポートは無効になっています。
Bloomberg キーボードのサポートを有効にするには、接続を開始する前に、クライアントマシンで以下のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICAClient\GenericUSB -
値の名前:
EnableBloombergHID -
値の型:
DWORD -
値のデータ:
-
0- 無効 -
1- 有効
-
詳細については、Bloomberg キーボード を参照してください。
マップされたクライアントドライブ
セキュリティ上の予防措置として、ユーザーがCitrix Virtual Apps and Desktopsにログオンすると、デフォルトでサーバーはユーザーの実行権限なしでクライアントドライブをマップします。マップされたクライアントドライブにある実行可能ファイルをユーザーが実行できるようにするには、サーバー上のレジストリを編集してこのデフォルト設定を上書きします。
アクセスを許可するには、以下のレジストリ値を編集します（CDMSettingsが存在しない場合は作成します）。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Citrix\CDMSettings -
値の名前:
ExecuteFromMappedDrive -
値の型:
DWORD -
値のデータ:
-
1- 権限を許可 -
0- マップされたドライブでの権限を拒否
-
この変更は、レジストリを編集した後に接続されたセッションに適用されます。
Citrix Virtual Apps and Desktops 7 2006は、このレジストリの場所を含む最初のバージョンです。以前のバージョンのCitrix Virtual Apps and Desktopsでは、異なるレジストリの場所が使用されていました。
詳しくは、「クライアントドライブマッピング」を参照してください。
マイクロソフト サーフェス プロ および サーフェス ブック のペン
Citrix Virtual Apps and Desktopsは、Windows Inkベースのアプリケーションで標準のペン機能をサポートしています。デフォルトでは、この機能は有効になっています。
この機能を無効または有効にするには、以下のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Citrix Virtual Desktop Agent\PenApi -
値の名前:
DisablePen -
値の型:
DWORD -
値のデータ:
-
1- 無効にする -
0- 有効にする
-
詳しくは、Microsoft Surface Pro and Surface Book pensを参照してください。
Windows Image Acquisitionアプリケーション許可リスト
この設定により、VDA上のどのアプリケーションがWindows Image Acquisitionスキャナーリダイレクトにアクセスできるかを制御できます。
デフォルトでは、どのアプリケーションもWindows Image Acquisitionにアクセスできません。
VDA上のアプリケーションのWindows Image Acquisitionを調整するには、次のレジストリ設定を作成します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix -
値の名前:
WIAAllowedProcessesWIAAllowedProcessesを選択して右クリックします。「新規 > 複数行文字列値」を選択し、新しい値を「AllowProcesses」に名前変更します。 -
値のデータ: Windows Image Acquisitionにアクセスできる各アプリケーションの完全なパスとプロセス名を入力します。各アプリケーションは新しい行に入力してください。
この設定への変更は、次回 VDA でセッションを起動したときに有効になります。
全般
HDX リデューサー
セッションホストで使用するHDX圧縮アルゴリズム（Reducer）のバージョンを構成できます。
シングルセッションVDAでReducer V4を有効にするには、次のレジストリ値を設定します。
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\GroupPolicy\Defaults\WDSettings 値の名前: ReducerOverrideMask 値の型: DWORD 値のデータ: 23 (10進数)
マルチセッションVDAでReducer V4を有効にするには、次のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd -
値の名前:
ReducerOverrideMask -
値の型:
DWORD -
値のデータ:
23(10進数)
EDTタイムアウトの構成
VDAでEDTタイムアウトを5秒から25秒の任意の値に構成できます。デフォルトのEDTタイムアウト値は25秒です。
-
キー:
HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd\Tds\udp\UDPStackParameters -
値の型:
DWORD -
値の名前:
edtConnectionTimeout -
値のデータ: 5～25秒の時間 (10進数)
Windows向けCitrix Workspace™アプリのタイムアウトも構成できます:
-
キー:
HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\EDT -
値の型:
String / REG_SZ -
値の名前:
edtConnectionTimeout -
値のデータ: 5～25秒の時間 (10進数)
Rendezvousバージョンの構成
使用するRendezvousのバージョンを構成するには、次のレジストリ値を設定します:
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\VirtualDesktopAgent -
値の型:
DWORD -
値の名前:
GctRegistration -
値のデータ:
-
1- V2を有効にするには -
0- V1を有効にするには
-
VDAへの自動ログオンを構成する
この設定により、Windows 10シングルセッションOSおよびマルチセッションOS VDAで、Microsoftポリシー設定「常にパスワードの入力を求める」を有効または無効にできます。
「常にパスワードの入力を求める」が有効になっている場合、ユーザーはリモートセッションを開始するときにVDAで資格情報を入力する必要があります。この設定が無効になっている場合、ユーザーはVDAで資格情報を入力することなく、自動的にリモートセッションに接続します。
デフォルトでは、Microsoftポリシー設定は無効になっています。「常にパスワードの入力を求める」設定を有効または無効にするには、VDAで以下のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Portica -
値の名前:
AutoLogon -
値の型:
DWORD -
値のデータ:
-
1- Microsoftポリシー設定を無効にし、ユーザーがリモートセッションに自動的にサインインできるようにします。 -
0– Microsoftポリシー設定を有効にし、ユーザーがリモートセッションを起動するときに資格情報の入力を求めます。
-
タイムアウト警告を無効にする
デフォルトでは、非アクティブまたはアイドル状態のセッションを持つユーザーは、セッションが自動的に切断される2分前に警告メッセージを受け取ります。
この設定は、以下の環境でアイドルセッションのタイムアウト制限に達したユーザーに対する警告メッセージを無効にし、削除します。
-
ウィンドウズ サーバー 2004
-
Windows 10マルチセッション2004以降のマルチセッションOS
警告を削除するには、VDA で次のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Winstations\ICA-CGP -
値の名前:
fEnableTimeoutWarning -
値の型:
DWORD -
値のデータ:
-
1- 警告メッセージを無効にする -
0- 警告メッセージを有効にする
-
警告メッセージを表示するには、レジストリ値を削除するか、
0 に設定します。
EDT MTU検出
MTU検出により、EDTはセッション確立時に最大転送単位（MTU）を自動的に決定できます。これにより、パフォーマンスの低下やセッション確立の失敗につながる可能性のあるEDTパケットの断片化を防ぎます。
この設定はデフォルトで有効になっています。EDT MTU検出を無効にするには、次のレジストリ値を構成し、VDAを再起動します。
-
キー:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd -
値の名前:
MtuDiscovery -
値の型:
DWORD -
値のデータ:
0
この設定はマシン全体に適用され、サポートされているクライアントから接続するすべてのセッションに影響します。
一般的なコンテンツリダイレクト
ホストからクライアントへのリダイレクトにURLタイプを追加する
デフォルトでは、HTTP、HTTPS、RTSP、RTSPU、PNM、MMSのURLタイプのリダイレクトをサポートしています。Windowsクライアントで以下のレジストリキーと値を作成することで、URLタイプをリストに追加できます。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Policies\Citrix\ICA Client\SFTA -
値の名前:
ExtraURLProtocols -
値の型:
REG_SZ -
値のデータ: 必要なURLタイプをセミコロンで区切って指定します。URLの権限部分より前のすべてを含めます。例:
ftp://;mailto:;customtype1://;custometype2://
URLタイプはWindowsクライアントにのみ追加できます。このレジストリ設定がないクライアントは、Citrixセッションへのリダイレクトを拒否します。クライアントには、指定されたURLタイプを処理するようにインストールおよび構成されたアプリケーションが必要です。
詳しくは、「ホストからクライアントへのリダイレクト」を参照してください。
クライアントフォルダーリダイレクト
クライアントフォルダーリダイレクトは、クライアント側のファイルがホスト側のセッションでアクセス可能になる方法を変更します。サーバーでクライアントフォルダーリダイレクトを有効にし、ユーザーがユーザーデバイスでそれを構成するとします。この場合、ユーザーが指定したローカルボリュームの一部がリダイレクトされます。
サーバーでクライアントフォルダーリダイレクトを有効にするには、次のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\Client Folder Redirection -
値の名前:
CFROnlyModeAvailable -
値の型:
DWORD -
値のデータ:
1
詳細については、クライアントフォルダーリダイレクトを参照してください。
特定のWebサイトセットのホストからクライアントへのリダイレクト
特定のWebサイトセットのホストからクライアントへのリダイレクトを有効にするには、サーバーVDAで次のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\SFTA -
値の名前:
ValidSites -
値の型:
REG_MULTI_SZ -
値のデータ: 任意の組み合わせの完全修飾ドメイン名（FQDN）を指定します。複数のFQDNは別々の行に入力します。プロトコル（
http://またはhttps://）なしでFQDNのみを含めます。FQDNには、最も左の位置にのみワイルドカード文字としてアスタリスク（*）を含めることができます。このワイルドカードは、RFC 6125の規則に準拠した単一レベルのドメインに一致します。例：
www.example.com
*.example.com
詳細については、ホストからクライアントへのリダイレクトを参照してください。
ログオフ時および切断時のローカルアプリケーションの動作
デフォルトでは、ユーザーが仮想デスクトップからログオフまたは切断しても、ローカルアプリケーションは実行を継続します。再接続後、ローカルアプリケーションが仮想デスクトップで利用可能な場合、それらは再統合されます。ログオフ時および切断時のローカルアプリケーションの動作を構成するには、ホストされたデスクトップで次のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\wow6432node\Citrix\Client Hosted Apps\Policies -
値の名前:
Session State -
値の型:
DWORD -
値のデータ:
-
1- ユーザーが仮想デスクトップからログオフまたは切断しても、ローカルアプリケーションは引き続き実行されます。再接続すると、ローカルアプリケーションが仮想デスクトップで利用可能な場合、再統合されます。 -
3- ユーザーが仮想デスクトップからログオフまたは切断すると、ローカルアプリケーションは閉じます。
-
詳細については、「ローカルアプリアクセスとURLリダイレクト」を参照してください。
ホストからクライアントへのリダイレクトのデフォルトリストからURLタイプを削除する
デフォルトのリダイレクトリストからURLタイプを削除するには、サーバーVDAで以下のレジストリキーと値を作成します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\SFTA -
値の名前:
DisableServerFTA -
値の型:
DWORD -
値のデータ:
1 -
値の名前:
NoRedirectClasses -
値の型:
REG_MULTI_SZ -
値のデータ:
http、https、rtsp、rtspu、pnm、またはmmsのいずれかの組み合わせを指定します。複数の値を別々の行に入力します。例:
http
https
rtsp
詳細については、ホストからクライアントへのリダイレクトを参照してください。
サーバーVDAのデフォルトブラウザ構成
ホストからクライアントへのリダイレクトを有効にすると、Server VDA のデフォルトのブラウザ設定を上書きできます。Web URL がリダイレクトされない場合、Citrix ランチャーは
command_backup レジストリキーで構成されているブラウザに URL を渡します。このキーはデフォルトで Internet Explorer を指していますが、別のブラウザへのパスを含むように変更できます。
-
Internet Explorer (デフォルト)
-
キー:
HKEY_CLASSES_ROOT\http\shell\open\command_backup -
値の名前:
Default -
値の型:
REG_SZ -
値のデータ:
"c:\program files\internet explorer\iexplore.exe" "%1" -
キー:
HKEY_CLASSES_ROOT\https\shell\open\command_backup -
値の名前:
Default -
値の型:
REG_SZ -
値のデータ:
"c:\program files\internet explorer\iexplore.exe" "%1"
-
-
グーグル クローム
-
キー:
HKEY_CLASSES_ROOT\http\shell\open\command_backup -
値の名前:
Default -
値の型:
REG_SZ -
値のデータ:
"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" "%1" -
キー:
HKEY_CLASSES_ROOT\https\shell\open\command_backup -
値の名前:
Default -
値の型:
REG_SZ -
値のデータ:
"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" "%1"
-
-
マイクロソフト エッジ
-
キー:
HKEY_CLASSES_ROOT\http\shell\open\command_backup -
値の名前:
Default -
値の型:
REG_SZ -
値のデータ:
"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" "%1" -
キー:
HKEY_CLASSES_ROOT\https\shell\open\command_backup -
値の名前:
Default -
値の型:
REG_SZ -
値のデータ:
"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" "%1"
-
公開アプリケーションのローカルアプリアクセス
ローカルアプリアクセスは、ローカルにインストールされたWindowsアプリケーションを、デスクトップを切り替えることなくホストされたデスクトップ環境にシームレスに統合します。公開アプリケーションへのアクセスを提供するには、サーバーで次のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\DesktopStudio -
値の名前:
ClientHostedAppsEnabled -
値の型:
DWORD -
値のデータ:
-
1- 有効にする -
0- 無効にする
-
詳細については、ローカルアプリアクセスとURLリダイレクトを参照してください。
グラフィック
CUDAまたはOpenCLアプリケーションのGPUアクセラレーション
ユーザーセッションで実行されているCUDAおよびOpenCLアプリケーションのGPUアクセラレーションは、デフォルトで無効になっています。
CUDAアクセラレーションのPOC機能を使用するには、次のレジストリ設定を有効にします。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\CtxHook\AppInit_Dlls\Graphics Helper -
値の名前:
CUDA -
値の型:
DWORD -
値のデータ:
00000001
OpenCLアクセラレーションのPOC機能を使用するには、次のレジストリ設定を有効にします。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\CtxHook\AppInit_Dlls\Graphics Helper -
値の名前:
OpenCL -
値の型:
DWORD -
値のデータ:
00000001
詳細については、WindowsマルチセッションOSのGPUアクセラレーションを参照してください。
プログレッシブモード
プログレッシブモードはデフォルトで無効になっています。次のレジストリ値でプログレッシブモードの状態を変更できます。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Graphics -
値の型:
REG_DWORD -
値の名前:
ProgressiveDisplay -
値のデータ:
-
0- 常にオフ (プログレッシブモードを無効にします。この値がデフォルトです。) -
1- 自動 (ネットワークの状態に基づいて切り替えます。) -
2 = 常にオン
-
詳細については、プログレッシブモードを参照してください。
注:
プログレッシブモードは非推奨になりました。Thinwireは、プログレッシブモードのほぼすべての利点を提供しながら、画像配信を最適化し、キャッシュ効率を維持する代替オプションです。
Windows Presentation Foundation (WPF) レンダリング
HDX 3D Proを使用すると、Windows Multi-session OSセッションで実行されているグラフィックを多用するアプリケーションを、サーバーのグラフィック処理ユニット (GPU) でレンダリングできます。Windows Presentation Foundation (WPF) レンダリングをサーバーのGPUに移行することで、グラフィックレンダリングがサーバーのCPUを遅くすることはありません。
サーバーのGPUを使用してWPFアプリケーションのレンダリングを有効にするには、WindowsマルチセッションOSを実行しているサーバーのレジストリに次の設定を作成します。
-
VDAでレジストリエディターを開き、次のキーに移動します。
HKLM\Software\Citrix\CtxHook\AppInit_DLLs\Graphics Helper -
次のレジストリ値を作成または編集します。
-
WPFアプリの実行可能ファイル名でサブキーを作成します。たとえば、アプリが「mywpfapp.exe」という名前の場合、次のキーを作成します。
HKLM\Software\Citrix\CtxHook\AppInit_DLLs\Graphics Helper\mywpfapp.exe -
設定を有効にするには、サーバーを再起動します。
詳細については、WindowsマルチセッションOS向けGPUアクセラレーション およびブログ記事 WindowsマルチセッションOSでWPFアプリを最大限に活用する を参照してください。
マルチメディア
マルチメディア会議中のエコーを回避する
Citrix Virtual Apps and Desktopsには、エコーを最小限に抑えるエコーキャンセルオプションが用意されています。この機能はデフォルトで有効になっています。エコーキャンセルを無効にするには、次のいずれかのレジストリ設定を変更できます。
-
キー:
-
32ビット:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ClientAudio -
64ビット:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ClientAudio
-
-
値の名前:
EchoCancellation -
値の型:
String/REG_SZ -
値のデータ:
False
詳細については、「オーディオ機能」を参照してください。
オーディオの制限
クライアントにオーディオデバイスをインストールし、オーディオリダイレクトを有効にしてRDSセッションを開始した後、オーディオファイルが再生されない場合があります。回避策として、RDSマシンに次のレジストリキーを追加し、マシンを再起動してください。
-
キー:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SCMConfig -
値の名前:
EnableSvchostMitigationPolicy -
値の型:
DWORD -
値のデータ:
0
詳細については、「オーディオ機能」を参照してください。
高解像度Webカメラの解像度
メディアタイプのネゴシエーションが失敗した場合、HDXはデフォルトのVGA解像度（640 x 480ピクセル）にフォールバックします。クライアントのレジストリキーを使用して、デフォルトの解像度を構成できます。以下のレジストリキーを設定する前に、カメラが指定された解像度をサポートしていることを確認してください。
-
キー:
HKEY_CURRENT_USER\SOFTWARE\Citrix\HDXRealTime -
幅
-
値の名前:
DefaultWidth -
値の型:
DWORD -
値のデータ: 目的の幅を10進数で (例: 1280)
-
-
高さ
-
値の名前:
DefaultHeight -
値の型:
DWORD -
値のデータ: 目的の高さを10進数で (例: 720)
-
Microsoft Teams フォールバックモード
Microsoft Teamsが最適化されたVDIモードでロードに失敗した場合 (Teams/バージョン情報/バージョンで「Citrix HDX未接続」と表示される場合)、VDAはウェブカメラのリダイレクトやクライアントのオーディオおよびマイクのリダイレクトなど、レガシーHDXテクノロジーにフォールバックします。Microsoft Teamsの最適化をサポートしないWorkspaceアプリのバージョン/プラットフォームOSを使用している場合、フォールバックレジストリキーは適用されません。
フォールバックメカニズムを制御するには、VDAで以下のいずれかのレジストリ値を設定します。
-
キー (いずれか1つのみ必要):
-
コンピューター設定:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Teams -
ユーザー設定:
HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\Teams
-
-
値の名前:
DisableFallback -
値の型:
DWORD -
値のデータ:
-
1- フォールバックモードを無効にする -
2- オーディオのみを有効にする
-
値が存在しないか0に設定されている場合、フォールバックモードが有効になります。この機能には、Microsoft Teamsバージョン1.3.0.13565以降が必要です。詳細については、「Microsoft Teamsの最適化」を参照してください。
Citrix App Layering™を使用したMicrosoft Teamsの最適化
Citrix App Layering を使用して VDA と Microsoft Teams のインストールを異なるレイヤーで管理している場合は、コマンドラインから
ALLUSER=1 フラグを使用して Microsoft Teams をインストールする前に、Windows 上に PortICA という名前の空のレジストリキーを作成します。既定の値の名前、種類、およびデータは変更しないでください。
-
レジストリエディターの 32 ビット版のキー:
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\PortICA -
レジストリエディターの 64 ビット版のキー:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\PortICA
詳細については、「Microsoft Teamsの最適化」を参照してください。
Web カメラのソフトウェア圧縮
Web カメラがハードウェアエンコーディングをサポートしている場合、HDX ビデオ圧縮は既定でハードウェアエンコーディングを使用します。ハードウェアエンコーディングは、ソフトウェアエンコーディングよりも多くの帯域幅を消費する可能性があります。ソフトウェア圧縮を強制するには、クライアントに次の値を追加します。
-
キー:
HKEY_CURRENT_USER\SOFTWARE\Citrix\HdxRealTime -
値の名前:
DeepCompress_ForceSWEncode -
値の型:
DWORD -
値のデータ:
1
詳細については、「HDX Web カメラのビデオ圧縮」を参照してください。
Web カメラのビデオ圧縮
HDX Webカメラビデオ圧縮は、H.264ビデオを仮想セッションで実行されているビデオ会議アプリケーションに直接送信します。VDAリソースを最適化するために、HDX Webカメラ圧縮はWebカメラビデオのエンコード、トランスコード、デコードを行いません。この機能はデフォルトで有効になっています。
サーバーからビデオ会議アプリへの直接ビデオストリーミングを無効にするには、VDAで次のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\HdxRealTime -
値の名前:
OfferH264ToApp -
値の型:
DWORD -
値のデータ:
0
詳細については、HDX webcam video compressionを参照してください。
Webカメラビデオ圧縮フレームレート
優先ビデオフレームレートを調整するには、クライアントで次のレジストリ値を編集します。
-
キー:
HKEY_CURRENT_USER\SOFTWARE\Citrix\HDXRealTime -
値の名前:
FramesPerSecond -
値の型:
DWORD -
値のデータ:
15
ウェブカメラが指定されたフレームレートをサポートしていない場合、アプリケーションはデフォルトで15 FPSを使用します。
詳細については、HDXウェブカメラビデオ圧縮を参照してください。