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では、異なるレジストリの場所が使用されていました。
詳細については、「クライアントドライブマッピング」を参照してください。
マイクロソフト Surface Pro および Surface Book ペン
Citrix Virtual Apps and Desktopsは、Windows Inkベースのアプリケーションで標準のペン機能をサポートしています。デフォルトでは、この機能は有効になっています。
この機能を無効または有効にするには、次のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Citrix Virtual Desktop Agent\PenApi -
値の名前:
DisablePen -
値の型:
DWORD -
値のデータ:
-
1- 無効 -
0- 有効
-
Windows イメージ取得アプリケーションの許可リスト
この設定により、VDA 上のどのアプリケーションが Windows イメージ取得スキャナーリダイレクトにアクセスできるかを制御できます。
デフォルトでは、どのアプリケーションも Windows イメージ取得にアクセスできません。
VDA 上のアプリケーションに対して Windows イメージ取得を調整するには、次のレジストリ設定を作成します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix -
値の名前:
WIAAllowedProcessesWIAAllowedProcesses を選択して右クリックします。「新規 > 複数行文字列値」を選択し、新しい値を AllowProcesses に名前変更します。 -
値のデータ: Windows イメージ取得にアクセスできる各アプリケーションの完全なパスとプロセス名を入力します。各アプリケーションを新しい行に入力してください。
この設定への変更は、次回 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進数)
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検出を無効にするには、以下のレジストリ値を構成し、セッションホストを再起動します。
-
キー:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd -
値の名前:
MtuDiscovery -
値の型:
DWORD -
値のデータ:
0
MTU Rediscovery を有効にするには、以下のレジストリ値を構成し、セッションホストを再起動します。
-
キー:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd\MtuRediscovery -
値の名前:
MtuReDiscovery -
値の型:
DWORD -
値のデータ:
1 -
キー:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd\MtuRediscovery -
値の名前:
MtuReDiscoveryFrequency -
値の型:
DWORD -
値のデータ:
1
これらの設定はマシン全体に適用され、サポートされているクライアントから接続するすべてのセッションに影響します。
EDTタイムアウト
VDAのEDTタイムアウトは5秒から25秒の間の任意の値に設定できます。デフォルトのEDTタイムアウト値は10秒です。
-
キー:
HKLM\SYSTEM\CurrentControlSet\Control\Terminal Server\Wds\icawd\Tds\udp\UDPStackParameters -
値の型:
DWORD -
値の名前:
edtConnectionTimeout -
値のデータ: 5～25秒（10進数）
Citrix Workspaceアプリ for Windows バージョン2409.10以前の場合も、EDTタイムアウトを設定できます。
-
キー:
HKLM\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Network\EDT -
値の型:
String / REG_SZ -
値の名前:
edtConnectionTimeout -
値のデータ: 5～25秒（10進数）
注：
バージョン2503以降のCitrix Workspaceアプリでは、VDAからのタイムアウト設定が使用されるため、クライアントデバイスでタイムアウトを設定する必要がなくなります。
一般的なコンテンツリダイレクト
ホストからクライアントへのリダイレクト用の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
詳細については、「ホストからクライアントへのリダイレクト」を参照してください。
Server 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"
-
公開アプリケーションのローカルアプリアクセス
Local App Access は、ローカルにインストールされた Windows アプリケーションを、デスクトップを切り替えることなくホストされたデスクトップ環境にシームレスに統合します。公開アプリケーションへのアクセスを提供するには、サーバーで次のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\DesktopStudio -
値の名前:
ClientHostedAppsEnabled -
値の型:
DWORD -
値のデータ:
-
1- 有効 -
0- 無効
-
詳細については、「Local App Access と 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 webcam video compressionを参照してください。
Webカメラビデオ圧縮
HDX Webカメラビデオ圧縮は、H.264ビデオを仮想セッションで実行されているビデオ会議アプリケーションに直接送信します。VDAリソースを最適化するために、HDX Webカメラ圧縮はWebカメラビデオのエンコード、トランスコード、デコードを行いません。この機能はデフォルトで有効になっています。
サーバーからビデオ会議アプリへの直接ビデオストリーミングを無効にするには、VDAで次のレジストリ値を設定します。
-
キー:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\HdxRealTime -
値の名前:
OfferH264ToApp -
値の型:
DWORD -
値のデータ:
0