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.

참고

스크립트 및 Microsoft 설명서 사이트에 작성된 Azure CLI 예제는 bash 셸용입니다.In scripts and on the Microsoft documentation site, Azure CLI examples are written for the bash shell. 한 줄 예제는 모든 플랫폼에서 실행됩니다.One-line examples will run on any platform. 연속하는 줄을 포함하는 더 긴 예제 (\) 또는 변수 할당은 PowerShell을 포함하여 다른 셸에서 작동하도록 수정해야 합니다.Longer examples which include line continuations (\) or variable assignment need to be modified to work on other shells, including PowerShell.

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는 기본 브라우저를 열 수 있으면 기본 브라우저를 열고 Azure 로그인 페이지를 로드합니다.If the CLI can open your default browser, it will do so and load an Azure sign-in page.

    그렇지 않으면 https://aka.ms/devicelogin에서 브라우저 페이지를 열고 터미널에 표시된 권한 부여 코드를 입력합니다.Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.

  2. 브라우저에서 계정 자격 증명으로 로그인합니다.Sign in with your account credentials in the browser.

로그인하면 Azure 계정에 연결된 구독 목록이 나타납니다.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 스토리지 계정az storage account
Key VaultKey Vault az keyvaultaz keyvault
웹 애플리케이션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. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 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 자습서를 참조하세요.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를 시작하려면 가상 머신 설정 및 Azure 리소스 쿼리를 위한 CLI 기능 사용에 대한 세부 자습서를 참조하십시오.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