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 での手動インストール方法については、メインのインストール ページを参照してください。

Windows に Azure CLI をインストールするには、次の 4 つの方法があります。

• Microsoft インストーラー (MSI)
• PowerShell の Microsoft インストーラー (MSI)
• Windows パッケージ マネージャー
• ZIP パッケージ

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

インストールまたは更新

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

$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

winget install -e --id Microsoft.AzureCLI

Azure CLI を実行する

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

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

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

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

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

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

プロキシにより接続がブロックされているため MSI インストーラーをダウンロードできない場合、プロキシを正しく構成していることを確認します。 Windows 10 の場合、これらの設定は 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 への Migrate に関するページを参照してください

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 を追加します。

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 ビットに移行するには、次の手順に従います:

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

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

この画面に移動したら、プログラムの検索バーに "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 をインストールしたので、サインインするためのさまざまな方法について学習します。