AD 参加エラーのトラブルシューティング: プラグインマニフェストファイルが見つかりません

稀に、セッションホストまたはデスクトップイメージを作成する際に、AD 参加タスクがタイムアウトし、次のようなエラーメッセージが返されることがあります:

エラー: AD 拡張機能のインストール中にエラーが発生しました: System.AggregateException: 1つ以上のエラーが発生しました。（長時間の操作が「失敗」ステータスで終了しました。）追加情報: 'VM 拡張タイプ「Microsoft.Compute.JsonADDomainExtension」のハンドラーが、VM 拡張「<vm_name>-join-ad-ext」に対して致命的な失敗を報告しました。エラーメッセージ: 「プラグイン Microsoft.Compute.JsonADDomainExtension バージョン 1.3.6 拡張 '' の処理中にエラーが発生しました。状態: 有効、エラー: プラグインマニフェストのデシリアライズに失敗しました。プラグインフォルダー内に C:\Packages\Plugins\Microsoft.Compute.JsonADDomainExtension\1.3.6\HandlerManifest.json が見つかりませんでした。」'

このエラーは、拡張機能（AD 参加）が VM に正常にインストールおよび初期化できなかったことを示しています。これは、VMがドメインに参加できなかったことを示すものではありません。さらに、拡張機能が正しく初期化されなかったため、AD 参加ログのダウンロード機能はNerdio Managerで有用な情報を返しません。

回避策

通常、このエラーが発生した場合、最初に VM から AD 参加拡張機能を削除した後、ホストの追加またはデスクトップイメージの追加ステップでタスクを再開できます。拡張機能がVMから削除されたら、再開を選択すると、Nerdio Manager同じステップが再試行されます。通常、3～5分程度で正常に完了します。

ソリューション

この拡張機能が初回に正常に処理されず、拡張機能を一度削除した後の再試行で正常に完了する理由のひとつは、セッションホストまたは新しいデスクトップイメージのプロビジョニングに使用された元の VM イメージに、クリーンアップされていない古い拡張データが残っていることです。

以前の AD 参加ステップから残る可能性がある場所の一つは、HandlerState レジストリキーです。このキーは、VMにインストールされた拡張機能の現在のステータスを追跡するために使用されます。AD 参加拡張機能がクリーンにアンインストールされると、レジストリキーとフォルダーの場所は完全に削除される必要があります。新しいセッションホストまたはデスクトップイメージが、AD 参加拡張機能が正しくアンインストールされなかった VM からプロビジョニングまたはクローンされた場合、レジストリキーまたはフォルダーに残った値が現在の AD 参加プロセスに影響を及ぼし、上記のエラーを引き起こす可能性があります。

新しいセッションホストまたはデスクトップイメージをプロビジョニングするために使用される元の（ソース）VMでは、以下のことを確認してください。

• AD 参加拡張機能は現在インストールされていません。

• フォルダーの場所 C:\Packages\Plugins\Microsoft.Compute.JsonADDomainExtension は存在しません。

• レジストリの場所 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Azure\HandlerState\Microsoft.Compute.JsonADDomainExtension_1.3.6 は存在しません。

上記の項目が見つかった場合、それらはアンインストールまたは削除する必要があります。元の（ソース）VMでアンインストールまたは削除した後、電源オフおよびイメージとして設定プロセスを再実行して、新しいイメージオブジェクトをプロビジョニング用に生成する必要があります。