다음을 통해 공유


Azure CLI 시작

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

Azure Cloud Shell에서 설치 또는 실행

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

Azure CLI를 설치할 준비가 되면 Windows, Linux, macOS 및 Docker 컨테이너에 대한 설치 지침을 참조하세요. Azure 클래식 배포 모델을 사용하는 경우 Azure 클래식 CLI를 설치합니다.

를 실행 az --version하여 버전을 확인합니다. Azure Cloud Shell에는 항상 최신 버전의 Azure CLI가 미리 설치되어 있습니다.

az version

Azure CLI에 로그인

로컬 설치와 함께 Azure CLI 명령을 사용하기 전에 az login으로 로그인해야 합니다.

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

    az login
    

    Azure CLI가 기본 브라우저를 열 수 있는 경우 권한 부여 코드 흐름을 시작하고 기본 브라우저를 열어 Azure 로그인 페이지를 로드합니다.

    그렇지 않으면 디바이스 코드 흐름을 시작하고 브라우저 페이지를 https://aka.ms/devicelogin열도록 지시합니다. 그런 다음 터미널에 표시되는 코드를 입력합니다.

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

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

로그인한 후 Azure 계정과 연결된 구독 목록을 받게 됩니다. isDefault: true가 있는 구독 정보는 로그인한 후 현재 활성화된 구독입니다. 다른 구독을 선택하려면 az account set 명령을 원하는 계정의 구독 ID와 함께 사용합니다. 구독 선택에 대한 자세한 내용은 Azure 구독 관리를 참조 하세요.

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

명령 찾기

Azure CLI 명령은 명령 그룹으로 구성됩니다. 각 그룹은 Azure 서비스의 영역을 나타냅니다. 명령 그룹을 찾는 두 가지 옵션이 있습니다.

  • az find 명령을 사용합니다. 예를 들어 포함된 vm명령 이름을 검색하려면 다음 명령을 사용합니다.

    az find vm
    
  • 인수를 --help 사용하여 참조 그룹 내에서 하위 그룹의 전체 목록을 가져옵니다. 이 예제에서는 가상 머신에 대한 모든 하위 그룹을 반환합니다.

    az vm --help
    

    다음은 간결성을 위해 생략된 줄이 있는 출력 예제입니다.

    Subgroups:
      application            : Manage applications for VM.
      availability-set       : Group resources into availability sets.
      boot-diagnostics       : Troubleshoot the startup of an Azure Virtual Machine.
      ...
    

    가상 머신을 가용성 집합으로 그룹화하기 위한 Azure CLI 명령을 찾는 또 다른 예는 az vm다음과 같습니다.

    az vm availability-set --help
    

    또한 참조 명령에 대한 매개 변수 목록 및 명령 예제를 가져오는 데 사용합니다--help.

    az vm create --help
    

    다음은 간결성을 위해 생략된 줄이 있는 출력 예제입니다.

    Arguments
        --name  [Required] : Name of the virtual machine.
        ...
    Authentication Arguments
        --admin-password   : Password for the VM if authentication type is 'Password'.
        --admin-username   : Username for the VM...
        ...
    Managed Service Identity Arguments
        ...
    Examples
        Create a VM from a custom managed image.
          az vm create -g MyResourceGroup -n MyVm --image MyImage
        ...
    
  • 모든 명령 그룹을 사전순으로 나열하는 A-Z 참조 인덱스 사용

게시된 샘플 및 문서 찾기

테스트된 게시된 예제를 확인하여 Azure CLI 구문을 알아보려는 경우 아티클 콘텐츠의 두 가지 인덱스가 있습니다.

탭 완성 사용

CLI에는 Bash 환경의 명령에 대한 전체 탭 완성이 있습니다. PowerShell 환경에서 탭 완성을 사용하도록 설정하려면 PowerShell에서 탭 완성 사용을 참조하세요.

전역적으로 사용 가능한 인수에 유의하세요.

대부분의 명령에 사용할 수 있는 몇 가지 인수가 있습니다.

  • --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 플래그를 사용해서 생성된 출력을 제공하십시오. 예를 들어 실행된 명령이 아래에서 호출하는 REST API와 서비스에서 받은 응답을 식별하는 데 사용할 수 있습니다.

  • --subscription 는 구독의 이름 또는 ID입니다. 기본 구독을 설정하는 방법에 대한 자세한 내용은 Azure CLI를 사용하여 Azure 구독 관리를 참조하세요.

  • --only-show-errors 명령 출력에서 경고를 표시하지 않으며 오류만 표시합니다.

대화형 모드 사용

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

az interactive

대화형 모드에 대한 자세한 내용은 대화형 모드에서 Azure CLI 실행을 참조 하세요.

자동 완성 및 마우스 오버 설명서를 포함하여 대화형 환경을 제공하는 Visual Studio Code 플러그 인있습니다.

빠른 시작 및 자습서를 사용하여 Azure CLI 기본 사항 알아보기

Azure CLI를 사용하는 방법을 알아보려면 Azure Storage를 사용하는 동안 다음 기술을 설명하는 온보딩 자습서를 사용해 보세요.

참고 항목

스크립트 및 Microsoft 설명서 사이트에서 Azure CLI 예제는 Bash 셸용으로 작성됩니다. 대부분의 한 줄 예제는 모든 플랫폼에서 실행됩니다. 줄 연속(\), 변수 할당 또는 따옴표를 포함하는 긴 예제는 PowerShell을 비롯한 다른 셸에서 작동하도록 수정해야 합니다. 환경 간의 구문 차이에 대한 자세한 내용은 Bash, PowerShell 및 Cmd 간의 구문 차이점을 참조하세요.

피드백 보내기

향상된 기능과 버그를 해결하는 데 도움이 되는 CLI에 대한 피드백을 환영합니다. GitHub에 문제를 제출하거나 CLI의 기본 제공 기능을 사용하여 az feedback 명령을 사용하여 일반적인 피드백을 남길 수 있습니다.

az feedback

참고 항목