PowerShell でモジュールを追加しようとした際、Install-Module が失敗して困った経験はありませんか？
|
1 |
Install-Module xxx |
一見シンプルなコマンドですが、
実行環境・権限・ネットワーク・TLS 設定などが原因で、意外と多くのエラーが発生します。
この記事では、
Install-Module が実行できない代表的な原因と、その具体的な対処法をエラー別にまとめます。
1. PowerShellGet が古い / 未インストール
よくあるエラー例
原因
-
PowerShellGet モジュールが存在しない
-
古い PowerShell 環境（Windows PowerShell 5.0 未満など）
対処法
PowerShellGet を更新（またはインストール）します。
※ 管理者権限で実行してください。
2. 管理者権限で実行していない
よくあるエラー例
原因
-
システム全体 (
AllUsers) へのインストールには管理者権限が必要
対処法
-
PowerShell を 「管理者として実行」
-
もしくは、ユーザー単位でインストール
1Install-Module xxx -Scope CurrentUser
3. TLS 1.2 が無効（特に古い環境）
よくあるエラー例
原因
-
PowerShell Gallery は TLS 1.2 以上必須
-
Windows Server 2012 / 2016 などで未設定の場合が多い
対処法
一時的に TLS 1.2 を有効化します。
その後、再度 Install-Module を実行してください。
4. PowerShell Gallery が信頼されていない
よくあるエラー例
原因
-
PowerShell Gallery が「未信頼リポジトリ」のまま
対処法
信頼済みに設定します。
5. プロキシ環境で通信できない（社内ネットワーク）
よくあるエラー例
原因
-
社内プロキシ越しで PowerShell Gallery に接続できない
-
プロキシ認証が必要
対処法
プロキシを明示的に設定します。
|
1 2 |
$proxy = New-Object System.Net.WebProxy("http://proxy.example.local:8080") [System.Net.WebRequest]::DefaultWebProxy = $proxy |
認証が必要な場合は資格情報を設定してください。
6. 実行ポリシーによりスクリプトがブロックされている
よくあるエラー例
原因
-
実行ポリシーが
Restricted
対処法
現在のポリシーを確認。
一時的に緩和します（推奨）。
7. 証明書ストアの問題（SSLエラー）
よくあるエラー例
原因
-
ルート証明書が古い
-
SSLインスペクション環境
対処法
-
Windows Update を適用
-
社内証明書を信頼済みに追加
（企業環境では情シス確認が必要なケースが多い）
8. オフライン環境・インターネット接続不可
原因
-
インターネットに直接接続できないサーバー
対処法
別PCでモジュールを取得し、手動配置します。
取得したフォルダを対象サーバーの$env:PSModulePath 配下にコピーします。
9. よくあるチェックリスト（まとめ）
Install-Module が失敗したら、以下を順に確認すると効率的です。
-
管理者権限で実行しているか
-
PowerShellGet が最新か
-
TLS 1.2 が有効か
-
PSGallery を信頼しているか
-
プロキシ設定が必要か
-
実行ポリシーが厳しすぎないか
まとめ
Install-Module が実行できない原因は、
コードの問題ではなく「実行環境」や「セキュリティ設定」であることがほとんどです。
特に、
-
古い Windows / PowerShell
-
社内プロキシ環境
-
TLS 設定
この3点は ハマりやすいポイントなので、最初に疑うのがおすすめです。