Azure CLI の概要Get started with Azure CLI

Azure CLI へようこそ。Welcome to the Azure CLI! CLI は、Azure サービスを迅速かつ効率的に使用するためのツールで、オートメーションに重点が置されています。The CLI is a tool designed to get you working quickly and efficiently with Azure services, with an emphasis on automation. この記事では、CLI の機能と、生産性の向上に役立つリソースへのリンクを紹介します。This article introduces features of the CLI and links out to resources that help you be productive.

Azure Cloud Shell でのインストールまたは実行Install or run in Azure Cloud Shell

Azure CLI で作業を開始するには、お使いのブラウザーから Azure Cloud Shell 環境で実行するのが最も簡単です。The easiest way to get started with the Azure CLI is by running it in an Azure Cloud Shell environment through your browser. Cloud Shell については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。To learn about Cloud Shell, see Quickstart for Bash in Azure Cloud Shell.

CLI をインストールする準備ができたら、インストール手順に関するページをご覧ください。When you're ready to install the CLI, see the installation instructions.

初めて CLI をインストールしたら、az --version を実行して、CLI の正しいバージョンがインストールされていること確認します。After installing the CLI for the first time, check that it's installed and you've got the correct version by running az --version.

サインインSign in

ローカル インストールで CLI コマンドを使用する前に、az login でサインインする必要があります。Before using any CLI commands with a local install, you need to sign in with az login.

  1. login コマンドを実行します。Run the login command.

    az login
    

    CLI で既定のブラウザーを開くことができる場合、開いたブラウザにサインイン ページが読み込まれます。If the CLI can open your default browser, it will do so and load a sign-in page.

    それ以外の場合は、ブラウザー ページを開いて、お使いのブラウザーで https://aka.ms/devicelogin に移動した後、コマンド ラインの指示に従って認証コードを入力します。Otherwise, you need to open a browser page and follow the instructions on the command line to enter an authorization code after navigating to https://aka.ms/devicelogin in your browser.

  2. ブラウザーでアカウントの資格情報を使用してサインインします。Sign in with your account credentials in the browser.

ログインすると、ご使用のアカウントに関連付けられているサブスクリプションの一覧が表示されます。After logging in, you see a list of subscriptions associated with your Azure account. isDefault: true が示されているサブスクリプション情報が、ログイン後に、現在アクティブになっているサブスクリプションです。The subscription information with isDefault: true is the currently activated subscription after logging in. 別のサブスクリプションを選択するには、切り替え先のサブスクリプション ID を指定して az account set コマンドを実行します。To select another subscription, use the az account set command with the subscription ID to switch to. サブスクリプションの選択の詳細については、「複数の Azure サブスクリプションの使用」を参照してください。For more information about subscription selection, see Use multiple Azure subscriptions.

対話型以外のサインイン方法も用意されています。詳細については、「Azure CLI を使用してサインインする」を参照してください。There are ways to sign in non-interactively, which are covered in detail in Sign in with Azure CLI.

一般的なコマンドCommon commands

次の表は、CLI で使用される一般的なコマンドの一部を示しており、リファレンス ドキュメントにリンクされています。This table lists some common commands used in the CLI and links to their reference documentation.

リソースの種類Resource type Azure CLI コマンド グループAzure CLI command group
リソース グループResource group az groupaz group
仮想マシンVirtual machines az vmaz vm
ストレージ アカウントStorage accounts az storage accountaz storage account
Key VaultKey Vault az keyvaultaz keyvault
Web アプリケーションWeb applications az webappaz webapp
SQL データベースSQL databases az sql serveraz sql server
CosmosDBCosmosDB az cosmosdbaz cosmosdb

コマンドを見つけるFinding commands

CLI のコマンドは、"グループ" の "サブコマンド" として整理されています。Commands in the CLI are organized as commands of groups. 各グループは、Azure のサービスを表し、コマンドはそのサービスに対して動作します。Each group represents an Azure service, and commands operate on that service.

コマンドを検索するには、az find を使用します。To search for commands, use az find. たとえば、secret を含むコマンド名を検索するには、次のコマンドを使用します。For example, to search for command names containing secret, use the following command:

az find secret

コマンドと、グループのサブグループの完全な一覧を取得するには、--help 引数を使用します。Use the --help argument to get a complete list of commands and subgroups of a group. たとえば、ネットワーク セキュリティ グループ (NSG) で使用する CLI コマンドを確認するには、次のコマンドを使用します。For example, to find the CLI commands for working with Network Security Groups (NSGs):

az network nsg --help

CLI では Bash シェルにコマンドの完全タブ補完が用意されています。The CLI has full tab completion for commands under the bash shell.

グローバルに使用できる引数Globally available arguments

引数の中には、すべてのコマンドで使用できるものがあります。There are some arguments that are available for every command.

  • --help は、コマンドとその引数に関する CLI 参照情報を出力し、利用可能なサブグループとコマンドの一覧を表示します。--help prints CLI reference information about commands and their arguments and lists available subgroups and commands.
  • --output は出力形式を変更します。--output changes the output format. 使用可能な出力形式は jsonjsonc (色付けされた JSON)、tsv (タブ区切り値)、および table (人間が判読できる ASCII テーブル)、および yaml です。The available output formats are json, jsonc (colorized JSON), tsv (Tab-Separated Values), table (human-readable ASCII tables), and yaml. 既定では、CLI は json を出力します。By default the CLI outputs json. 使用可能な出力形式の詳細については、Azure CLI の出力形式に関するページをご覧ください。To learn more about the available output formats, see Output formats for Azure CLI.
  • --query は、JMESPath クエリ言語を使用して、Azure サービスから返された出力をフィルター処理します。--query uses the JMESPath query language to filter the output returned from Azure services. クエリの詳細については、Azure CLI でのコマンド結果に対するクエリの実行に関するページ、および「JMESPath tutorial (JMESPath チュートリアル)」を参照してください。To learn more about queries, see Query command results with Azure CLI and the JMESPath tutorial.
  • --verbose は、操作中に Azure で作成されたリソースに関する情報と、その他の有用な情報を出力します。--verbose prints information about resources created in Azure during an operation, and other useful information.
  • --debug は、デバッグの目的で使用する、CLI 操作に関する詳細情報を出力します。--debug prints even more information about CLI operations, used for debugging purposes. バグを見つけた場合は、バグ レポートを送信するときに、--debug フラグをオンにして生成した出力を提供してください。If you find a bug, provide output generated with the --debug flag on when submitting a bug report.

対話モードInteractive mode

CLI には対話モードが用意されています。このモードでは、ヘルプ情報が自動的に表示され、サブコマンドが選択しやすくなっています。The CLI offers an interactive mode that automatically displays help information and makes it easier to select subcommands. 対話モードには az interactive コマンドで切り替えます。You enter interactive mode with the az interactive command.

az interactive

対話モードの詳細については、Azure CLI 対話モードに関する記事をご覧ください。For more information on interactive mode, see Azure CLI Interactive Mode.

また、オートコンプリート、マウス オーバー ドキュメントなど、対話型エクスペリエンスを提供する Visual Studio Code プラグインも用意されています。There's also a Visual Studio Code plugin that offers an interactive experience, including autocomplete and mouse-over documentation.

クイックスタートとチュートリアルを利用して CLI の基本について学習するLearn CLI basics with quickstarts and tutorials

Azure CLI の使用を開始するには、詳細なチュートリアルをお試しください。チュートリアルでは、仮想マシンを設定し、CLI の機能を使用して Azure リソースにクエリを実行します。To get you started with the Azure CLI, try an in-depth tutorial for setting up virtual machines and using the power of the CLI to query Azure resources.

その他の人気のあるサービス用のクイック スタートもあります。There are also quickstarts for other popular services.

フィードバックを送るGive feedback

機能強化とバグ解決に活かすために、CLI に関する皆様のご意見をお待ちしております。We welcome your feedback for the CLI to help us make improvements and resolve bugs. GitHub で問題を報告するか、CLI の組み込み機能を使用して、az feedback コマンドで一般的なフィードバックをお寄せください。You can file an issue on GitHub or use the built-in features of the CLI to leave general feedback with the az feedback command.

az feedback