Azure CLI 시작

2025-05-22

Azure CLI는 명령줄에서 Azure 리소스 관리를 간소화하는 플랫폼 간 도구입니다. 자동화 및 사용 편의성을 위해 최적화된 이 솔루션은 Azure Resource Manager 모델과 원활하게 통합되는 간단한 명령으로 대화형 세션 및 스크립팅을 지원합니다. Azure Cloud Shell을 사용하여 브라우저에서 사용을 시작하거나 로컬로 설치하여 원하는 터미널에서 사용할 수 있습니다.

Azure Cloud Shell에서 설치 또는 실행

Azure CLI를 시도하는 가장 쉬운 방법은 설치 없이 브라우저 기반 셸인 Azure Cloud Shell을 사용하는 것입니다. Cloud Shell은 Bash 및 PowerShell을 지원하며 Azure CLI의 최신 버전이 미리 설치되어 있습니다.

Azure CLI를 로컬로 설치하려면 Azure CLI를 설치하는 방법을 참조하세요.

버전을 확인하려면 다음을 실행합니다.

az version

로컬 설치에서 Azure CLI를 사용하려면 먼저 로그인하십시오.

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

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

사용할 수 있는 웹 브라우저가 없거나 웹 브라우저가 열리지 않는 경우 디바이스 코드 흐름을 강제 적용 az login --use-device-code할 수 있습니다.
브라우저에서 계정 자격 증명으로 로그인합니다.

중요합니다

2025년 9월부터 Microsoft는 Azure CLI 및 기타 명령줄 도구에 대한 MFA(다단계 인증)를 요구합니다. 이 변경 내용은 Microsoft Entra ID 사용자 ID 에만 적용되며 서비스 주체 또는 관리 ID와 같은 워크로드 ID에는 영향을 주지 않습니다.

사용자 이름 및 암호를 사용하여 az login 스크립트 또는 자동화된 워크플로를 인증하는 경우 이제 워크로드 ID로 마이그레이션해야 합니다. 자세한 내용은 자동화 시나리오에서 다단계 인증이 Azure CLI에 미치는 영향을 참조하세요.

로그인하면 구독 목록이 나타납니다. 표시된 isDefault: true 것이 현재 활성화되어 있습니다. 다른 구독으로 변경하려면 다음을 실행합니다.

az account set --subscription "<subscription-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
    ...

모든 명령 그룹을 사전순으로 나열하는 참조 인덱 스 사용

샘플 및 문서 살펴보기

사용 예제는 다음을 참조하세요.

주체, 참조 그룹 또는 GitHub 리포지토리별 Azure CLI 예제에 대한 샘플 인덱스입니다.

자세한 가이드를 찾으려면 아티클 인덱스를 확인하세요. 원하는 참조 명령 그룹을 빠르게 찾으려면 find와 같은 바로 가기 키를 사용하세요. 예를 들어 아티클 인덱스가 az vm 다음 표와 같이 표시됩니다.

참조 하위 그룹	참조 사용을 보여 주는 Azure CLI 문서
az vm	Azure CLI 명령어의 출력 형식
	Azure CLI 명령에서 변수를 사용하는 방법
	쿼리를 사용하여 VM 정보 가져오기
	추가 문서가 여기에 나열되어 있습니다.
az vm aem	SAP 솔루션용 Azure VM 확장의 새 버전
	SAP 솔루션용 Azure VM 확장의 표준 버전
az vm application	{...}

탭 완성 사용

Azure CLI는 Bash에서 탭 완성을 지원합니다. PowerShell에서 사용하도록 설정하려면 PowerShell에서 탭 완성 사용을 참조하세요.

전역 인자 이해

대부분의 명령에서 사용할 수 있는 일반적인 인수는 다음과 같습니다.

논쟁	설명
`--help`	명령 도움말 보기
`--output`	출력 형식 변경: `json`, `jsonc`, `tsv`, `tableyaml`
`--query`	JMESPath를 사용하여 출력 필터링
`--verbose`	더 많은 실행 세부 정보 인쇄
`--debug`	디버깅에 대한 하위 수준 REST 호출 표시
`--subscription`	구독 이름 또는 ID 지정
`--only-show-errors`	비중요한 출력 억제

자세한 내용은 출력 형식 및 쿼리 결과를 참조하세요.

대화형 모드 사용

다음을 사용하여 대화형 모드를 실행합니다.

az interactive

대화형 모드는 인라인 도움말 및 명령 제안으로 향상된 Azure CLI 환경을 시작합니다. 자세한 내용은 대화형 모드를 참조하세요.

선택적 VS Code 확장은 자동 완성과 마우스를 올리면 표시되는 팁과 유사한 기능을 제공합니다.

자습서 및 빠른 시작을 통해 알아보기

온보딩 자습서를 사용하여 Azure CLI 기본 사항을 실습합니다. 당신은 다음을 배우게 됩니다:

비고

Microsoft Learn의 Azure CLI 예제는 Bash용으로 작성되었습니다. 간단한 명령어는 대개 셸에서 잘 작동하지만, 여러 줄로 구성된 스크립트는 조정이 필요할 수 있습니다. 자세한 내용은 Bash, PowerShell 및 Cmd의 구문 차이점을 참조하세요.

피드백 제공

여러분의 의견을 환영합니다. GitHub에서 문제를 제출하거나 다음을 실행합니다.

az feedback