az vm extension
VM에서 확장을 관리합니다.
확장은 Azure 가상 머신에서 배포 후 구성 및 자동화 작업을 제공하는 작은 애플리케이션입니다. 예를 들어 가상 머신에서 소프트웨어가 설치되도록 요구하거나, 바이러스 백신 보호 또는 Docker 구성을 요구하는 경우 VM 확장을 사용하여 이러한 작업을 완료할 수 있습니다. 확장을 새 가상 머신 배포와 번들로 제공하거나 기존 시스템에 대해 실행할 수 있습니다.
명령
| az vm extension delete |
VM에 연결된 확장을 제거합니다. |
| az vm extension image |
구독 및 지역에 사용할 수 있는 VM 확장을 찾습니다. |
| az vm extension image list |
사용 가능한 확장에 대 한 정보를 나열 합니다. |
| az vm extension image list-names |
사용 가능한 확장의 이름을 나열 합니다. |
| az vm extension image list-versions |
사용 가능한 확장에 대 한 버전을 나열 합니다. |
| az vm extension image show |
확장에 대 한 정보를 표시 합니다. |
| az vm extension list |
VM에 연결된 확장을 나열합니다. |
| az vm extension set |
VM에 대한 확장을 설정합니다. |
| az vm extension show |
VM에 연결된 확장에 대한 정보를 표시합니다. |
| az vm extension wait |
가상 머신 확장 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다. |
az vm extension delete
VM에 연결된 확장을 제거합니다.
az vm extension delete [--ids]
[--name]
[--no-wait]
[--resource-group]
[--subscription]
[--vm-name]
예제
VM 이름 및 확장을 사용하여 VM에서 확장을 삭제합니다.
az vm extension delete -g MyResourceGroup --vm-name MyVm -n extension_name
VM에서 "MyExtension" 문자열이 포함된 ID가 있는 확장을 삭제합니다.
az vm extension delete --ids \
$(az resource list --query "[?contains(name, 'MyExtension')].id" -o tsv)
선택적 매개 변수
하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
확장의 이름입니다.
장기 실행 작업이 완료될 때까지 기다리지 마세요.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.
Virtual Machine의 이름입니다. 를 사용하여 기본값을 구성할 수 az configure --defaults vm=<name> 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az vm extension list
VM에 연결된 확장을 나열합니다.
az vm extension list --resource-group
--vm-name
[--query-examples]
[--subscription]
예제
명명된 VM에 연결된 확장을 나열합니다.
az vm extension list -g MyResourceGroup --vm-name MyVm
필수 매개 변수
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
Virtual Machine의 이름입니다. 를 사용하여 기본값을 구성할 수 az configure --defaults vm=<name> 있습니다.
선택적 매개 변수
JMESPath 문자열을 권장합니다. 쿼리 중 하나를 복사하여 큰따옴표 안에 --query 매개 변수를 붙여넣어 결과를 볼 수 있습니다. 이러한 키워드를 기반으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az vm extension set
VM에 대한 확장을 설정합니다.
에서 확장 세부 정보를 az vm extension image list 가져옵니다.
az vm extension set --name
--publisher
[--enable-auto-upgrade {false, true}]
[--extension-instance-name]
[--force-update]
[--ids]
[--no-auto-upgrade {false, true}]
[--no-auto-upgrade-minor-version {false, true}]
[--no-wait]
[--protected-settings]
[--resource-group]
[--settings]
[--subscription]
[--version]
[--vm-name]
예제
Linux VM에 사용자 계정을 추가합니다.
az vm extension set -n VMAccessForLinux --publisher Microsoft.OSTCExtensions --version 1.4 \
--vm-name MyVm --resource-group MyResourceGroup \
--protected-settings '{"username":"user1", "ssh_key":"ssh_rsa ..."}'
--ids로 지정된 VM에 customScript 확장을 추가합니다.
az vm extension set -n customScript --publisher Microsoft.Azure.Extensions --ids {vm_id}
최신 버전의 확장을 사용할 수 있는 경우 확장을 추가하고 플랫폼에서 자동 업그레이드를 사용하도록 설정합니다.
az vm extension set -n extName --publisher publisher --vm-name MyVM -g MyResourceGroup \
--enable-auto-upgrade true
필수 매개 변수
확장의 이름입니다.
확장 게시자의 이름입니다.
선택적 매개 변수
사용 가능한 최신 버전의 확장이 있는 경우 플랫폼에서 확장을 자동으로 업그레이드해야 함을 나타냅니다.
사용자 지정할 수 있는 확장 인스턴스의 이름입니다. 기본값: 확장의 이름입니다.
확장 구성이 변경되지 않은 경우에도 강제로 업데이트합니다.
하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
설정된 경우 확장이 다시 배포되더라도 확장 서비스는 최신 부 버전을 자동으로 선택하거나 업그레이드하지 않습니다.
설정된 경우 확장이 다시 배포되더라도 확장 서비스는 최신 부 버전을 자동으로 선택하거나 업그레이드하지 않습니다.
장기 실행 작업이 완료될 때까지 기다리지 마세요.
자격 증명과 같은 중요한 정보에 대한 JSON 형식의 보호된 설정입니다. JSON 파일 경로도 허용됩니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
JSON 형식의 확장 설정입니다. JSON 파일 경로도 허용됩니다.
구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.
확장의 버전입니다. 확장 버전을 이 값에 고정하려면 --no-auto-upgrade-minor-version을 지정하세요.
Virtual Machine의 이름입니다. 를 사용하여 기본값을 구성할 수 az configure --defaults vm=<name> 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az vm extension show
VM에 연결된 확장에 대한 정보를 표시합니다.
az vm extension show [--expand]
[--ids]
[--name]
[--query-examples]
[--resource-group]
[--subscription]
[--vm-name]
예제
VM 이름 및 확장 이름을 사용하여 VM에 연결된 확장을 표시합니다.
az vm extension show -g MyResourceGroup --vm-name MyVm -n extension_name
선택적 매개 변수
작업에 적용할 확장 식입니다.
하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
확장의 이름입니다.
JMESPath 문자열을 권장합니다. 쿼리 중 하나를 복사하여 큰따옴표 안에 --query 매개 변수를 붙여넣어 결과를 볼 수 있습니다. 이러한 키워드를 기반으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.
Virtual Machine의 이름입니다. 를 사용하여 기본값을 구성할 수 az configure --defaults vm=<name> 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az vm extension wait
가상 머신 확장 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.
az vm extension wait [--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
[--vm-name]
예제
가상 머신 확장 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다. (자동 생성)
az vm extension wait --created --name MyExtension --resource-group MyResourceGroup --vm-name MyVm
가상 머신 확장 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다. (자동 생성)
az vm extension wait --exists --name MyExtension --resource-group MyResourceGroup --vm-name MyVm
가상 머신 확장 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다. (자동 생성)
az vm extension wait --ids @- --name MyExtension --subscription MySubscription --updated --vm-name MyVm
선택적 매개 변수
'Succeeded'에서 'provisioningState'를 통해 생성될 때까지 기다립니다.
조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예를 들어 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
삭제될 때까지 기다립니다.
리소스가 존재할 때까지 기다립니다.
작업에 적용할 확장 식입니다.
하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.
폴링 간격(초)입니다.
확장의 이름입니다.
리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.
구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.
최대 대기 시간(초)입니다.
'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.
Virtual Machine의 이름입니다. 를 사용 하 여 기본값을 구성할 수 있습니다 az configure --defaults vm=<name> .
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.