az iot edge

참고 항목

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

Edge에서 IoT 솔루션을 관리합니다.

명령

Name	Description	형식	상태
az iot edge deployment	대규모로 IoT Edge 배포를 관리합니다.	내선 번호	GA
az iot edge deployment create	대상 IoT Hub에서 IoT Edge 배포를 만듭니다.	내선 번호	GA
az iot edge deployment delete	IoT Edge 배포를 삭제합니다.	내선 번호	GA
az iot edge deployment list	IoT Hub에서 IoT Edge 배포를 나열합니다.	내선 번호	GA
az iot edge deployment show	IoT Edge 배포의 세부 정보를 가져옵니다.	내선 번호	GA
az iot edge deployment show-metric	IoT Edge 배포에 정의된 대상 시스템 메트릭을 평가합니다.	내선 번호	GA
az iot edge deployment update	IoT Edge 배포의 지정된 속성을 업데이트합니다.	내선 번호	GA
az iot edge devices	IoT Edge 디바이스를 관리하는 명령입니다.	내선 번호	GA
az iot edge devices create	IoT Hub에서 여러 에지 디바이스를 만들고 구성합니다.	내선 번호	실험적
az iot edge export-modules	단일 에지 디바이스에서 에지 모듈의 구성을 내보냅니다.	내선 번호	GA
az iot edge set-modules	단일 디바이스에서 에지 모듈을 설정합니다.	내선 번호	GA

az iot edge export-modules

단일 에지 디바이스에서 에지 모듈의 구성을 내보냅니다.

모듈 쌍 구성 출력은 "az iot edge set-modules"의 --content로 직접 사용할 수 있습니다.

az iot edge export-modules --device-id
                           [--auth-type {key, login}]
                           [--hub-name]
                           [--login]
                           [--resource-group]

예제

대상 디바이스에서 모듈 쌍 구성을 내보냅니다.

az iot edge export-modules --hub-name {iothub_name} --device-id {device_id}

필수 매개 변수

--device-id -d

대상 디바이스 ID입니다.

선택적 매개 변수

--auth-type

작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iothub-data-auth-type=<auth-type-value>기본값을 구성할 수 있습니다.

허용되는 값: key, login

기본값: key

--hub-name -n

IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.

--login -l

이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<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 iot edge set-modules

단일 디바이스에서 에지 모듈을 설정합니다.

모듈 콘텐츠는 json이며 {"modulesContent":{...}} 형식입니다. 또는 {"content":{"modulesContent":{...}}}.

기본적으로 시스템 모듈 $edgeAgent 및 $edgeHub 속성은 IoT 확장과 함께 설치된 스키마에 대해 유효성을 검사합니다. --no-validation 스위치를 사용하여 비활성화할 수 있습니다.

참고: 실행 시 명령은 디바이스에 적용된 모듈 컬렉션을 출력합니다.

az iot edge set-modules --content
                        --device-id
                        [--auth-type {key, login}]
                        [--hub-name]
                        [--login]
                        [--resource-group]

예제

대상 디바이스에서 모듈을 설정하여 개발 중인 동안 에지 모듈을 테스트합니다.

az iot edge set-modules --hub-name {iothub_name} --device-id {device_id} --content ../modules_content.json

필수 매개 변수

--content -k

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

--device-id -d

대상 디바이스 ID입니다.

선택적 매개 변수

--auth-type

작업에서 정책 키를 자동으로 파생할지 아니면 현재 Azure AD 세션을 사용해야 하는지 여부를 나타냅니다. 인증 유형이 로그인되고 리소스 호스트 이름이 제공되면 필요한 경우가 아니면 리소스 조회를 건너뜁습니다. 를 사용하여 az configure --defaults iothub-data-auth-type=<auth-type-value>기본값을 구성할 수 있습니다.

허용되는 값: key, login

기본값: key

--hub-name -n

IoT Hub 이름 또는 호스트 이름입니다. --login이 제공되지 않은 경우 필요합니다.

--login -l

이 명령은 작업을 수행할 권한이 있는 엔터티 연결 문자열 지원합니다. "az login"을 통해 세션 로그인을 방지하는 데 사용합니다. 엔터티 연결 문자열 및 이름이 모두 제공되면 연결 문자열 우선 순위가 지정됩니다. --hub-name이 제공되지 않은 경우 필요합니다.

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<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를 사용합니다.