다음을 통해 공유

az iot du instance

Note

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

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

명령

Name Description 형식 상태
az iot du instance create

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

 Extension GA
az iot du instance delete

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

 Extension GA
az iot du instance list

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

 Extension GA
az iot du instance show

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

 Extension GA
az iot du instance update

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

 Extension GA
az iot du instance wait

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

 Extension 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}사용하여 기본 계정 이름을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Account Identifier Arguments
--instance -i

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

속성 값
매개 변수 그룹: Account Identifier Arguments
--iothub-ids

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

속성 값
매개 변수 그룹: IoT Hub Arguments

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--diagnostics-storage-id

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

속성 값
매개 변수 그룹: Storage Arguments
--enable-diagnostics

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

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

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

속성 값
Default value: False
--resource-group -g

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

속성 값
매개 변수 그룹: Account Identifier Arguments
--tags

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

전역 매개 변수
--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/ 참조하세요.

--subscription

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

--verbose

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

속성 값
Default value: False

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}사용하여 기본 계정 이름을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Account Identifier Arguments
--instance -i

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

속성 값
매개 변수 그룹: Account Identifier Arguments

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--no-wait

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

속성 값
Default value: False
--resource-group -g

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

속성 값
매개 변수 그룹: Account Identifier Arguments
--yes -y

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

속성 값
허용되는 값: false, true
전역 매개 변수
--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/ 참조하세요.

--subscription

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

--verbose

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

속성 값
Default value: False

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}사용하여 기본 계정 이름을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Account Identifier Arguments

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--resource-group -g

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

속성 값
매개 변수 그룹: Account Identifier 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/ 참조하세요.

--subscription

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

--verbose

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

속성 값
Default value: False

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}사용하여 기본 계정 이름을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Account Identifier Arguments
--instance -i

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

속성 값
매개 변수 그룹: Account Identifier Arguments

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--resource-group -g

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

속성 값
매개 변수 그룹: Account Identifier 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/ 참조하세요.

--subscription

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

--verbose

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

속성 값
Default value: False

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}사용하여 기본 계정 이름을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Account Identifier Arguments
--instance -i

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

속성 값
매개 변수 그룹: Account Identifier Arguments

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--add

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

속성 값
매개 변수 그룹: Generic Update Arguments
Default value: []
--force-string

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

속성 값
매개 변수 그룹: Generic Update Arguments
Default value: False
--no-wait

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

속성 값
Default value: False
--remove

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

속성 값
매개 변수 그룹: Generic Update Arguments
Default value: []
--resource-group -g

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

속성 값
매개 변수 그룹: Account Identifier Arguments
--set

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

속성 값
매개 변수 그룹: Generic Update Arguments
Default value: []
전역 매개 변수
--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/ 참조하세요.

--subscription

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

--verbose

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

속성 값
Default value: False

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}사용하여 기본 계정 이름을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Account Identifier Arguments
--instance -i

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

속성 값
매개 변수 그룹: Account Identifier Arguments

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--created

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

속성 값
매개 변수 그룹: Wait Condition Arguments
Default value: False
--custom

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

속성 값
매개 변수 그룹: Wait Condition Arguments
--deleted

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

속성 값
매개 변수 그룹: Wait Condition Arguments
Default value: False
--exists

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

속성 값
매개 변수 그룹: Wait Condition Arguments
Default value: False
--interval

폴링 간격(초)입니다.

속성 값
매개 변수 그룹: Wait Condition Arguments
Default value: 30
--resource-group -g

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

속성 값
매개 변수 그룹: Account Identifier Arguments
--timeout

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

속성 값
매개 변수 그룹: Wait Condition Arguments
Default value: 3600
--updated

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

속성 값
매개 변수 그룹: Wait Condition Arguments
Default value: False
전역 매개 변수
--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/ 참조하세요.

--subscription

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

--verbose

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

속성 값
Default value: False