az iot edge deployment

참고

이 참조는 Azure CLI에 대 한 azure iot 확장의 일부 이며 버전 2.0.70 이상 이어야 합니다. Az iot edge 배포 명령을 처음 실행할 때 확장이 자동으로 설치 됩니다. 확장에 대해 자세히 알아보세요 .

대규모로 IoT Edge 배포를 관리 합니다.

명령

az iot edge deployment create

대상 IoT Hub에서 IoT Edge 배포를 만듭니다.

az iot edge deployment delete

IoT Edge 배포를 삭제 합니다.

az iot edge deployment list

IoT Hub에서 IoT Edge 배포를 나열 합니다.

az iot edge deployment show

IoT Edge 배포에 대 한 세부 정보를 가져옵니다.

az iot edge deployment show-metric

IoT Edge 배포에 정의 된 대상 시스템 메트릭을 평가 합니다.

az iot edge deployment update

IoT Edge 배포의 지정 된 속성을 업데이트 합니다.

배포를 업데이트 하기 위해--set 다음에 속성 할당을 사용 합니다.

참고: IoT Edge 배포 콘텐츠를 변경할 수 없습니다. 업데이트할 수 있는 배포 속성은 ' 레이블 ', ' 메트릭 ', ' 우선 순위 ' 및 ' targetCondition '입니다.

az iot edge deployment create

대상 IoT Hub에서 IoT Edge 배포를 만듭니다.

배포 콘텐츠는 {"modulesContent": {...}} 형식의 json입니다. 또는 {"content": {"modulesContent": {...}}}.

요청 시 평가를 위해 사용자 정의 메트릭을 사용 하 여에 지 배포를 만들 수 있습니다. 사용자 메트릭은 json 이며 {"queries": {...}} 형식입니다. 또는 {"메트릭": {"queries": {...}}}.

az iot edge deployment create --content
                              --deployment-id
                              [--hub-name]
                              [--lab]
                              [--layered {false, true}]
                              [--login]
                              [--metrics]
                              [--no-validation {false, true}]
                              [--pri]
                              [--resource-group]
                              [--target-condition]

예제

' 빌딩 9 '의 장치에 적용 되는 레이블 (bash 구문 예제) 및 환경이 ' 테스트 ' 인 배포를 만듭니다.

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content modules_content.json --labels '{"key0":"value0", "key1":"value1"}' --target-condition "tags.building=9 and tags.environment='test'" --priority 3

' Dev ' 환경으로 태그가 지정 된 장치에 적용 되는 레이블 (powershell 구문 예제)을 사용 하 여 배포를 만듭니다.

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content modules_content.json --labels "{'key':'value'}" --target-condition "tags.environment='dev'"

' Dev ' 환경으로 태그가 지정 된 장치에 적용 되는 계층화 된 배포를 만듭니다. 사용자 메트릭과 모듈 콘텐츠가 모두 인라인으로 정의 되었습니다 (powershell 구문 예제).

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content "{'modulesContent':{'`$edgeAgent':{'properties.desired.modules.mymodule0':{ }},'`$edgeHub':{'properties.desired.routes.myroute0':'FROM /messages/* INTO `$upstream'}}}" --target-condition "tags.environment='dev'" --priority 10 --metrics "{'queries':{'mymetrik':'SELECT deviceId from devices where properties.reported.lastDesiredStatus.code = 200'}}" --layered

' 빌딩 9 ' 및 ' test ' 환경에서 장치에 적용 되는 계층화 된 배포를 만듭니다. 사용자 메트릭과 모듈 콘텐츠가 모두 인라인으로 정의 됩니다 (bash 구문 예제).

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content '{"modulesContent":{"$edgeAgent":{"properties.desired.modules.mymodule0":{ }},"$edgeHub":{"properties.desired.routes.myroute0":"FROM /messages/* INTO $upstream"}}}' --target-condition "tags.building=9 and tags.environment='test'" --metrics '{"queries":{"mymetrik":"SELECT deviceId from devices where properties.reported.lastDesiredStatus.code = 200"}}' --layered

' 빌딩 9 ' 및 ' test ' 환경에서 장치에 적용 되는 계층화 된 배포를 만듭니다. 사용자 메트릭과 모듈 콘텐츠는 모두 파일에서 정의 됩니다.

az iot edge deployment create -d {deployment_name} -n {iothub_name} --content layered_modules_content.json --target-condition "tags.building=9 and tags.environment='test'" --metrics metrics_content.json --layered

필수 매개 변수

--content -k

배포 콘텐츠를 IoT Edge 합니다. 파일 경로 또는 원시 json을 제공 합니다.

--deployment-id -d

대상 배포 이름입니다.

선택적 매개 변수

--hub-name -n

IoT Hub 이름입니다.

--lab --labels

대상 배포에 적용할 레이블의 맵입니다. ' {"Key0": "value0", "key1": "value1"} ' 형식을 사용 하세요.

--layered

계층화 된 배포를 사용 하면 기본 배포 위에 계층화 되는 $edgeAgent, $edgeHub 및 사용자 모듈에서 원하는 속성을 정의할 수 있습니다. 예를 들어 계층화 된 배포에 지정 된 경로는 기본 배포의 경로와 병합 됩니다. 배포 우선 순위에 따라 이름이 같은 경로를 덮어씁니다.

허용되는 값: false, true
--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--metrics -m

배포 메트릭 정의를 IoT Edge 합니다. 파일 경로 또는 원시 json을 제공 합니다.

--no-validation

Edge 배포 만들기에 대 한 클라이언트 쪽 스키마 유효성 검사를 사용 하지 않도록 설정 합니다.

허용되는 값: false, true
--pri --priority

경쟁 하는 규칙의 경우 배포 가중치 (가장 높은 우선 순위)

--resource-group -g

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

--target-condition --tc -t

에 지 배포가 적용 되는 대상 조건입니다.

az iot edge deployment delete

IoT Edge 배포를 삭제 합니다.

az iot edge deployment delete --deployment-id
                              [--etag]
                              [--hub-name]
                              [--login]
                              [--resource-group]

필수 매개 변수

--deployment-id -d

대상 배포 이름입니다.

선택적 매개 변수

--etag -e

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

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--resource-group -g

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

az iot edge deployment list

IoT Hub에서 IoT Edge 배포를 나열 합니다.

az iot edge deployment list [--hub-name]
                            [--login]
                            [--resource-group]
                            [--top]

선택적 매개 변수

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--resource-group -g

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

--top

반환할 최대 배포 수입니다. 기본적으로 모든 배포가 반환 됩니다.

az iot edge deployment show

IoT Edge 배포에 대 한 세부 정보를 가져옵니다.

az iot edge deployment show --deployment-id
                            [--hub-name]
                            [--login]
                            [--resource-group]

필수 매개 변수

--deployment-id -d

대상 배포 이름입니다.

선택적 매개 변수

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--resource-group -g

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

az iot edge deployment show-metric

IoT Edge 배포에 정의 된 대상 시스템 메트릭을 평가 합니다.

az iot edge deployment show-metric --deployment-id
                                   --metric-id
                                   [--hub-name]
                                   [--login]
                                   [--metric-type {system, user}]
                                   [--resource-group]

예제

' AppliedCount ' 시스템 메트릭을 평가 합니다.

az iot edge deployment show-metric -m appliedCount -d {deployment_name} -n {iothub_name} --mt system

' MyCustomMetric ' 사용자 메트릭을 평가 합니다.

az iot edge deployment show-metric -m myCustomMetric -d {deployment_name} -n {iothub_name}

필수 매개 변수

--deployment-id -d

대상 배포 이름입니다.

--metric-id -m

평가할 대상 메트릭입니다.

선택적 매개 변수

--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 edge deployment update

IoT Edge 배포의 지정 된 속성을 업데이트 합니다.

배포를 업데이트 하기 위해--set 다음에 속성 할당을 사용 합니다.

참고: IoT Edge 배포 콘텐츠를 변경할 수 없습니다. 업데이트할 수 있는 배포 속성은 ' 레이블 ', ' 메트릭 ', ' 우선 순위 ' 및 ' targetCondition '입니다.

az iot edge deployment update --deployment-id
                              [--add]
                              [--etag]
                              [--force-string]
                              [--hub-name]
                              [--login]
                              [--remove]
                              [--resource-group]
                              [--set]

예제

기존에 지 배포의 레이블 및 대상 조건 변경

az iot edge deployment update -d {deployment_name} -n {iothub_name} --set labels='{"purpose":"dev", "owners":"IoTEngineering"}' targetCondition='tags.building=9'

필수 매개 변수

--deployment-id -d

대상 배포 이름입니다.

선택적 매개 변수

--add

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

--etag -e

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

--force-string

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

--hub-name -n

IoT Hub 이름입니다.

--login -l

이 명령은 작업을 수행할 수 있는 권한이 있는 엔터티 연결 문자열을 지원 합니다. "Az login"을 통해 세션 로그인을 방지 하는 데 사용 합니다. 엔터티 연결 문자열과 이름을 모두 제공 하는 경우 연결 문자열에 우선 순위가 적용 됩니다.

--remove

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

--resource-group -g

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

--set

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