Azure CLI とは
Azure コマンド ライン インターフェイス (CLI) は、Azure に接続して Azure リソースに対して管理コマンドを実行するためのクロスプラットフォームのコマンド ライン ツールです。 これにより、対話型のコマンド ライン プロンプトを使用したターミナルまたはスクリプトを通じてコマンドを実行できます。
対話形式で使用するには、まずシェル (Windows 上では cmd.exe、Linux または macOS 上では Bash など) を起動し、シェルのプロンプトでコマンドを発行します。 反復的なタスクを自動化するには、選択したシェルのスクリプト構文を使用して、複数の CLI コマンドを 1 つのシェル スクリプトにまとめて、スクリプトを実行します。
Azure CLI は、Linux、Mac、または Windows のコンピューター上にローカルにインストールできます。 また、Azure Cloud Shell を介してブラウザーから使用したり、Docker コンテナー内から実行したりすることもできます。
現在のバージョン
Azure CLI の現在のバージョンは 2.46.0 です。 最新リリースについては、リリース ノートをご覧ください。 インストール済みのバージョンを見つけ、更新する必要があるかどうかを確認するには、az version を実行します。
データ コレクション
既定では、Azure CLI によって利用統計情報が収集されます。 Microsoft は、使用パターンの特定、一般的な問題の特定、および Azure CLI のエクスペリエンスの向上を目的として、収集されたデータを集計します。 Microsoft Azure CLI によって、プライベートまたは個人データが収集されることはありません。 たとえば、使用状況データは、成功率が低いコマンドなどの問題を特定し、Microsoft による作業の優先順位を決めるのに役立ちます。
このデータで得られる分析情報は貴重なものですが、Microsoft では使用状況データを送信したくないユーザーが存在することも理解しています。 az config set core.collect_telemetry=false コマンドを使用してデータ収集を無効にすることができます。 詳細については、「プライバシー ステートメント」もご覧ください。
環境を準備する
Azure CLI コマンドを実行する前に、環境をセットアップする必要があります。
Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。
CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。 詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。
ローカル インストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、Azure CLI でのサインインに関するページを参照してください。
初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。 拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。
az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。
Azure CLI の例
この記事では、次に対するさまざまな Azure CLI 例を示します。
- サブスクリプションの構文
- ロールの割り当ての構文
- PowerShell 構文
サブスクリプションの構文の例
Azure CLI の構文は、単純な reference name - command - parameter - parameter value パターンに従います。 たとえば、サブスクリプションの切り替えは、よくある一般的なタスクです。 その構文は次のとおりです。
az account set --subscription "my subscription name"
とても簡単なのがお分かりいただけたと思います。 Azure CLI を使用してサブスクリプションを操作し、管理グループを作成する方法の詳細については、Azure CLI でのサブスクリプションの管理に関する記事を参照してください。
ロールの割り当ての構文の例
Azure CLI の別の一般的な用途は、ロールの割り当ての管理です。
az role assignment create --assignee servicePrincipalName --role Reader --scope /subscriptions/mySubscriptionID/resourceGroups/myResourceGroupName
az role assignment delete --assignee userSign-inName --role Contributor
サービス プリンシパルおよびロールの割り当ての管理に関する詳細なチュートリアルについては、「Azure CLI で Azure サービス プリンシパルを作成する」を参照してください。
PowerShell 構文の比較
「適切なコマンド ライン ツールを選択する」に、Azure CLI と Azure PowerShell に重点を置いた tools と environments の差異についての説明があります。 これには、コマンドの対照比較も多数示されています。 次に 2 つの例を示します。
| コマンド | Azure CLI | Azure PowerShell |
|---|---|---|
| リソース グループの作成 | az group create --name <ResourceGroupName> --location eastus | New-AzResourceGroup -Name <ResourceGroupName> -Location eastus |
| Azure ストレージ アカウントを作成する | az storage account create --name <StorageAccountName> --resource-group <ResourceGroupName> --location eastus --sku Standard_LRS --kind StorageV2 | New-AzStorageAccount -Name <StorageAccountName> -ResourceGroupName <ResourceGroupName> -Location eastus -SkuName Standard_LRS -Kind StorageV2 |