다음을 통해 공유


az iot du instance

참고 항목

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

디바이스 업데이트 인스턴스 관리.

명령

Name Description 형식 상태
az iot du instance create

디바이스 업데이트 인스턴스를 만듭니다.

내선 번호 GA
az iot du instance delete

디바이스 업데이트 인스턴스를 삭제합니다.

내선 번호 GA
az iot du instance list

디바이스 업데이트 인스턴스를 나열합니다.

내선 번호 GA
az iot du instance show

디바이스 업데이트 인스턴스를 표시합니다.

내선 번호 GA
az iot du instance update

디바이스 업데이트 인스턴스를 업데이트합니다.

내선 번호 GA
az iot du instance wait

원하는 인스턴스 리소스 상태가 충족될 때까지 차단합니다.

내선 번호 GA

az iot du instance create

디바이스 업데이트 인스턴스를 만듭니다.

이 명령을 사용하여 기존 인스턴스의 상태를 업데이트할 수도 있습니다.

az iot du instance create --account
                          --instance
                          --iothub-ids
                          [--diagnostics-storage-id]
                          [--enable-diagnostics {false, true}]
                          [--no-wait]
                          [--resource-group]
                          [--tags]

예제

최소 구성을 사용하여 인스턴스를 만듭니다.

az iot du instance create -n {account_name} -i {instance_name} --iothub-ids {iothub_resource_id}

사용자가 제공한 스토리지 계정과 쌍을 이루는 진단을 사용하도록 설정된 인스턴스를 만듭니다. 태그를 포함합니다.

az iot du instance create -n {account_name} -i {instance_name} --iothub-ids {iothub_resource_id} --enable-diagnostics --diagnostics-storage-id {storage_account_resource_id} --tags a=b

필수 매개 변수

--account -n

디바이스 업데이트 계정 이름입니다. 를 사용하여 az config set defaults.adu_account=<name>기본 계정 이름을 구성할 수 있습니다.

--instance -i

디바이스 업데이트 인스턴스 이름입니다. 를 사용하여 az config set defaults.adu_instance=<name>기본 인스턴스 이름을 구성할 수 있습니다.

--iothub-ids

공간으로 구분된 IoT Hub 리소스 ID입니다.

선택적 매개 변수

--diagnostics-storage-id

사용자가 진단 로그 컬렉션에 사용할 스토리지 계정 리소스 ID를 제공했습니다.

--enable-diagnostics

진단 로그 수집을 사용하도록 설정합니다.

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

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

Default value: False
--resource-group -g

디바이스 업데이트 계정 리소스 그룹 이름입니다. az config set defaults.adu_group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--tags

리소스 태그. a=b c=d 형식의 키-값 쌍의 속성 모음입니다.

전역 매개 변수
--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 iot du instance delete

디바이스 업데이트 인스턴스를 삭제합니다.

az iot du instance delete --account
                          --instance
                          [--no-wait]
                          [--resource-group]
                          [--yes {false, true}]

예제

대상 계정과 연결된 인스턴스를 삭제합니다.

az iot du instance delete -n {account_name} -i {instance_name}

대상 계정과 연결된 인스턴스를 삭제하고 확인 프롬프트를 건너뜁니다.

az iot du instance delete -n {account_name} -i {instance_name} -y

필수 매개 변수

--account -n

디바이스 업데이트 계정 이름입니다. 를 사용하여 az config set defaults.adu_account=<name>기본 계정 이름을 구성할 수 있습니다.

--instance -i

디바이스 업데이트 인스턴스 이름입니다. 를 사용하여 az config set defaults.adu_instance=<name>기본 인스턴스 이름을 구성할 수 있습니다.

선택적 매개 변수

--no-wait

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

Default value: False
--resource-group -g

디바이스 업데이트 계정 리소스 그룹 이름입니다. az config set defaults.adu_group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--yes -y

사용자 프롬프트를 건너뜁니다. 작업 수락을 나타냅니다. 자동화 시나리오에 주로 사용됩니다. 기본값: false입니다.

허용되는 값: false, true
전역 매개 변수
--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 iot du instance list

디바이스 업데이트 인스턴스를 나열합니다.

az iot du instance list --account
                        [--resource-group]

예제

대상 계정과 연결된 인스턴스를 나열합니다.

az iot du instance list -n {account_name}

필수 매개 변수

--account -n

디바이스 업데이트 계정 이름입니다. 를 사용하여 az config set defaults.adu_account=<name>기본 계정 이름을 구성할 수 있습니다.

선택적 매개 변수

--resource-group -g

디바이스 업데이트 계정 리소스 그룹 이름입니다. az config set defaults.adu_group=<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 iot du instance show

디바이스 업데이트 인스턴스를 표시합니다.

az iot du instance show --account
                        --instance
                        [--resource-group]

예제

대상 계정과 연결된 인스턴스의 세부 정보를 표시합니다.

az iot du instance show -n {account_name} -i {instance_name}

필수 매개 변수

--account -n

디바이스 업데이트 계정 이름입니다. 를 사용하여 az config set defaults.adu_account=<name>기본 계정 이름을 구성할 수 있습니다.

--instance -i

디바이스 업데이트 인스턴스 이름입니다. 를 사용하여 az config set defaults.adu_instance=<name>기본 인스턴스 이름을 구성할 수 있습니다.

선택적 매개 변수

--resource-group -g

디바이스 업데이트 계정 리소스 그룹 이름입니다. az config set defaults.adu_group=<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 iot du instance update

디바이스 업데이트 인스턴스를 업데이트합니다.

현재 iotHubs, enableDiagnostics, diagnosticStorageProperties 및 태그와 같은 인스턴스 속성을 업데이트할 수 있습니다.

az iot du instance update --account
                          --instance
                          [--add]
                          [--force-string]
                          [--no-wait]
                          [--remove]
                          [--resource-group]
                          [--set]

예제

특정 인스턴스 태그 특성을 설정합니다.

az iot du instance update -n {account_name} -i {instance_name} --set tags.env='test'

진단을 사용하도록 설정하고 로그 수집에 대한 스토리지 계정을 구성합니다.

az iot du instance update -n {account_name} -i {instance_name} --set enableDiagnostics=true diagnosticStorageProperties.resourceId={storage_account_resource_id}

필수 매개 변수

--account -n

디바이스 업데이트 계정 이름입니다. 를 사용하여 az config set defaults.adu_account=<name>기본 계정 이름을 구성할 수 있습니다.

--instance -i

디바이스 업데이트 인스턴스 이름입니다. 를 사용하여 az config set defaults.adu_instance=<name>기본 인스턴스 이름을 구성할 수 있습니다.

선택적 매개 변수

--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>

Default value: []
--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

Default value: False
--no-wait

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

Default value: False
--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Default value: []
--resource-group -g

디바이스 업데이트 계정 리소스 그룹 이름입니다. az config set defaults.adu_group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>

Default value: []
전역 매개 변수
--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 iot du instance wait

원하는 인스턴스 리소스 상태가 충족될 때까지 차단합니다.

az iot du instance wait --account
                        --instance
                        [--created]
                        [--custom]
                        [--deleted]
                        [--exists]
                        [--interval]
                        [--resource-group]
                        [--timeout]
                        [--updated]

예제

대상 인스턴스가 삭제될 때까지 차단합니다.

az iot du instance wait -n {account_name} -i {instance_name} --deleted

필수 매개 변수

--account -n

디바이스 업데이트 계정 이름입니다. 를 사용하여 az config set defaults.adu_account=<name>기본 계정 이름을 구성할 수 있습니다.

--instance -i

디바이스 업데이트 인스턴스 이름입니다. 를 사용하여 az config set defaults.adu_instance=<name>기본 인스턴스 이름을 구성할 수 있습니다.

선택적 매개 변수

--created

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

Default value: False
--custom

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

--deleted

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

Default value: False
--exists

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

Default value: False
--interval

폴링 간격(초)입니다.

Default value: 30
--resource-group -g

디바이스 업데이트 계정 리소스 그룹 이름입니다. az config set defaults.adu_group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--timeout

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

Default value: 3600
--updated

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

Default value: False
전역 매개 변수
--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를 사용합니다.