Windows に Azure PowerShell をインストールする
Az PowerShell モジュールはロールアップ モジュールです。 Az PowerShell モジュールをインストールすると、一般提供されているモジュールがダウンロードされ、そのコマンドレットを使用できるようになります。
Az PowerShell モジュールの推奨されるインストール方法と PowerShell バージョンは以下のとおりです。
- PowerShell ギャラリーからインストールする
- PowerShell バージョン 7 以降を使用する
この記事では、PowerShell ギャラリーから Windows に Az PowerShell モジュールをインストールする方法について説明します。
前提条件
お使いの PowerShell のバージョンを確認するには、PowerShell から次のコマンドを実行します。
$PSVersionTable.PSVersion
AzureRM PowerShell モジュールがインストールされているかどうかを確認します。
Get-Module -Name AzureRM -ListAvailable
重要
AzureRM PowerShell モジュールがインストールされている場合は、次に進む前に、「Az と AzureRM の共存」を参照してください。
- サポートされているバージョンの PowerShell バージョン 7 以降をインストールする
PowerShell スクリプトの実行をリモート署名済みまたは制限が緩い状態に設定します。
PowerShell 実行ポリシーを確認します。
Get-ExecutionPolicy -List
PowerShell 実行ポリシーをリモート署名済みに設定します。
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
実行ポリシーの詳細については、「about_Execution_Policies」を参照してください。
インストール
Az PowerShell モジュールをインストールするには、Install-Module コマンドレットを使用します。
Install-Module -Name Az -Repository PSGallery -Force
Az PowerShell モジュールを更新する
Update-Module を使用して、Az PowerShell モジュールの最新バージョンに更新します。
Update-Module -Name Az -Force
Update-Module
を使用して Az PowerShell モジュールを更新しても、以前のバージョンの Az PowerShell モジュールはシステムから削除されません。
アンインストール
Az PowerShell モジュールを削除するには、「Azure PowerShell モジュールのアンインストール」を参照してください。
この記事では、MSI インストーラを使って Windows に Az PowerShell モジュールをインストールする方法について説明します。 MSI インストーラーは、PowerShell ギャラリーがファイアウォールによってブロックされる可能性がある環境や、オフライン インストーラーが必要な環境向けに用意されています。
重要
MSI インストール オプションは、Windows PowerShell 5.1 で使用するために Az PowerShell モジュールをインストールする場合にのみ使用できます。
前提条件
お使いの PowerShell のバージョンを確認するには、PowerShell から次のコマンドを実行します。
$PSVersionTable.PSVersion
AzureRM PowerShell モジュールがインストールされているかどうかを確認する
Get-Module -Name AzureRM -ListAvailable
重要
AzureRM PowerShell モジュールがインストールされている場合は、次に進む前に、「Az と AzureRM の共存」を参照してください。
Windows PowerShell 5.1 に更新する
.NET Framework 4.7.2 以降をインストールする
PowerShell スクリプトの実行をリモート署名済みまたは制限が緩い状態に設定する
PowerShell 実行ポリシーを確認します。
Get-ExecutionPolicy -List
PowerShell 実行ポリシーをリモート署名済みに設定します。
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
実行ポリシーの詳細については、「about_Execution_Policies」を参照してください。
インストールと更新
Azure PowerShell 用の MSI パッケージは GitHub から入手できます。
- github.com/Azure/azure-powershell/releases にアクセスする
- 最新の Az PowerShell モジュールを見つけます。 これらは、名前のない状態で時系列順に一覧表示されます。 たとえば、
9.5.0
のように指定します。 - パッチのメモの一番下までスクロールし、[資産] の横にある矢印をクリックして MSI オプションを表示します。
- 任意の Az-Cmdlets MSI をクリックして、ダウンロードを開始する
インストーラによって、MSI を使用してインストールされた Az PowerShell モジュールの古いバージョンが自動的に削除されます。 MSI パッケージでは、"${env:ProgramFiles}\WindowsPowerShell\Modules"
にモジュールがインストールされます。
サインイン
Az PowerShell モジュールを使用して Azure リソースの管理を開始するには、PowerShell セッションを起動し、Connect-AzAccount
を実行して Azure にサインインします。
Connect-AzAccount
Azure アカウントのログイン資格情報を使用して、開いたブラウザー ウィンドウにログインします。
新しい PowerShell セッションを開始するたびに、この手順を繰り返す必要があります。 Azure サインインを PowerShell セッション間で維持する方法については、Azure PowerShell コンテキスト オブジェクトに関する記事を参照してください。
トラブルシューティング
Az PowerShell モジュールの一般的なインストールに関する問題の解決策については、Az PowerShell モジュールのインストールに関する問題のトラブルシューティングに関するページを参照してください。
フィードバックを提供する
Az PowerShell モジュールに関する問題を報告するには、「GitHub で問題を報告する」を参照してください。
PowerShell セッション内からフィードバックを提供するには、Send-Feedback コマンドレットを使用します。
次の手順
Az PowerShell モジュールを使用した Azure リソースの管理について詳しくは、「Azure PowerShellの概要」を参照してください。
Azure PowerShell