WindowsにAzure CLIをインストールする

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

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

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

インストールまたは更新

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

winget install --exact --id Microsoft.AzureCLI

winget install --exact --id Microsoft.AzureCLI --version 2.67.0

$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

$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を実行する

インストール後、アクティブなターミナル ウィンドウを閉じてから再度開きます。 PowerShell または Windows コマンド プロンプトから az コマンドを使用してAzure CLIを実行します。

Azure CLIコマンドを実行する前に、Azureにサインインする必要があります。 対話形式でサインインするには、を使用します。 認証の詳細については、「 Azure CLIを参照してください。

az login

一般的な最初の手順は、アクティブなサブスクリプションを確認することです。

az account show

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

WindowsにAzure CLIをインストールするときに発生する一般的な問題を次に示します。 ここで説明していない問題が発生した場合は、GitHubで問題を解決してください。

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

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

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

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

(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 に移行するについて参照してください」

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

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

タブ補完は、Azure Cloud Shellおよびほとんどの Linux ディストリビューションで既定で有効になっています。 Azure CLI バージョン 2.49 以降では、PowerShell でAzure CLIのタブ補完を有効にすることができます。 次の手順に従います。

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

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 プロファイルに を追加します。

Azure CLIを更新する

バージョン 2.11.0 以降、Azure CLIは最新バージョンに更新するためのツール内コマンドを提供します。

az upgrade

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

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

64 ビット Azure CLIに移行する

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

64 ビット バージョンのAzure CLIに移行するには、次の手順に従います。

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

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

[アンインストール]

Azure CLIをアンインストールされると伺い、残念に思います。 アンインストールする前に、 コマンドを使用して、どのような改善または修正が可能かをお知らせください。 私たちの目標は、Azure CLIバグをなくし、ユーザーフレンドリーにすることです。 バグが見つかった場合は、GitHubの問題を報告。

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

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

[データを削除する]

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

次のステップ

WindowsにAzure CLIをインストールしたら、サインインのさまざまな方法について説明します。