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]
                       [--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)

선택적 매개 변수

--ids

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

--name -n

확장의 이름입니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--resource-group -g

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

--vm-name

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

az vm extension list

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

az vm extension list --resource-group
                     --vm-name

예제

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

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

필수 매개 변수

--resource-group -g

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

--vm-name

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

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]
                    [--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

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

--ids

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

--no-auto-upgrade

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

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

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

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

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--protected-settings

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

--resource-group -g

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

--settings

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

--version

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

--vm-name

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

az vm extension show

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

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

예제

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

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

선택적 매개 변수

--expand

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

--ids

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

--instance-view

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

--name -n

확장의 이름입니다.

--resource-group -g

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

--vm-name

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

az vm extension wait

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

az vm extension wait [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--expand]
                     [--ids]
                     [--interval]
                     [--name]
                     [--resource-group]
                     [--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'를 사용하여 생성될 때까지 기다립니다.

--custom

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

--deleted

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

--exists

리소스가 있을 때까지 기다립니다.

--expand

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

--ids

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

--interval

폴링 간격(초)입니다.

기본값: 30
--name -n

확장의 이름입니다.

--resource-group -g

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

--timeout

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

기본값: 3600
--updated

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

--vm-name

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