az iot hub configuration

참고

이 참조는 Azure CLI 대한 azure-iot 확장의 일부이며 버전 2.17.1 이상이 필요합니다. az iot hub configuration 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.

IoT 자동 디바이스 관리 구성을 대규모로 관리합니다.

명령

az iot hub configuration create

대상 IoT Hub IoT 자동 디바이스 관리 구성을 만듭니다.

az iot hub configuration delete

IoT 디바이스 구성을 삭제합니다.

az iot hub configuration list

IoT Hub IoT 자동 디바이스 관리 구성을 나열합니다.

az iot hub configuration show

IoT 자동 디바이스 관리 구성의 세부 정보를 가져옵니다.

az iot hub configuration show-metric

IoT 디바이스 구성에 정의된 대상 사용자 또는 시스템 메트릭을 평가합니다.

az iot hub configuration update

IoT 자동 디바이스 관리 구성의 지정된 속성을 업데이트합니다.

--set과 속성 할당을 사용하여 구성을 업데이트합니다.

참고: 구성 콘텐츠는 변경이 불가능합니다. 업데이트할 수 있는 구성 속성은 'labels', 'metrics', 'priority' 및 'targetCondition'입니다.

az iot hub configuration create

대상 IoT Hub IoT 자동 디바이스 관리 구성을 만듭니다.

구성 콘텐츠는 json이며 디바이스 또는 모듈 의도에 따라 약간 다릅니다.

디바이스 구성은 {"deviceContent":{...}} 형식입니다. 또는 {"content":{"deviceContent":{...}}}

모듈 구성은 {"moduleContent":{...}} 형식입니다. 또는 {"content":{"moduleContent":{...}}}

요청 시 평가에 대한 사용자 제공 메트릭을 사용하여 구성을 정의할 수 있습니다. 사용자 메트릭은 json이며 {"queries":{...}} 형식입니다. 또는 {"metrics":{"queries":{...}}}.

참고: 모듈의 대상 조건은 "from devices.modules where"로 시작해야 합니다.

az iot hub configuration create --config-id
                                --content
                                [--auth-type {key, login}]
                                [--hub-name]
                                [--lab]
                                [--login]
                                [--metrics]
                                [--pri]
                                [--resource-group]
                                [--target-condition]

예제

건물 9에서 디바이스에 태그가 지정되고 환경이 '테스트'인 조건에 적용되는 우선 순위가 3인 디바이스 구성을 만듭니다.

az iot hub configuration create -c {config_name} -n {iothub_name} --content device_content.json --target-condition "tags.building=9 and tags.environment='test'" --priority 3

레이블이 있는 디바이스 구성을 만들고 사용자 메트릭 인라인 제공(bash 구문 예제)

az iot hub configuration create -c {config_name} -n {iothub_name} --content device_content.json --target-condition "tags.building=9" --labels '{"key0":"value0", "key1":"value1"}' --priority 10 --metrics '{"metrics": {"queries": {"mymetric": "select deviceId from devices where tags.location='US'"}}}'

레이블이 있는 모듈 구성을 만들고 사용자 메트릭 인라인 제공(cmd 구문 예제)

az iot hub configuration create -c {config_name} -n {iothub_name} --content module_content.json --target-condition "from devices.modules where tags.building=9" --labels "{\"key0\":\"value0\", \"key1\":\"value1\"}" --metrics "{\"metrics\": {\"queries\": {\"mymetric\": \"select moduleId from devices.modules where tags.location='US'\"}}}"

콘텐츠 및 사용자 메트릭 인라인으로 모듈 구성 만들기(powershell 구문 예제)

az iot hub configuration create -c {config_name} -n {iothub_name} --content '{\"moduleContent\": {\"properties.desired.chillerWaterSettings\": {\"temperature\": 38, \"pressure\": 78}}}' --target-condition "from devices.modules where tags.building=9" --priority 1 --metrics '{\"metrics\": {\"queries\": {\"mymetric\":\"select moduleId from devices.modules where tags.location=''US''\"}}}'

필수 매개 변수

--config-id -c

대상 디바이스 구성 이름입니다.

--content -k

디바이스 구성 콘텐츠. 파일 경로 또는 원시 json을 제공합니다.

선택적 매개 변수

--auth-type

작업에서 정책 키를 자동으로 파생할지 또는 현재 Azure AD 세션을 사용해야 하는지를 나타냅니다. 를 사용하여 기본값을 구성할 수 az configure --defaults iothub-data-auth-type=<auth-type-value> 있습니다.

허용되는 값: key, login
기본값: key
--hub-name -n

IoT Hub 이름입니다.

--lab --labels

대상 구성에 적용할 레이블의 맵입니다. 형식 예제: {"key0":"value0", "key1":"value1"}.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.

--metrics -m

디바이스 구성 메트릭 정의. 파일 경로 또는 원시 json을 제공합니다.

--pri --priority

경쟁 규칙(가장 높은 승)의 경우 디바이스 구성의 가중치입니다.

--resource-group -g

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

--target-condition --tc -t

디바이스 구성이 적용되는 대상 조건입니다.

az iot hub configuration delete

IoT 디바이스 구성을 삭제합니다.

az iot hub configuration delete --config-id
                                [--auth-type {key, login}]
                                [--etag]
                                [--hub-name]
                                [--login]
                                [--resource-group]

필수 매개 변수

--config-id -c

대상 디바이스 구성 이름입니다.

선택적 매개 변수

--auth-type

작업에서 정책 키를 자동으로 파생할지 또는 현재 Azure AD 세션을 사용해야 하는지를 나타냅니다. 를 사용하여 기본값을 구성할 수 az configure --defaults iothub-data-auth-type=<auth-type-value> 있습니다.

허용되는 값: key, login
기본값: key
--etag -e

리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 ' * ' 값이 사용됩니다.

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.

--resource-group -g

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

az iot hub configuration list

IoT Hub IoT 자동 디바이스 관리 구성을 나열합니다.

az iot hub configuration list [--auth-type {key, login}]
                              [--hub-name]
                              [--login]
                              [--resource-group]
                              [--top]

선택적 매개 변수

--auth-type

작업에서 정책 키를 자동으로 파생할지 또는 현재 Azure AD 세션을 사용해야 하는지를 나타냅니다. 를 사용하여 기본값을 구성할 수 az configure --defaults iothub-data-auth-type=<auth-type-value> 있습니다.

허용되는 값: key, login
기본값: key
--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.

--resource-group -g

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

--top

반환할 최대 구성 수입니다. 기본적으로 모든 구성이 반환됩니다.

az iot hub configuration show

IoT 자동 디바이스 관리 구성의 세부 정보를 가져옵니다.

az iot hub configuration show --config-id
                              [--auth-type {key, login}]
                              [--hub-name]
                              [--login]
                              [--resource-group]

필수 매개 변수

--config-id -c

대상 디바이스 구성 이름입니다.

선택적 매개 변수

--auth-type

작업에서 정책 키를 자동으로 파생할지 또는 현재 Azure AD 세션을 사용해야 하는지를 나타냅니다. 를 사용하여 기본값을 구성할 수 az configure --defaults iothub-data-auth-type=<auth-type-value> 있습니다.

허용되는 값: key, login
기본값: key
--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.

--resource-group -g

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

az iot hub configuration show-metric

IoT 디바이스 구성에 정의된 대상 사용자 또는 시스템 메트릭을 평가합니다.

az iot hub configuration show-metric --config-id
                                     --metric-id
                                     [--auth-type {key, login}]
                                     [--hub-name]
                                     [--login]
                                     [--metric-type {system, user}]
                                     [--resource-group]

예제

사용자 정의 'warningLimit' 메트릭 평가

az iot hub configuration show-metric -m warningLimit -c {configuration_name} -n {iothub_name}

시스템 'appliedCount' 메트릭 평가

az iot hub configuration show-metric --metric-id appliedCount -c {configuration_name} -n {iothub_name} --metric-type system

필수 매개 변수

--config-id -c

대상 디바이스 구성 이름입니다.

--metric-id -m

평가를 위한 대상 메트릭입니다.

선택적 매개 변수

--auth-type

작업에서 정책 키를 자동으로 파생할지 또는 현재 Azure AD 세션을 사용해야 하는지를 나타냅니다. 를 사용하여 기본값을 구성할 수 az configure --defaults iothub-data-auth-type=<auth-type-value> 있습니다.

허용되는 값: key, login
기본값: key
--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.

--metric-type --mt

메트릭을 조회하는 데 사용해야 하는 메트릭 컬렉션을 나타냅니다.

허용되는 값: system, user
기본값: user
--resource-group -g

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

az iot hub configuration update

IoT 자동 디바이스 관리 구성의 지정된 속성을 업데이트합니다.

--set과 속성 할당을 사용하여 구성을 업데이트합니다.

참고: 구성 콘텐츠는 변경이 불가능합니다. 업데이트할 수 있는 구성 속성은 'labels', 'metrics', 'priority' 및 'targetCondition'입니다.

az iot hub configuration update --config-id
                                [--add]
                                [--auth-type {key, login}]
                                [--etag]
                                [--force-string]
                                [--hub-name]
                                [--login]
                                [--remove]
                                [--resource-group]
                                [--set]

예제

디바이스 구성의 우선 순위 변경 및 대상 조건 업데이트

az iot hub configuration update -c {configuration_name} -n {iothub_name} --set priority=10 targetCondition="tags.building=43 and tags.environment='dev'"

필수 매개 변수

--config-id -c

대상 디바이스 구성 이름입니다.

선택적 매개 변수

--add

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

--auth-type

작업에서 정책 키를 자동으로 파생할지 또는 현재 Azure AD 세션을 사용해야 하는지를 나타냅니다. 를 사용하여 기본값을 구성할 수 az configure --defaults iothub-data-auth-type=<auth-type-value> 있습니다.

허용되는 값: key, login
기본값: key
--etag -e

리소스의 마지막 상태에 해당하는 Etag 또는 엔터티 태그입니다. etag가 제공되지 않으면 ' * ' 값이 사용됩니다.

--force-string

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

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원합니다. "az login"을 통해 세션 로그인을 방지하려면 를 사용합니다. 엔터티 연결 문자열과 이름이 둘 다 제공되면 연결 문자열이 우선합니다.

--remove

목록에서 속성 또는 요소를 제거합니다. 예:--속성을 제거 합니다. 목록 또는--propertyToRemove을 제거 합니다.

--resource-group -g

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

--set

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