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

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.57.0 です。 最新リリースについては、リリース ノートをご覧ください。 インストール済みのバージョンを見つけ、更新する必要があるかどうかを確認するには、az version を実行します。

インストールまたは更新

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

重要

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

最新バージョン

Azure CLI の最新のリリースをダウンロードしてインストールします。 インストーラーでコンピューターに変更を加えるかどうかを尋ねるメッセージが表示されたら、[はい] を選択します。

以前に Azure CLI をインストールしている場合は、32 ビットまたは 64 ビットの 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 から使用できます。

Azure CLI を実行する

これで、Windows コマンド プロンプトまたは PowerShell のいずれかから、az コマンドで Azure CLI を実行できるようになりました。

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

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

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

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

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

トラブルシューティング

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

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

プロキシにより接続がブロックされているため 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/

64 ビット Azure CLI への移行

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

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

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

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

Azure CLI の更新

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

az upgrade

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

ZIP ディストリビューションを使用している場合は、古いインストール フォルダーを削除し、同じ場所に新しいバージョンを抽出してください。

アンインストール

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 をインストールしたので、サインインするためのさまざまな方法について学習します。