다음을 통해 공유


az azurestackhci virtualmachine extension

참고 항목

이 참조는 Azure CLI(버전 2.15.0 이상)에 대한 azurestackhci 확장의 일부입니다. az azurestackhci virtualmachine extension 명령을 처음 실행할 때 확장 이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

명령 그룹 'azurestackhci'는 실험적이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

azurestackhci를 사용하여 virtualmachine 확장을 관리합니다.

명령

Name Description 형식 상태
az azurestackhci virtualmachine extension create

virtualmachine 확장을 만듭니다.

내선 번호 실험적
az azurestackhci virtualmachine extension delete

virtualmachine 확장을 삭제합니다.

내선 번호 실험적
az azurestackhci virtualmachine extension list

virtualmachine에 대한 모든 확장을 나열합니다.

내선 번호 실험적
az azurestackhci virtualmachine extension show

가상 캐싱 확장의 세부 정보를 가져옵니다.

내선 번호 실험적
az azurestackhci virtualmachine extension update

virtualmachine 확장을 업데이트합니다.

내선 번호 실험적
az azurestackhci virtualmachine extension wait

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

내선 번호 실험적

az azurestackhci virtualmachine extension create

실험적

명령 그룹 'azurestackhci'는 실험적이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

virtualmachine 확장을 만듭니다.

az azurestackhci virtualmachine extension create --name
                                                 --resource-group
                                                 --virtualmachine-name
                                                 [--auto-upgrade-minor {false, true}]
                                                 [--enable-auto-upgrade {false, true}]
                                                 [--extension-type]
                                                 [--force-update-tag]
                                                 [--inst-handler-version]
                                                 [--instance-view-type]
                                                 [--location]
                                                 [--protected-settings]
                                                 [--publisher]
                                                 [--settings]
                                                 [--status]
                                                 [--tags]
                                                 [--type-handler-version]

예제

PutExtension

az azurestackhci virtualmachine extension create --resource-group "test-rg" --location "West US2" --name "test-extension" --extension-type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings '{"commandToExecute":"hostname"}' --type-handler-version "1.10" --virtualmachine-name "test-virtualmachine"

필수 매개 변수

--name

확장의 이름입니다.

--resource-group -g

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

--virtualmachine-name

확장을 만들거나 업데이트해야 하는 virtualmachine의 이름입니다.

선택적 매개 변수

--auto-upgrade-minor

배포 시 사용할 수 있는 경우 확장에서 최신 부 버전을 사용해야 하는지 여부를 나타냅니다. 그러나 배포된 후에는 이 속성이 true로 설정되어 있더라도 재배포하지 않는 한 확장은 부 버전을 업그레이드하지 않습니다.

허용되는 값: false, true
--enable-auto-upgrade

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

허용되는 값: false, true
--extension-type

virtualmachine 확장의 형식을 지정합니다. 예는 CustomScriptExtension입니다.

--force-update-tag

확장 구성이 변경되지 않은 경우에도 확장 처리기를 강제로 업데이트해야 하는 방법입니다.

--inst-handler-version

스크립트 처리기의 버전을 지정합니다.

--instance-view-type

확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.

--location -l

위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--protected-settings

확장은 protected설정 또는 protected설정FromKeyVault 또는 보호된 설정을 전혀 포함할 수 없습니다. 예상 값: json-string/json-file/@json-file.

--publisher

virtualmachine 확장 처리기 게시자의 이름입니다.

--settings

가상 캐싱 확장에 대한 Json 형식의 공용 설정입니다.

--status

인스턴스 보기 상태.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--type-handler-version

스크립트 처리기의 버전을 지정합니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az azurestackhci virtualmachine extension delete

실험적

명령 그룹 'azurestackhci'는 실험적이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

virtualmachine 확장을 삭제합니다.

az azurestackhci virtualmachine extension delete [--ids]
                                                 [--name]
                                                 [--resource-group]
                                                 [--subscription]
                                                 [--virtualmachine-name]
                                                 [--yes]

예제

DeleteExtension

az azurestackhci virtualmachine extension delete --name "test-extension" --virtualmachine-name "test-virtualmachine" --resource-group "test-rg"

선택적 매개 변수

--ids

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

--name

컴퓨터 확장의 이름입니다.

--resource-group -g

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

--subscription

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

--virtualmachine-name

확장을 삭제해야 하는 가상 머신의 이름입니다.

--yes -y

확인 메시지를 표시하지 않습니다.

기본값: False
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az azurestackhci virtualmachine extension list

실험적

명령 그룹 'azurestackhci'는 실험적이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

virtualmachine에 대한 모든 확장을 나열합니다.

az azurestackhci virtualmachine extension list --resource-group
                                               --virtualmachine-name

예제

ListExtensions

az azurestackhci virtualmachine extension list --virtualmachine-name "test-virtualmachine" --resource-group "test-rg"

필수 매개 변수

--resource-group -g

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

--virtualmachine-name

확장을 포함하는 가상 머신의 이름입니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az azurestackhci virtualmachine extension show

실험적

명령 그룹 'azurestackhci'는 실험적이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

가상 캐싱 확장의 세부 정보를 가져옵니다.

az azurestackhci virtualmachine extension show [--ids]
                                               [--name]
                                               [--resource-group]
                                               [--subscription]
                                               [--virtualmachine-name]

예제

GetExtension

az azurestackhci virtualmachine extension show --name "test-extension" --virtualmachine-name "test-virtualmachine" --resource-group "test-rg"

선택적 매개 변수

--ids

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

--name

컴퓨터 확장의 이름입니다.

--resource-group -g

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

--subscription

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

--virtualmachine-name

확장을 포함하는 가상 머신의 이름입니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az azurestackhci virtualmachine extension update

실험적

명령 그룹 'azurestackhci'는 실험적이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

virtualmachine 확장을 업데이트합니다.

az azurestackhci virtualmachine extension update --name
                                                 [--auto-upgrade-minor {false, true}]
                                                 [--enable-auto-upgrade {false, true}]
                                                 [--extension-type]
                                                 [--force-update-tag]
                                                 [--ids]
                                                 [--protected-settings]
                                                 [--publisher]
                                                 [--resource-group]
                                                 [--settings]
                                                 [--subscription]
                                                 [--tags]
                                                 [--type-handler-version]
                                                 [--virtualmachine-name]

예제

UpdateExtension

az azurestackhci virtualmachine extension update --resource-group "test-rg" --name "test-extension" --extension-type "CustomScriptExtension" --virtualmachine-name "test-virtualmachine" --publisher "Microsoft.Compute" --settings '{"commandToExecute":"hostname"}' --type-handler-version "1.10"

필수 매개 변수

--name

확장의 이름입니다.

선택적 매개 변수

--auto-upgrade-minor

배포 시 사용할 수 있는 경우 확장에서 최신 부 버전을 사용해야 하는지 여부를 나타냅니다. 그러나 배포된 후에는 이 속성이 true로 설정되어 있더라도 재배포하지 않는 한 확장은 부 버전을 업그레이드하지 않습니다.

허용되는 값: false, true
--enable-auto-upgrade

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

허용되는 값: false, true
--extension-type

확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.

--force-update-tag

확장 구성이 변경되지 않은 경우에도 확장 처리기를 강제로 업데이트해야 하는 방법입니다.

--ids

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

--protected-settings

확장은 protected설정 또는 protected설정FromKeyVault 또는 보호된 설정을 전혀 포함할 수 없습니다. 예상 값: json-string/json-file/@json-file.

--publisher

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

--resource-group -g

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

--settings

확장에 대한 Json 형식의 공용 설정입니다. 예상 값: json-string/json-file/@json-file.

--subscription

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

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--type-handler-version

스크립트 처리기의 버전을 지정합니다.

--virtualmachine-name

확장을 포함하는 가상 머신의 이름입니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az azurestackhci virtualmachine extension wait

실험적

명령 그룹 'azurestackhci'는 실험적이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

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

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

예제

virtualmachine 확장이 성공적으로 생성될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az azurestackhci virtualmachine extension wait --name "test-extension" --virtualmachine-name "test-virtualmachine" --resource-group "test-rg" --created

virtualmachine 확장이 성공적으로 업데이트될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az azurestackhci virtualmachine extension wait --name "test-extension" --virtualmachine-name "test-virtualmachine" --resource-group "test-rg" --updated

virtualmachine 확장이 성공적으로 삭제될 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az azurestackhci virtualmachine extension wait --name "test-extension" --virtualmachine-name "test-virtualmachine" --resource-group "test-rg" --deleted

선택적 매개 변수

--created

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

기본값: False
--custom

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

--deleted

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

기본값: False
--exists

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

기본값: False
--ids

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

--interval

폴링 간격(초)입니다.

기본값: 30
--name

컴퓨터 확장의 이름입니다.

--resource-group -g

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

--subscription

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

--timeout

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

기본값: 3600
--updated

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

기본값: False
--virtualmachine-name

확장을 포함하는 가상 머신의 이름입니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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