다음을 통해 공유


az vm extension

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

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

명령

Name Description 형식 상태
az vm extension delete

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

Core GA
az vm extension image

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

Core GA
az vm extension image list

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

Core GA
az vm extension image list-names

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

Core GA
az vm extension image list-versions

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

Core GA
az vm extension image show

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

Core GA
az vm extension list

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

Core GA
az vm extension set

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

Core GA
az vm extension show

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

Core GA
az vm extension wait

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

Core GA

az vm extension delete

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

az vm extension delete [--ids]
                       [--name --vm-extension-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)

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

속성
Parameter group: Resource Id Arguments
--name --vm-extension-name -n

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

속성
Parameter group: Resource Id Arguments
--no-wait

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

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

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

속성
Parameter group: Resource Id Arguments
--subscription

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

속성
Parameter group: Resource Id Arguments
--vm-name

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

속성
Parameter group: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

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

--only-show-errors

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

속성
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

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

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

속성
Parameter group: Resource Id Arguments
--resource-group -g

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

속성
Parameter group: Resource Id Arguments
--subscription

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

속성
Parameter group: Resource Id Arguments
--vm-name

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

속성
Parameter group: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

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

--only-show-errors

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

속성
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

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

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

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--enable-auto-upgrade

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

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

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

--force-update

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

속성
Default value: False
--ids

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

속성
Parameter group: Resource Id Arguments
--no-auto-upgrade
사용되지 않음

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

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

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

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

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

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

속성
Default value: False
--protected-settings

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

--resource-group -g

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

속성
Parameter group: Resource Id Arguments
--settings

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

--subscription

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

속성
Parameter group: Resource Id Arguments
--version

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

--vm-name

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

속성
Parameter group: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

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

--only-show-errors

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

속성
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

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

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

속성
Parameter group: Resource Id Arguments
--instance-view

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

속성
Default value: False
--name -n

확장의 이름입니다.

속성
Parameter group: Resource Id Arguments
--resource-group -g

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

속성
Parameter group: Resource Id Arguments
--subscription

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

속성
Parameter group: Resource Id Arguments
--vm-name

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

속성
Parameter group: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

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

--only-show-errors

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

속성
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az vm extension wait

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

az vm extension wait [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--expand]
                     [--ids]
                     [--interval]
                     [--name --vm-extension-name]
                     [--resource-group]
                     [--subscription]
                     [--timeout]
                     [--updated]
                     [--vm-name]

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

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

속성
Parameter group: Wait Condition Arguments
Default value: False
--custom

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

속성
Parameter group: Wait Condition Arguments
--deleted

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

속성
Parameter group: Wait Condition Arguments
Default value: False
--exists

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

속성
Parameter group: Wait Condition Arguments
Default value: False
--expand

작업에 적용할 확장 식입니다.

--ids

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

속성
Parameter group: Resource Id Arguments
--interval

폴링 간격(초)입니다.

속성
Parameter group: Wait Condition Arguments
Default value: 30
--name --vm-extension-name -n

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

속성
Parameter group: Resource Id Arguments
--resource-group -g

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

속성
Parameter group: Resource Id Arguments
--subscription

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

속성
Parameter group: Resource Id Arguments
--timeout

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

속성
Parameter group: Wait Condition Arguments
Default value: 3600
--updated

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

속성
Parameter group: Wait Condition Arguments
Default value: False
--vm-name

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

속성
Parameter group: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

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

--only-show-errors

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

속성
Default value: False
--output -o

출력 형식

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

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

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False