MSI インストーラーを用いた Azure PowerShell のインストールに失敗した場合の原因と対処方法について

Azure PowerShell をインストールする際、PowerShellGet を用いた方法と MSI インストーラーを用いた方法の２種類があります。

PowerShellGet を用いた方法に切り替えてからは、MSI インストーラーを用いた方法でのインストールは行っていなかったのですが、久しぶりにやってみたら以下のエラーが表示されうまくいきませんでした。

以下の MS サイトに記載がある前提条件 (Windows PowerShell 5.1 以降および .Net Framework 4.7.2 以降) を満たしている Windows 10/Windows Server 2019 でもインストールが失敗している状況でした。

エラーの発生状況を確認しようとしても、イベントログなどからは特に詳細な情報が記載されていない状態。

仕方がないので、Web 上から情報があるかどうかを確認したところ、合致していたものがあったため、原因と対処方法についてまとめてみました。

原因について

MSI インストーラーを用いてインストールする際、前提条件に記載されている内容以外にも必要なコンポーネント (.Net Framework 3.5 以降) が不足していたために発生した事象となります。

GitHub でも同様の現象について、報告が行われていました。

Setup: Az installed (msi) failing a check for .Net framework on machine with .Net 4.7.2 · Issue #11542 · Azure/azure-powershell
https://github.com/Azure/azure-powershell/issues/11542
Setup: Cannot install by MSI installer without .NET Framework 3.5 · Issue #9402 · Azure/azure-powershell
https://github.com/Azure/azure-powershell/issues/9402

対処方法としては、以下の 2 つとなります。

.Net Framework 3.5 の機能を有効化することで、対処することが可能です。

クライアント OS (Windows 10 で確認) の場合
1. [コントロールパネル] – [すべてのコントロールパネル項目] – [プログラムと機能] を起動、[Windows の機能の有効化または無効化] をクリックします。
2. [.NET Framework 3.5 (.NET 2.0 および 3.0 を含む)] を有効化します。
サーバー OS (Windows Server 2019) の場合
1. [サーバーマネージャー] – [管理] – [役割と機能の追加] を起動します。
2. [機能] にて、[.NET Framework 3.5 Features] を有効化します。