Windows での Azure CLI のインストール

[アーティクル]
08/19/2024

Azure コマンドラインインターフェイス (CLI) は、Windows コンピューターにローカルにインストールできるクロスプラットフォームコマンドラインツールです。 Windows 用 Azure CLI を使用して Azure に接続し、Azure リソースに対して管理コマンドを実行することができます。また、Windows 用 Azure CLI は、ブラウザーから Azure Cloud Shell を介して使用することも、Docker コンテナー内から実行することもできます。

Windows の場合、Azure CLI は MSI または ZIP パッケージを介してインストールされます。これにより、Windows コマンドプロンプト (CMD) または PowerShell を使用して CLI にアクセスできます。 Linux 用 Windows サブシステム (WSL) のインストールを実行するときは、お使いの Linux ディストリビューションで使用できるパッケージがあります。サポートされているパッケージマネージャーの一覧または WSL での手動インストール方法については、メインのインストールページを参照してください。

Azure CLI の現在のバージョンは、2.68.0です。最新リリースについては、リリースノートをご覧ください。インストール済みのバージョンを見つけ、更新する必要があるかどうかを確認するには、az version を実行します。

インストールまたは更新

MSI および ZIP 再頒布可能パッケージは、Windows に Azure CLI をインストールまたは更新するために使用されます。 MSI では既存のバージョンが更新されるため、MSI インストーラーを使用する前に現在のバージョンをアンインストールする必要はありません。

重要

インストールが完了したら、Azure CLI を使用するには、アクティブなターミナルウィンドウを閉じてから再度開く必要があります。

WinGet (Windows パッケージマネージャー)

WinGet(Windows 用 Microsoft のパッケージマネージャー) を使用して、Azure CLI の更新プログラムをインストールおよび管理します。既定では、Winget は 64 ビットの Azure CLI を 64 ビットオペレーティングシステムにインストールします。

注意

WinGet は、Windows 11 および最新バージョンの Windows 10 で既定で使用できます。ただし、古いバージョンの Windows にはインストールされていない可能性があります。インストール手順については、winget のドキュメントを参照してください。

winget install -e --id Microsoft.AzureCLI

-e オプションにより、公式の Azure CLI パッケージが確実にインストールされます。このコマンドは、既定で最新バージョンがインストールされます。バージョンを指定するには、目的のバージョンを設定した -v <version> をコマンドに追加します。次に例を示します。

winget install -e --id Microsoft.AzureCLI -v 2.66.0

Microsoft インストーラー (MSI)

特定のバージョン

必要に応じて、URL を使用して特定のバージョンの Azure CLI をダウンロードできます。

特定のバージョンの MSI インストーラーをダウンロードするには、URL https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>.msi (32 ビット) または https://azcliprod.blob.core.windows.net/msi/azure-cli-<version>-x64.msi (64 ビット) でバージョンセグメントを変更します。

たとえば、Azure CLI バージョン 2.51.0 の 32 ビット MSI をインストールするには、URL は https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi になります。対応する 64 ビットインストールは https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi になります。

使用可能な Azure CLI バージョンについては、「Azure CLI リリースノート」を参照してください。 64 ビット MSI はバージョン 2.51.0 から使用できます。

PowerShell を使用した Microsoft インストーラー (MSI)

PowerShell を使用して Azure CLI をインストールするには、管理者として PowerShell を起動し、次のコマンドを実行します。

$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi

これにより、Azure CLI for Windows の最新の 32 ビットインストーラーがダウンロードされてインストールされます。 64 ビットインストールを使用する場合は、URL を https://aka.ms/installazurecliwindowsx64 に変更します。 Azure CLI が既にインストールされている場合、インストーラーによって既存のバージョンが上書きされます。

特定のバージョンをインストールするには、-Uri 引数を次のセクションで説明する URL に置き換えます。 PowerShell で Azure CLI バージョン 2.51.0 の 32 ビットインストーラーを使用する例を次に示します:

$ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi

特定のバージョン

使用可能な Azure CLI バージョンについては、「Azure CLI リリースノート」を参照してください。 64 ビット MSI はバージョン 2.51.0 から使用できます。

Bash と PowerShell の構文の違い

ほとんどの Azure CLI ドキュメントは Bash シェルで記述およびテストされていますが、PowerShell を使用して Azure CLI をインストールして実行することもできます。 Bash と PowerShell では構文が若干異なります。スクリプトエラーを回避するには、次の記事を確認してください。

PowerShell スクリプト言語での Azure CLI の実行に関する考慮事項
Azure CLI パラメーターでの引用符の使用
bash、PowerShell、および cmd の azure CLI 構文の違いでの Bash、PowerShell、およびCmd.exeの構文を比較する

PowerShell で Azure CLI を実行している場合は、エラー処理の違いや、タブ補完を有効にする機能もあります。詳細は次の記事をご覧ください。

PowerShell でのAzure CLI のエラー処理
PowerShell で Azure CLI のタブ補完を有効にする

ZIP パッケージ

重要

このパッケージは現在プレビュー段階にあります。

ZIP パッケージを使用して、Windows に Azure CLI をインストールできます。このパッケージは、管理特権がない場合に便利です。

パッケージをフォルダーに解凍し、Cmd または PowerShell を使用して、 <unzipped folder path>\bin\az.cmdを実行して Azure CLI を呼び出します。

az コマンドを直接実行する場合は、次の手順に従って、PATH環境変数に Azure CLI を追加します。

スタートメニューを開き、 environment variablesを検索します。 Edit the system environment variablesをクリックします。
Environment Variables... ボタンをクリックします。
[ User varibles for <username> ] ボックスで、[ Path ] を選択し、[ Edit... ] ボタンをクリックします。
[ New ] ボタンをクリックし、 <unzipped folder path>\bin を一覧に追加します。
ターミナルを再起動します。 これで、 az コマンドを実行できるようになります。

特定のバージョン

必要に応じて、URL を使用して特定のバージョンの Azure CLI をダウンロードできます。

特定のバージョンの ZIP パッケージをダウンロードするには、URL https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zipでバージョンセグメントを変更します。

たとえば、Azure CLI バージョン 2.57.0 の 64 ビット ZIP をインストールするには、URL が https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zipされます。

使用可能な Azure CLI バージョンについては、「Azure CLI リリースノート」を参照してください。 ZIP パッケージはバージョン 2.57.0 から入手できます。使用できるのは 64 ビットのみです。

Azure CLI を実行する

インストール後、アクティブなターミナルウィンドウを閉じてから再度開きます。 Windows コマンドプロンプトまたは PowerShell の az コマンドを使用して Azure CLI を実行します。一般的な最初の手順は、アクティブなサブスクリプションを確認することです。

az account show

インストールのトラブルシューティング

ここでは、Windows に Azure CLI をインストールする際に発生する一般的な問題をいくつか示します。ここで取り上げていない問題が発生した場合は、GitHub で問題を報告してください。

PATH 変数が設定されていません

この問題の最も一般的な原因は、インストール後にアクティブなターミナルウィンドウが再起動されていないことです。アクティブなターミナルウィンドウを閉じてから再度開きます。

プロキシによる接続のブロック

プロキシにより接続がブロックされているため MSI インストーラーをダウンロードできない場合、プロキシを正しく構成していることを確認します。 Windows 10 の場合、これらの設定は Settings > Network & Internet > Proxy ウィンドウで管理されます。必要な設定またはお使いのマシンの構成が管理されている状況や高度なセットアップが必要な状況については、システム管理者にお問い合わせください。

重要

また、これらの設定は、CLI を使用した Azure サービスに PowerShell またはコマンドプロンプトの両方からアクセスできるようにするためにも必要です。これを行うには、PowerShell で次のコマンドを使用します。

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

MSI を取得するには、プロキシで次のアドレスへの HTTPS 接続を許可する必要があります。

https://aka.ms/
https://azcliprod.blob.core.windows.net/

詳細については、Azure CLI トラブルシューティングガイドの「プロキシの背後にある作業を参照してください。

応答時間が遅い

64 ビット Azure CLI への Migrate に関するページを参照してください

PowerShell でタブ補完を有効にする

タブ補完 ("Azure CLI の補完機能" とも呼ばれます) は、ヒントを示したり、検出を有効にしたり、入力エントリを高速化したりするための入力の補完機能を提供します。 Tab キーを押すことによって、コマンド名、コマンドグループ名、パラメーターや特定のパラメーター値をコマンドラインに自動的に挿入できます。

タブ補完は、Azure Cloud Shell や、ほとんどの Linux ディストリビューションで既定で有効になります。 Azure CLI バージョン 2.49 以降では、PowerShell で Azure CLI のタブ補完を有効にできます。次の手順のようにします。

変数 $PROFILE に格納されているプロファイルを作成または編集します。最も簡単な方法は、PowerShell で notepad $PROFILE を実行することです。詳細については、プロファイルの作成方法とプロファイルと実行ポリシーのトピックを参照してください。

PowerShell プロファイルに次のコードを追加します。

Register-ArgumentCompleter -Native -CommandName az -ScriptBlock {
    param($commandName, $wordToComplete, $cursorPosition)
    $completion_file = New-TemporaryFile
    $env:ARGCOMPLETE_USE_TEMPFILES = 1
    $env:_ARGCOMPLETE_STDOUT_FILENAME = $completion_file
    $env:COMP_LINE = $wordToComplete
    $env:COMP_POINT = $cursorPosition
    $env:_ARGCOMPLETE = 1
    $env:_ARGCOMPLETE_SUPPRESS_SPACE = 0
    $env:_ARGCOMPLETE_IFS = "`n"
    $env:_ARGCOMPLETE_SHELL = 'powershell'
    az 2>&1 | Out-Null
    Get-Content $completion_file | Sort-Object | ForEach-Object {
        [System.Management.Automation.CompletionResult]::new($_, $_, "ParameterValue", $_)
    }
    Remove-Item $completion_file, Env:\_ARGCOMPLETE_STDOUT_FILENAME, Env:\ARGCOMPLETE_USE_TEMPFILES, Env:\COMP_LINE, Env:\COMP_POINT, Env:\_ARGCOMPLETE, Env:\_ARGCOMPLETE_SUPPRESS_SPACE, Env:\_ARGCOMPLETE_IFS, Env:\_ARGCOMPLETE_SHELL
}

メニューで使用可能なすべてのオプションを表示するには、PowerShell プロファイルに Set-PSReadlineKeyHandler -Key Tab -Function MenuComplete を追加します。

Azure CLI の更新

バージョン 2.11.0 以降の Azure CLI には、最新バージョンに更新するためのツール内コマンドが用意されています。

az upgrade

このコマンドを使用すると、インストールされているすべての拡張機能も既定で更新されます。 az upgrade オプションの詳細については、コマンドリファレンスページをご覧ください。 2.11.0 より前のバージョンの Azure CLI の場合は、「Azure CLI のインストール」の説明に従って再インストールすることで更新します。

ZIP 配布を使用している場合は、古いインストールフォルダーを削除し、新しいバージョンを ame の場所に展開してください。

64 ビット Azure CLI への移行

2.51.0 以降では、Azure CLI には 64 ビット MSI も用意されており、パフォーマンスを向上させるために推奨されます。

Azure CLI 64 ビットに移行するには、次の手順に従います:

az --version を実行して、現在の CLI バージョンとインストールされている拡張機能を確認します。
拡張機能を再インストールする必要があります。 32 ビットに戻す場合は、現在の拡張機能フォルダー %userprofile%\.azure\cliextensions の名前を変更してバックアップを実行することをお勧めします。このフォルダーは、拡張機能を再インストールすると自動的に作成されます。
「インストールまたは更新」の説明に従って、最新の 64 ビットインストーラーをダウンロードしてインストールします。 32 ビット MSI は自動的にアンインストールされます。
az extension add --name <extension> --version <version> を実行して拡張機能をインストールします。拡張機能を手動で再インストールしない場合は、Azure CLI によって、最初の使用時に拡張機能をインストールするように求められます。拡張機能のインストールの詳細については、「拡張機能をインストールする方法」をご覧ください。

移行後に問題が発生した場合は、64 ビットをアンインストールし、32 ビット MSI を再インストールできます。 32 ビット拡張機能フォルダーのバックアップを作成した場合は、変更後に拡張機能フォルダーを復元 (名前変更) してください。

アンインストール

Azure CLI が不要であると判断した場合は、アンインストールできます。アンインストールする前に、az feedback コマンドを使用して、どのような改善または修正が可能かをお知らせください。 Microsoft の目標は、Azure CLI のバグをなくし、使いやすいものにすることです。バグが見つかった場合は、GitHub で問題を報告していただきますよう、よろしくお願いいたします。

Windows の "アプリと機能" の一覧から Azure CLI をアンインストールします。アンインストールするには、次のようにします。

プラットフォーム	Instructions
Windows 11	[スタート] > [設定] > [アプリ] > [インストール済みアプリ]
Windows 10	アプリ>アプリと機能>>設定を開始する
Windows 8 および Windows 7	[スタート] > [コントロールパネル] > [プログラム] > [プログラムのアンインストール]

この画面に移動したら、プログラムの検索バーに "Azure CLI" と入力します。アンインストールするプログラムが "Microsoft CLI 2.0 for Azure" として一覧に表示されます。このアプリケーションを選択し、Uninstall ボタンを選択します。

[データを削除する]

Azure CLI を再インストールする予定がない場合は、C:\Users\<username>\.azure\msal_token_cache.bin または C:\Users\<username>\.azure\msal_token_cache.json からそのデータを削除します。

次のステップ

これで Windows に Azure CLI をインストールしたので、サインインするためのさまざまな方法について学習します。

Azure CLI を使用してサインインする

次の方法で共有

Windows での Azure CLI のインストール

インストールまたは更新

WinGet (Windows パッケージマネージャー)

Microsoft インストーラー (MSI)

最新バージョン

特定のバージョン

PowerShell を使用した Microsoft インストーラー (MSI)

特定のバージョン

Bash と PowerShell の構文の違い

ZIP パッケージ

最新バージョン

特定のバージョン

Azure CLI を実行する

インストールのトラブルシューティング

PATH 変数が設定されていません

プロキシによる接続のブロック

応答時間が遅い

PowerShell でタブ補完を有効にする

Azure CLI の更新

64 ビット Azure CLI への移行

アンインストール

[データを削除する]

次のステップ

その他のリソース

次の方法で共有

Windows での Azure CLI のインストール

インストールまたは更新

WinGet (Windows パッケージ マネージャー)

Microsoft インストーラー (MSI)

最新バージョン

特定のバージョン

PowerShell を使用した Microsoft インストーラー (MSI)

特定のバージョン

Bash と PowerShell の構文の違い

ZIP パッケージ

最新バージョン

特定のバージョン

Azure CLI を実行する

インストールのトラブルシューティング

PATH 変数が設定されていません

プロキシによる接続のブロック

応答時間が遅い

PowerShell でタブ補完を有効にする

Azure CLI の更新

64 ビット Azure CLI への移行

アンインストール

[データを削除する]

次のステップ

その他のリソース

WinGet (Windows パッケージマネージャー)