メインコンテンツにスキップ

グローバル アセンブリ キャッシュ (GAC) 内の別バージョンの DLL が優先されている

グローバル アセンブリ キャッシュ (GAC) は、ShareGate Migrate などの .Net Framework アプリケーションが使用する EXE (実行可能ファイル) と DLL (ライブラリ) ファイルの集まりです。

GAC は、Windows オペレーティング システムの一部です。

症状

ShareGate Migrate で次の警告が表示されます。

Another version of a DLL in your Global Assembly Cache (GAC) is prioritized over a DLL packaged and used by ShareGate Migrate. This might prevent some features from working as expected.

Windows PowerShell 5.1 で Import-Module Sharegate を実行したときに、次のような TypeLoadException が発生することもあります。

Method 'Handle' in type 'Workleap.Extensions.MediatR.StreamRequestTracingBehavior`2' from assembly 'Workleap.Extensions.MediatR, Version=1.5.7.0' does not have an implementation.

詳細

ShareGate Migrate には、複数の DLL がパッケージされています。これらは GAC にはインストールされません。

この警告は、通常、別のアプリケーションがこれらの DLL のいずれかを GAC に直接インストールした場合に表示されます。

DLL が GAC に存在する場合、Windows オペレーティング システムは、アプリにパッケージされている DLL ではなく、GAC にあるバージョンの DLL を優先します。

GAC にある DLL のバージョンが古い場合や、アプリにパッケージされているものと異なる場合は、一部の機能が使えなくなったり、アプリが動作しなくなったりすることもあります。

影響を受けやすい代表的な DLL は、Microsoft.Sharepoint.Client.dll と Newtonsoft.Json.dll です。これらは通常、開発ツールによって GAC にインストールされます。

注: これらは最も影響を受けやすい DLL ですが、アプリによっては、ShareGate Migrate に影響する他の DLL を GAC にインストールする場合があります。

解決策

DLL を GAC にインストールしたアプリケーションをアンインストールできれば、問題は解決するはずです。

ただし、どの DLL が影響を受けていて、どのアプリケーションが GAC にインストールしたのかを特定するのは簡単ではありません。

ShareGate から開いた PowerShell ウィンドウでテストする

Import-Module Sharegate で TypeLoadException が発生する場合は、左下隅のボタンを使用して ShareGate Migrate から PowerShell を開きます。このウィンドウでは ShareGate モジュールのみが読み込まれるため、別の PowerShell モジュールがエラーの原因かどうかがわかります。そこでもエラーが発生する場合は、お使いのコンピューター上の DLL の競合が原因である可能性が高くなります。

別のコンピューターに ShareGate Migrate をインストールする

同じアプリや開発ツールがインストールされていない別のコンピューターに ShareGate Migrate をインストールしてみてください。これが、より早く解決できる最善の方法です。

別のコンピューターにアプリをインストールできない場合

現在のコンピューターしか使えず、どのアプリが DLL を GAC にインストールしたのか特定できない場合は、サポート チームが、影響を受けている DLL の特定をお手伝いします。

この情報から、問題の原因となっているアプリケーションを見つけられる場合や、その DLL を更新して問題を解決できる場合があります。

注: サポートが影響を受けている DLL の特定をお手伝いできても、多くの場合、どのアプリケーションが GAC にインストールしたのかまでは特定できないことをしっかりとご理解ください。GAC から DLL を削除することはお勧めしません。特にサーバーで作業している場合はなおさらです。DLL を削除すると、他のアプリケーションが使用できなくなる可能性があります。

この記事は人工知能を使用して翻訳されました。疑問がある場合は、元の英語版をご確認ください。

こちらの回答で解決しましたか?