다음을 통해 공유


az vm extension

VM에서 확장을 관리합니다.

확장은 Azure 가상 머신에서 배포 후 구성 및 자동화 작업을 제공하는 작은 애플리케이션입니다. 예를 들어 가상 머신에서 소프트웨어가 설치되도록 요구하거나, 바이러스 백신 보호 또는 Docker 구성을 요구하는 경우 VM 확장을 사용하여 이러한 작업을 완료할 수 있습니다. 확장을 새 가상 머신 배포와 함께 번들로 제공하거나 기존 시스템에 대해 실행할 수 있습니다.

명령

Name Description 형식 상태
az vm extension delete

확장을 삭제하는 작업을 삭제합니다.

핵심 GA
az vm extension image

구독 및 지역에 사용 가능한 VM 확장을 찾습니다.

핵심 GA
az vm extension image list

사용 가능한 확장에 대한 정보를 나열합니다.

핵심 GA
az vm extension image list-names

사용 가능한 확장의 이름을 나열합니다.

핵심 GA
az vm extension image list-versions

사용 가능한 확장의 버전을 나열합니다.

핵심 GA
az vm extension image show

확장에 대한 정보를 표시합니다.

핵심 GA
az vm extension list

VM에 연결된 확장을 나열합니다.

핵심 GA
az vm extension set

VM에 대한 확장을 설정합니다.

핵심 GA
az vm extension show

VM에 연결된 확장에 대한 정보를 표시합니다.

핵심 GA
az vm extension wait

가상 머신 확장 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

핵심 GA

az vm extension delete

확장을 삭제하는 작업을 삭제합니다.

az vm extension delete [--ids]
                       [--name]
                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                       [--resource-group]
                       [--subscription]
                       [--vm-name]

예제

VM 이름 및 확장을 사용하여 VM에서 확장을 삭제합니다.

az vm extension delete -g MyResourceGroup --vm-name MyVm -n MyExtensionName

VM에서 "MyExtension" 문자열이 포함된 ID를 사용하여 확장을 삭제합니다.

az vm extension delete --ids $(az resource list --query "[?contains(name, 'MyExtension')].id" -o tsv)

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name --vm-extension-name -n

가상 머신 확장의 이름입니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--vm-name

Virtual Machine의 이름입니다. 를 사용하여 az configure --defaults vm=<name>기본값을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az vm extension list

VM에 연결된 확장을 나열합니다.

az vm extension list [--ids]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

예제

명명된 VM에 연결된 확장을 나열합니다.

az vm extension list -g MyResourceGroup --vm-name MyVm

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--vm-name

Virtual Machine의 이름입니다. 를 사용하여 az configure --defaults vm=<name>기본값을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --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

필수 매개 변수

--name -n

확장의 이름입니다.

다음의 값: az vm extension image list
--publisher

확장 게시자의 이름입니다.

선택적 매개 변수

--enable-auto-upgrade

사용 가능한 최신 버전의 확장이 있는 경우 플랫폼에서 확장을 자동으로 업그레이드해야 함을 나타냅니다.

허용되는 값: false, true
--extension-instance-name

사용자 지정할 수 있는 확장 인스턴스의 이름입니다. 기본값: 확장의 이름입니다.

--force-update

확장 구성이 변경되지 않은 경우에도 강제로 업데이트합니다.

Default value: False
--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--no-auto-upgrade
사용되지 않음

옵션 '--자동 업그레이드 없음'은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 '--no-auto-upgrade-minor-version'을 사용합니다.

설정된 경우 확장이 다시 배포되더라도 확장 서비스가 자동으로 최신 부 버전을 선택하거나 업그레이드하지 않습니다.

허용되는 값: false, true
Default value: False
--no-auto-upgrade-minor-version

설정된 경우 확장이 다시 배포되더라도 확장 서비스가 자동으로 최신 부 버전을 선택하거나 업그레이드하지 않습니다.

허용되는 값: false, true
Default value: False
--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--protected-settings

자격 증명과 같은 중요한 정보에 대한 JSON 형식의 보호된 설정입니다. JSON 파일 경로도 허용됩니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--settings

JSON 형식의 확장 설정입니다. JSON 파일 경로도 허용됩니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--version

확장의 버전입니다. 확장 버전을 이 값에 고정하려면 --no-auto-upgrade-minor-version을 지정하세요.

--vm-name

Virtual Machine의 이름입니다. 를 사용하여 az configure --defaults vm=<name>기본값을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az vm extension show

VM에 연결된 확장에 대한 정보를 표시합니다.

az vm extension show [--ids]
                     [--instance-view]
                     [--name]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

예제

VM 이름 및 확장 이름을 사용하여 VM에 연결된 확장을 표시합니다.

az vm extension show -g MyResourceGroup --vm-name MyVm -n extension_name

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--instance-view

가상 머신 확장의 인스턴스 뷰입니다.

Default value: False
--name -n

확장의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--vm-name

Virtual Machine의 이름입니다. 를 사용하여 az configure --defaults vm=<name>기본값을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az vm extension wait

가상 머신 확장 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az vm extension wait [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--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

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

Default value: False
--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView. 상태es[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

Default value: False
--exists

리소스가 존재할 때까지 기다립니다.

Default value: False
--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--interval

폴링 간격(초)입니다.

Default value: 30
--name -n

확장의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--timeout

최대 대기 시간(초)입니다.

Default value: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

Default value: False
--vm-name

Virtual Machine의 이름입니다. 를 사용하여 az configure --defaults vm=<name>기본값을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.