Azure CLI 시작

Azure CLI(명령줄 인터페이스)에 오신 것을 환영합니다! 이 문서에서는 CLI를 소개하고 일반적인 작업을 완료하도록 도와줍니다.

참고

스크립트 및 Microsoft 설명서 사이트에 작성된 Azure CLI 예제는 bash 셸용입니다. 한 줄 예제는 모든 플랫폼에서 실행됩니다. 연속하는 줄을 포함하는 더 긴 예제 (\) 또는 변수 할당은 PowerShell을 포함하여 다른 셸에서 작동하도록 수정해야 합니다.

Azure Cloud Shell에서 설치 또는 실행

Azure CLI를 사용하는 방법을 알아보는 가장 쉬운 방법은 브라우저를 통해 Azure Cloud Shell 환경에서 실행하는 것입니다. Cloud Shell에 대해 자세히 알아보려면 Azure Cloud Shell의 Bash에 대한 빠른 시작을 참조하세요.

CLI를 설치할 준비가 되었으면 설치 지침을 참조하세요.

CLI가 처음으로 설치되면 az --version을 실행하여 CLI가 설치되어 있고 올바른 버전인지 확인합니다.

참고

Azure 클래식 배포 모델을 사용하는 경우 Azure클래식 CLI를 설치합니다.

Azure CLI에 로그인하는 방법

로컬 설치에서 Azure CLI 명령을 사용하려면 먼저 az login을 사용하여 로그인해야 합니다.

  1. login 명령을 실행합니다.

    az login
    

    CLI는 기본 브라우저를 열 수 있으면 기본 브라우저를 열고 Azure 로그인 페이지를 로드합니다.

    그렇지 않으면 https://aka.ms/devicelogin에서 브라우저 페이지를 열고 터미널에 표시된 권한 부여 코드를 입력합니다.

    웹 브라우저를 사용할 수 없거나 웹 브라우저가 열리지 않으면 az login --use-device-code 와 함께 디바이스 코드 흐름을 사용합니다.

  2. 브라우저에서 계정 자격 증명으로 로그인합니다.

로그인하면 Azure 계정에 연결된 구독 목록이 나타납니다. isDefault: true가 있는 구독 정보는 로그인한 후 현재 활성화된 구독입니다. 다른 구독을 선택하려면 전환할 구독 ID와 함께 az account set 명령을 사용합니다. 구독 선택에 대한 자세한 내용은 여러 Azure 구독 사용을 참조하세요.

비 대화형으로 로그인할 수 있는 방법도 여러 가지가 있으며, 이는 Azure CLI에 로그인에서 자세히 설명됩니다.

공통 Azure CLI 명령

이 표에는 CLI 및 해당 참조 설명서에 대한 링크에 사용되는 몇 가지 일반적인 명령이 나열되어 있습니다.

리소스 종류 Azure CLI 명령 그룹
리소스 그룹 az group
가상 머신 az vm
스토리지 계정 az storage account
Key Vault az keyvault
웹 애플리케이션 az webapp
SQL 데이터베이스 az sql server
CosmosDB az cosmosdb

명령 찾기

Azure CLI 명령은 그룹명령 으로 구성됩니다. 각 그룹은 Azure 서비스를 나타내며, 명령은 해당 서비스에서 작동합니다.

명령을 검색하려면 az find를 사용합니다. 예를 들어 이름에 secret이(가) 포함된 명령을 검색하려면 다음 명령을 사용합니다.

az find secret

--help 인수를 사용하여 명령 및 그룹의 하위 그룹의 전체 목록을 가져옵니다. 예를 들어, 네트워크 보안 그룹(NSG)을 사용하는 작업에 대한 CLI 명령을 찾으려면 다음을 수행합니다.

az network nsg --help

CLI에는 Bash 셸에서 명령에 대한 전체 탭 완성 기능이 포함됩니다.

전역으로 사용 가능한 인수

일부 인수는 모든 명령에 사용할 수 있습니다.

  • --help은(는) 명령 및 해당 인수에 대한 CLI 참조 정보를 출력하고 사용 가능한 하위 그룹 및 명령을 나열합니다.
  • --output은(는) 출력 형식을 변경합니다. 사용 가능한 출력 형식은 json, jsonc(색이 지정된 JSON), tsv(탭으로 구분된 값), table(사람이 읽을 수 있는 ASCII 테이블) 및 yaml입니다. 기본적인 CLI 출력은 json입니다. 사용 가능한 출력 형식에 대해 자세히 알아보려면 Azure CLI의 출력 형식을 참조하십시오.
  • --query은(는) JMESPath 쿼리 언어를 사용하여 Azure 서비스에서 반환되는 출력을 필터링합니다. 쿼리에 대한 자세한 내용은 Azure CLI를 사용한 쿼리 명령 결과JMESPath 자습서를 참조하세요.
  • --verbose은(는) 작업 중 Azure에서 생성되는 리소스에 대한 정보 및 기타 유용한 정보를 출력합니다.
  • --debug은(는) 디버깅 목적으로 사용되는 CLI 작업에 대한 자세한 정보를 출력합니다. 버그가 발견된 경우, 버그 보고서를 제출할 때 --debug 플래그를 사용해서 생성된 출력을 제공하십시오.

대화형 모드

CLI는 도움말 정보를 자동으로 표시하고 하위 명령을 더 쉽게 선택할 수 있게 해주는 대화형 모드를 제공합니다. 대화형 모드로 전환하려면 az interactive 명령을 사용합니다.

az interactive

대화형 모드에 대한 자세한 내용은 Azure CLI 대화형 모드를 참조하십시오.

또한 자동 완성 및 마우스를 위로 가져갈 때 표시되는 설명을 포함하여 대화형 환경을 제공하는 Visual Studio Code 플러그인도 있습니다.

퀵 스타트 및 자습서로 CLI 기본 내용 학습

Azure CLI 시작 방법을 알아보려면 가상 머신을 설정하고 Azure 리소스를 쿼리하기 위해 CLI의 기능을 사용하기 위한 세부 자습서를 참조하세요.

다른 인기 있는 서비스에 대한 빠른 시작도 있습니다.

피드백 보내기

CLI 기능 개선 및 버그 해결을 위해 피드백을 보내주시기 바랍니다. GitHub에서 문제를 제출하거나 CLI의 기본 제공 기능을 사용하여 az feedback 명령을 통해 일반적인 피드백을 남길 수 있습니다.

az feedback

참고 항목