az iot edge devices

참조

참고 항목

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

IoT Edge 디바이스를 관리하는 명령입니다.

명령

Name	Description	형식	상태
az iot edge devices create	IoT Hub에서 여러 에지 디바이스를 만들고 구성합니다.	내선 번호	실험적

az iot edge devices create

실험적

이 명령은 실험적이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Hub에서 여러 에지 디바이스를 만들고 구성합니다.

이 작업은 YAML 또는 JSON 형식의 인라인 디바이스 인수 또는 에지 디바이스 구성 파일을 허용합니다. 인라인 명령 인수(예: '--device-auth')가 우선적으로 적용되고 구성 파일 속성이 제공되면 재정의됩니다. 샘플 구성 파일은 여기에서 https://aka.ms/aziotcli-edge-devices-config 찾을 수 있습니다. 이 작업을 완전히 활용하는 방법에 대한 자세한 내용은 예제 및 매개 변수 설명을 검토하세요.

az iot edge devices create [--auth-type {key, login}]
                           [--cfg]
                           [--clean {false, true}]
                           [--dct]
                           [--dea]
                           [--device]
                           [--device-auth {shared_private_key, x509_thumbprint}]
                           [--hub-name]
                           [--login]
                           [--out]
                           [--rc]
                           [--resource-group]
                           [--rk]
                           [--root-pass]
                           [--vis {false, true}]
                           [--yes {false, true}]

예제

대칭 키 인증을 사용하여 몇 가지 에지 디바이스 만들기(기본값)

az iot edge devices create -n {hub_name} --device id=device_1 --device id=device_2

인라인 인수를 사용하여 다양한 에지 속성 구성으로 자체 서명된 인증서 인증을 사용하여 에지 디바이스의 플랫 목록을 만듭니다.

az iot edge devices create -n {hub_name} --device-auth x509_thumbprint --default-edge-agent "mcr.microsoft.com/azureiotedge-agent:1.4"
--device id=device_1 hostname={FQDN}
--device id=device_2 edge_agent={agent_image}
--device id=parent hostname={FQDN} edge_agent={agent_image} container_auth={path_or_json_string}

허브에서 모든 기존 디바이스 ID를 삭제하고 구성 파일(진행률 표시줄 및 시각화 출력 포함)을 기반으로 새 디바이스를 만듭니다.

az iot edge devices create -n {hub_name} --cfg path/to/config_yml_or_json -c -v

인라인 인수를 사용하여 각각 1개의 자식 디바이스가 있는 2개의 부모 디바이스를 포함하는 사용자 지정 모듈 배포를 사용하여 중첩된 에지 디바이스 그룹을 만듭니다. 또한 디바이스 인증서 번들에 대한 출력 경로를 지정합니다.

az iot edge devices create -n {hub_name} --out {device_bundle_path}
--device id=parent_1 deployment=/path/to/parentDeployment_1.json
--device id=child_1 parent=parent_1 deployment=/path/to/child_deployment_1.json
--device id=parent_2 deployment=/path/to/parentDeployment_2.json
--device id=child_2 parent=parent_2 deployment=/path/to/child_deployment_2.json

x509 인증을 사용하여 기존 루트 CA를 사용하여 간단한 중첩 에지 디바이스 구성을 만들고 사용자 지정 디바이스 번들 출력 경로를 지정합니다.

az iot edge devices create -n {hub_name} --out {device_bundle_path}
--root-cert "root_cert.pem" --root-key "root_key.pem" --device-auth x509_thumbprint
--device id=parent1
--device id=child1 parent=parent1

선택적 매개 변수

--auth-type

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

허용되는 값: key, login

기본값: key

--cfg --config --config-file

디바이스 구성 파일의 경로입니다. 샘플 구성 파일: https://aka.ms/aziotcli-edge-devices-config.

--clean -c

새 디바이스를 만들기 전에 대상 허브의 모든 디바이스를 삭제합니다.

허용되는 값: false, true

기본값: False

--dct --device-config-template

에지 디바이스 구성의 기준으로 사용할 IoT Edge config.toml 파일의 경로입니다.

--dea --default-agent --default-edge-agent

개별적으로 지정하지 않은 경우 생성된 Edge 디바이스에 대한 기본 에지 에이전트입니다.

--device -d

만들 에지 디바이스의 속성에 해당하는 공백으로 구분된 key=value 쌍입니다. 지원 id 되는 키 값은 (device_id), deployment (인라인 json 또는 파일 경로), hostnameparent (device_id), (이미지 URL) edge_agent 및 container_auth (인라인 json 또는 파일 경로)입니다. --device는 1회 이상 사용할 수 있습니다. 전체 매개 변수 사용에 대한 도움말 예제를 검토합니다. 이러한 매개 변수는 샘플 구성 파일 https://aka.ms/aziotcli-edge-devices-config의 해당 값도 참조합니다.

--device-auth --device-auth-type

디바이스-허브 권한 부여 메커니즘.

허용되는 값: shared_private_key, x509_thumbprint

--hub-name -n

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

--login -l

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

--out --output-path

출력 디바이스 구성 번들에 대한 디렉터리 경로입니다. 이 값을 지정하지 않으면 파일 출력이 생성되지 않습니다.

--rc --root-cert

중첩된 에지 디바이스 인증서에 서명하는 루트 공개 키 인증서의 경로입니다.

--resource-group -g

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

--rk --root-key

중첩된 에지 디바이스 인증서에 서명하는 루트 프라이빗 키의 경로입니다.

--root-pass --rp

루트 키 암호입니다.

--vis --visualize -v

디바이스의 시각화 및 다양한 작업의 진행률(디바이스 만들기, 부모 설정, 구성 업데이트 등)을 보여 줍니다.

허용되는 값: false, true

기본값: False

--yes -y

--클린 스위치를 사용하여 기존 허브 디바이스를 삭제하는 경우 확인을 요청하지 마세요.

허용되는 값: false, true

기본값: False

전역 매개 변수

--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 devices

명령

az iot edge devices create

예제

선택적 매개 변수

피드백

추가 리소스