VDI プラグインのインストールをトラブルシューティングする方法

今回は、Citrix Receiver、VMware Horizon Client、または Azure Virtual Desktop（AVD）でよくある問題のトラブルシューティングと解決に役立つ情報を紹介します。この記事は、一部のユーザーでインストールがうまくいかない理由を確定するという点においても役立ちます。

この記事では、次の項目について説明します。

Citrix Receiver、VMware Horizon Client、または Azure Virtual Desktop（AVD）でよくある問題をトラブルシューティングする方法
インストーラログを収集する方法

Citrix Receiver、VMware Horizon Client、または Azure Virtual Desktop（AVD）でよくある問題をトラブルシューティングする方法

アプリケーションがまだ実行中であるというエラー

問題: Zoom Plugin for Citrix Receiver または Zoom Plugin for VMware Horizon Client で「Citrix Receiver または VMware Horizon Client が実行中です。このアプリケーションを終了してから、Zoom Plugin for Citrix Receiver または VMware Horizon Client のインストールを続行してください」というエラーメッセージが表示されます。この問題で考えられる原因は、インストール中も Citrix Receiver または VMware Horizon Client がまだ実行していることです。

推奨事項:

このプロセスで何か開いているウィンドウがあれば、すべて閉じてからインストールを続行します。
プロセスが先に進まなくなった場合は、該当するプロセス（wfica32.exe または vmware-view.exe）をタスクマネージャーで終了させるか、コマンドプロンプトから管理者として以下を実行します。
```
taskkill /im wfica32.exe /f
taskkill /im vmware-view.exe /f
```

別のバージョンへのインストールで発生するエラー

問題: 別のバージョンへインストールできません。標準（完全自動モード以外の）インストールで、Zoom Plugin for Citrix Receiver または Zoom Plugin for VMware Horizon Client から「より新しいバージョンの Citrix Receiver または VMware Horizon Client がすでにインストールされているため、インストールできません」というエラーメッセージが表示されます。

推奨事項:

現在、インストールされているシンクライアントのバージョンが、インストールしようとしているバージョンより新しいかどうかを確認します。
この問題を解決するには、既存のプラグインをアンインストールし、新しい VDI プラグインを再インストールしてみてください。

ファイルのコピー中に発生するエラー

問題: Windows シンクライアントで VDI プラグインがインストールできません。 VDI プラグインのインストール中にインストールがロールバックされ、Zoom Plugin for Citrix Receiver または Zoom Plugin for VMware Horizon Client から、「ファイルのコピー中にエラーが発生し、インストールを完了できませんでした」というエラーメッセージが表示されます。

推奨事項: このような問題で考えられる原因をトラブルシューティングするには、以下のシンクライアントプラットフォーム（Citrix または VMware）別のトラブルシューティング手順に従って操作します。
注: これらのトラブルシューティング手順は、インストーラが Zoom のプロダクトをインストールする際に使用するロジックに沿ったものです。

Citrix Workspace または Receiver のトラブルシューティング

Citrix Workspace または Receiver のインストールを確認する

Zoom のインストーラでは、バイナリファイルを既存の Citrix Workspace または Receiver 用インストールフォルダに直接コピーしなければならないため、システム上にそのフォルダが存在している必要があります。
注: 対象システムに、Workspace または Receiver がインストールされていること、それが UWP または Microsoft ストアバージョンに該当しないことを確認します。バージョン間の違いの詳細情報については「Citrix Receiver for Windows のエディション（ストアインストールか、手動インストールか）を検出する方法は？」をご覧ください。

インストーラがファイルのコピーを完了したかどうかを確認する

デフォルトでは、Zoom Citrix プラグインのバイナリが以下のインストールディレクトリにコピーされます。

64 ビット OS: C:\Program Files (x86)\ZoomCitrixHDXMediaPlugin
32 ビット OS: C:\Program Files\ZoomCitrixHDXMediaPlugin

プラグインのインストールが完了しているかどうかを確認するためには、以下のとおりに操作します。

先ほど説明したインストールフォルダにあるバイナリファイル（末尾が .dll、.exe のファイル）をすべてチェックし、[変更日時] 列の日付に数時間以上のばらつきがあるかどうか（数日など）を確認します。
日付のばらつきが数日を超えている場合、破損したインストール、またはユーザーが手動で変更したファイルが存在します（修正するにはアンインストールと再インストールが必要です）。

ZoomCitrixHDXMediaPlugin\Plugin にあるファイルは、プラグインファイル（zoommedia.dll, cmmlib.dll、libcrypto-1_1.dll, util.dll）で、必然的に [変更日時] が親フォルダのファイルと同様になります。これらのファイルを Citrix Receiver のインストールパスにコピーする必要があります。なお、このパスは HKCU\SOFTWARE\Citrix\Install\ICA Client または HKLM にあるレジストリキーの値「InstallFolder」を確認すると見つかります。

または Citrix Receiver が実行中の場合は、タスクマネージャーを使用し、以下の操作でインストールパスを取得することもできます。

Ctrl + Alt + Delete キーを押してタスクマネージャーを開きます。
[詳細] タブをクリックします。
wfica32.exe を探します。
wfica32.exe を右クリックし、ドロップダウンメニューから [ファイルの場所を開く] を選択します。

プラグイン登録を確認する

プラグイン登録を確認するためには、レジストリエディタ（regedit.exe）を起動します。次のレジストリキーのパスと値が、以下のデータどおり表示されることを確認します。

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ICA 3.0]
"VirtualDriverEx"="ZoomCitrixMediaPlugin"

[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ZoomCitrixMediaPlugin]
"DriverName"="ZoomMedia.dll"
"DriverNameWin32"="ZoomMedia.dll"
"ZoomPath"="C:\Program Files (x86)\ZoomCitrixHDXMediaPlugin"

Citrix プラグイン接続の失敗

Citrix ICA ポリシーには、アプリケーションによるバーチャルチャネルの割り当てを許可するかどうかをコントロールするオプションが含まれます。 Citrix VDA 2109 からは、デフォルトのバーチャルチャネル許可リストポリシーが「有効」から「無効」に変更されました。この変更の詳細情報については、記事「Citrix バーチャルチャネル許可リストポリシーの設定」をご覧ください。

VMWare Horizon Client のトラブルシューティング

VMware Horizon Client のインストールを確認する

Zoom のインストーラでは、バイナリファイルをそのフォルダに直接コピーしなければならないため、VMware Horizon Client がインストールされている必要があります。インストーラは以下のレジストリキー値を使用して VMware Horizon のインストールフォルダを探します。

シンクライアントにこのキーが存在していること、InstallPath のデータが既存フォルダ（HKLM\Software\VMware, Inc.\VMware VDM\RemoteExperienceAgent）を指していることを確認します。

インストーラがファイルのコピーを完了したかどうかを確認する

デフォルトでは、Zoom VMware プラグインのバイナリが以下のインストールディレクトリにコピーされます。

64 ビット OS: C:\Program Files (x86)\ZoomVMwareMediaPlugin
32 ビット OS: C:\Program Files\ZoomVMwareMediaPlugin

プラグインのインストールが完了しているかどうかを確認するためには、以下のとおりに操作します。

先ほど説明したインストールフォルダにあるバイナリファイル（末尾が .dll、.exe のファイル）をすべてチェックし、[変更日時] 列の日付に数時間以上のばらつきがあるかどうか（数日など）を確認します。
日付のばらつきが数日を超えている場合、破損したインストール、またはユーザーが手動で変更したファイルが存在します（修正するにはアンインストールと再インストールが必要です）。

ZoomVmwareMediaPlugin\Plugin（32 ビット）、ZoomVmwareMediaPlugin\x64（64ビット）にあるファイルは、VMware Horizon のインストールフォルダにコピーされるプラグインインストールファイルです。なお、このフォルダはレジストリキー HKLM\Software\VMware, Inc.\VMware VDM\RemoteExperienceAgent を確認し、InstallPath にあるファイルパスを開くと見つかります。

プラグイン登録を確認する

プラグイン登録を確認するためには、レジストリエディタ（regedit.exe）を起動します。次のレジストリキーのパスと値が、以下のデータどおり表示されることを確認します（以下に示すデフォルトパスはほんの一例）。

[HKEY_LOCAL_MACHINE\SOFTWARE\VMware, Inc.\VMware VDPService\Plugins\ZoomMedia]
"dll" = "C:\Program Files (x86)\VMware\VMware Horizon View Client\x64\ZoomMediaForHorizon.dll"
"ZoomPath"="C:\Program Files (x86)\ZoomVmwareMediaPlugin"

VMware プラグイン接続の失敗

Zoom は Horizon Client に VMware の接続プロトコルを使用するよう推奨しています。 Linux を実行しているシンクライアントは、VMware Horizon の接続プロトコルとして PCoIP の指定を許可する場合があります。ただしオペレーティングシステムが提供する PCoIP のバージョンによっては、Zoom VDI プラグインへの接続に必要なバーチャルチャネルがサポートされていない可能性があります。 VDI プラグインが接続しない場合、接続プロトコルを VMware Blast のプロトコルに切り替えます。

AVD プラグインのトラブルシューティング

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Terminal Server Client\Default\AddIns\ZoomWVD]
"name" = "C:\Program Files (x86)\ZoomWVDMediaPlugin\x64\ZoomMediaWVD.dll"
"zoompath" = "C:\Program Files (x86)\ZoomWVDMediaPlugin\"

インストーラログを収集する方法

さらなるトラブルシューティングが必要な場合、プラグインまたは VDI Client インストーラのログのご提供をお願いする場合があります。 Zoom VDI Plugin 5.7.0 以降の Windows プラグインは、MSI インストーラのログ記録機能をサポートしています。

インストーラログを収集するには、次のとおりに操作します。

管理者としてコマンドプロンプトを起動し、次のコマンドを実行します。
msiexec /i %MSI_FILE_PATH% /L*V %LOG_FILE_OUTPUT%
%LOG_FILE_OUTPUT% を該当するログファイル名（末尾が .txt）に書き換えます。
%MSI_FILE_PATH% を該当するインストーラへのパスに書き換えます。例:
msiexec /i ZoomWVDMediaPlugin.msi /L*V .\log.txt