az iot central

Note

이 명령 그룹에는 Azure CLI 및 하나 이상의 확장 모두에 정의된 명령이 있습니다. 확장된 기능을 활용하려면 각 확장을 설치합니다. 확장 프로그램에 대해 자세히 알아보세요.

IoT Central 리소스를 관리합니다.

IoT Central은 엔터프라이즈급 IoT 솔루션의 개발, 관리 및 유지 관리 부담과 비용을 줄이는 IoT 애플리케이션 플랫폼입니다. IoT Central을 사용하여 빌드하기로 하면 복잡하고 지속적으로 진화하는 IoT 인프라를 단순히 유지 관리하고 업데이트하는 것이 아니라 IoT 데이터를 활용하여 비즈니스를 트랜스포메이션하는 데 시간, 비용, 에너지를 집중할 수 있습니다. IoT Central 설명서는 Azure IoT CLI 확장에서 https://aka.ms/iotcentral-documentation 사용할 수 있는 포괄적인 IoT Central 데이터 평면 기능에서 사용할 수 있습니다. 설치 방법에 대한 자세한 내용은 다음을 방문하세요 https://github.com/Azure/azure-iot-cli-extension.

명령

Name	Description	형식	상태
az iot central api-token	IoT Central 애플리케이션에 대한 API 토큰을 관리합니다.	Extension	GA
az iot central api-token create	IoT Central 애플리케이션과 연결된 API 토큰을 생성합니다.	Extension	GA
az iot central api-token delete	IoT Central 애플리케이션과 연결된 API 토큰을 삭제합니다.	Extension	GA
az iot central api-token list	IoT Central 애플리케이션과 연결된 API 토큰 목록을 가져옵니다.	Extension	GA
az iot central api-token show	IoT Central 애플리케이션과 연결된 API 토큰에 대한 세부 정보를 가져옵니다.	Extension	GA
az iot central app	IoT Central 애플리케이션을 관리합니다.	Core	GA
az iot central app create	IoT Central 애플리케이션을 만듭니다.	Core	GA
az iot central app delete	IoT Central 애플리케이션을 삭제합니다.	Core	GA
az iot central app identity	IoT Central 애플리케이션 ID를 관리합니다.	Core	GA
az iot central app identity assign	관리 ID를 IoT Central 애플리케이션에 할당합니다.	Core	GA
az iot central app identity remove	IoT Central 애플리케이션에서 관리 ID를 제거합니다.	Core	GA
az iot central app identity show	IoT Central 애플리케이션의 ID 속성을 표시합니다.	Core	GA
az iot central app list	IoT Central 애플리케이션을 나열합니다.	Core	GA
az iot central app private-endpoint-connection	IoT Central 애플리케이션의 프라이빗 엔드포인트 연결을 관리합니다.	Core	GA
az iot central app private-endpoint-connection approve	IoT Central 애플리케이션에 대한 프라이빗 엔드포인트 연결 요청을 승인합니다.	Core	GA
az iot central app private-endpoint-connection delete	IoT Central 애플리케이션에 대한 프라이빗 엔드포인트 연결을 삭제합니다.	Core	GA
az iot central app private-endpoint-connection list	IoT Central 애플리케이션에 대한 모든 프라이빗 엔드포인트 연결을 나열합니다.	Core	GA
az iot central app private-endpoint-connection reject	IoT Central 애플리케이션에 대한 프라이빗 엔드포인트 연결 요청을 거부합니다.	Core	GA
az iot central app private-endpoint-connection show	IoT Central 애플리케이션에 대한 프라이빗 엔드포인트 연결 요청의 세부 정보를 표시합니다.	Core	GA
az iot central app private-link-resource	IoT Central 애플리케이션 프라이빗 링크 리소스를 관리합니다.	Core	GA
az iot central app private-link-resource list	지정된 계정의 모든 IoT Central 애플리케이션 프라이빗 링크 리소스를 나열합니다.	Core	GA
az iot central app private-link-resource show	지정된 IoT Central 애플리케이션에서 프라이빗 링크 리소스의 세부 정보를 표시합니다.	Core	GA
az iot central app show	IoT Central 애플리케이션의 세부 정보를 가져옵니다.	Core	GA
az iot central app update	IoT Central 애플리케이션에 대한 메타데이터를 업데이트합니다.	Core	GA
az iot central device	IoT Central 디바이스를 관리하고 구성합니다.	Extension	GA
az iot central device-group	IoT Central 디바이스 그룹을 관리하고 구성합니다.	Extension	GA
az iot central device-group create	장치 그룹을 만듭니다.	Extension	GA
az iot central device-group delete	디바이스 그룹을 삭제합니다.	Extension	GA
az iot central device-group list	IoT Central 애플리케이션에 대한 디바이스 그룹 목록을 가져옵니다.	Extension	GA
az iot central device-group show	ID별로 디바이스 그룹을 가져옵니다.	Extension	GA
az iot central device-group update	기존 디바이스 그룹을 업데이트합니다.	Extension	GA
az iot central device-template	IoT Central 디바이스 템플릿을 관리하고 구성합니다.	Extension	GA
az iot central device-template create	IoT Central에서 디바이스 템플릿을 만듭니다.	Extension	GA
az iot central device-template delete	IoT Central에서 디바이스 템플릿을 삭제합니다.	Extension	GA
az iot central device-template list	IoT Central 애플리케이션에 대한 디바이스 템플릿 목록을 가져옵니다.	Extension	GA
az iot central device-template show	IoT Central에서 디바이스 템플릿을 가져옵니다.	Extension	GA
az iot central device-template update	IoT Central에서 디바이스 템플릿을 업데이트합니다.	Extension	GA
az iot central device attestation	IoT Central 디바이스 증명을 관리하고 구성합니다.	Extension	GA
az iot central device attestation create	개별 디바이스 증명을 만듭니다.	Extension	GA
az iot central device attestation delete	개별 디바이스 증명을 제거합니다.	Extension	GA
az iot central device attestation show	디바이스 증명을 가져옵니다.	Extension	GA
az iot central device attestation update	패치를 통해 개별 디바이스 증명을 업데이트합니다.	Extension	GA
az iot central device c2d-message	디바이스 클라우드-디바이스 메시징 명령을 실행합니다.	Extension	GA
az iot central device c2d-message purge	대상 디바이스에 대한 클라우드-디바이스 메시지 큐를 제거합니다.	Extension	GA
az iot central device command	디바이스 명령을 실행합니다.	Extension	GA
az iot central device command history	디바이스로 전송된 최신 명령 요청 및 응답에 대한 세부 정보를 가져옵니다.	Extension	GA
az iot central device command run	디바이스에서 명령을 실행하고 연결된 응답을 봅니다. 명령이 수행할 수 있는 속성 업데이트를 모니터링하지 않습니다.	Extension	GA
az iot central device compute-device-key	파생 디바이스 SAS 키를 생성합니다.	Extension	GA
az iot central device create	IoT Central에서 디바이스를 만듭니다.	Extension	GA
az iot central device delete	IoT Central에서 디바이스를 삭제합니다.	Extension	GA
az iot central device edge	IoT Central 에지 디바이스를 관리하고 구성합니다.	Extension	GA
az iot central device edge children	IoT Edge 디바이스 자식 디바이스를 관리합니다.	Extension	GA
az iot central device edge children add	대상 에지 디바이스에 디바이스를 자식으로 추가합니다.	Extension	Preview
az iot central device edge children list	IoT Edge 디바이스의 자식 목록을 가져옵니다.	Extension	GA
az iot central device edge children remove	대상 에지 디바이스에서 자식 디바이스를 제거합니다.	Extension	Preview
az iot central device edge manifest	IoT Edge 디바이스 매니페스트를 관리합니다.	Extension	Preview
az iot central device edge manifest show	지정된 IoT Edge 디바이스에 연결된 배포 매니페스트를 가져옵니다.	Extension	Preview
az iot central device edge module	IoT Edge 디바이스 모듈을 관리합니다.	Extension	Preview
az iot central device edge module list	IoT Edge 디바이스에서 모듈 목록을 가져옵니다.	Extension	Preview
az iot central device edge module restart	IoT Edge 디바이스에서 모듈을 다시 시작합니다.	Extension	Preview
az iot central device edge module show	IoT Edge 디바이스에서 모듈을 가져옵니다.	Extension	Preview
az iot central device list	IoT Central 애플리케이션에 대한 디바이스 목록을 가져옵니다.	Extension	GA
az iot central device list-components	디바이스에 있는 구성 요소를 나열합니다.	Extension	GA
az iot central device list-modules	디바이스에 있는 모듈을 나열합니다.	Extension	GA
az iot central device manual-failback	디바이스를 원래 IoT Hub로 다시 이동하여 이전에 실행한 장애 조치(failover) 명령을 되돌려줍니다.	Extension	GA
az iot central device manual-failover	여러 IoT Hub에서 디바이스의 수동 장애 조치(failover)를 실행하여 DPS를 사용하여 다른 IoT Hub에 다시 연결하는 디바이스 펌웨어의 기능의 유효성을 검사합니다.	Extension	GA
az iot central device registration-info	IoT Central에서 디바이스에 대한 등록 정보를 가져옵니다.	Extension	GA
az iot central device show	IoT Central에서 디바이스를 가져옵니다.	Extension	GA
az iot central device show-credentials	IoT Central에서 디바이스 자격 증명을 가져옵니다.	Extension	GA
az iot central device telemetry	IoT Central 디바이스 마지막 원격 분석 값을 쿼리합니다.	Extension	GA
az iot central device telemetry show	디바이스에서 마지막 원격 분석 값을 가져옵니다.	Extension	GA
az iot central device twin	IoT Central 디바이스 쌍을 관리합니다.	Extension	GA
az iot central device twin replace	디바이스, 디바이스 구성 요소 또는 디바이스 모듈 또는 디바이스 모듈 구성 요소의 쓰기 가능한 속성 값을 바꿉니다.	Extension	GA
az iot central device twin show	디바이스, 디바이스 구성 요소, 디바이스 모듈 또는 디바이스 모듈 구성 요소의 모든 속성 값을 가져옵니다.	Extension	GA
az iot central device twin update	디바이스, 디바이스 구성 요소, 디바이스 모듈 또는 디바이스 모듈 구성 요소의 쓰기 가능한 속성 값을 업데이트합니다.	Extension	GA
az iot central device update	IoT Central에서 디바이스를 업데이트합니다.	Extension	GA
az iot central diagnostics	애플리케이션 및 디바이스 수준 진단을 수행합니다.	Extension	Preview
az iot central diagnostics monitor-events	IoT Central 앱으로 전송된 디바이스 원격 분석 메시지를 봅니다.	Extension	Preview
az iot central diagnostics monitor-properties	IoT Central 앱에서 전송된 desired 및 reported 속성을 봅니다.	Extension	Preview
az iot central diagnostics registration-summary	앱의 모든 디바이스에 대한 등록 요약을 봅니다.	Extension	Preview
az iot central diagnostics validate-messages	IoT Central 앱에 대해 IoT Hub로 전송된 메시지의 유효성을 검사합니다.	Extension	Preview
az iot central diagnostics validate-properties	IoT Central 애플리케이션으로 전송된 reported 속성의 유효성을 검사합니다.	Extension	Preview
az iot central enrollment-group	IoT Central 등록 그룹을 관리하고 구성합니다.	Extension	GA
az iot central enrollment-group create	등록 그룹을 만듭니다.	Extension	GA
az iot central enrollment-group delete	ID별로 등록 그룹을 삭제합니다.	Extension	GA
az iot central enrollment-group generate-verification-code	등록 그룹의 기본 또는 보조 x509 인증서에 대한 확인 코드를 생성합니다.	Extension	GA
az iot central enrollment-group list	애플리케이션의 등록 그룹 목록을 가져옵니다.	Extension	GA
az iot central enrollment-group show	ID별로 등록 그룹에 대한 세부 정보를 가져옵니다.	Extension	GA
az iot central enrollment-group update	등록 그룹을 업데이트합니다.	Extension	GA
az iot central enrollment-group verify-certificate	등록 그룹의 기본 또는 보조 x509 인증서를 확인합니다.	Extension	GA
az iot central export	IoT Central 데이터 내보내기 관리 및 구성	Extension	Preview
az iot central export create	IoT Central 애플리케이션에 대한 내보내기 만들기	Extension	Preview
az iot central export delete	IoT Central 애플리케이션에 대한 내보내기 삭제	Extension	Preview
az iot central export destination	IoT Central 내보내기 대상을 관리하고 구성합니다.	Extension	Preview
az iot central export destination create	IoT Central 애플리케이션에 대한 내보내기 대상을 만듭니다.	Extension	Preview
az iot central export destination delete	IoT Central 애플리케이션의 내보내기 대상을 삭제합니다.	Extension	Preview
az iot central export destination list	IoT Central 애플리케이션에 대한 내보내기 대상의 전체 목록을 가져옵니다.	Extension	Preview
az iot central export destination show	내보내기 대상 세부 정보를 가져옵니다.	Extension	Preview
az iot central export destination update	IoT Central 애플리케이션의 내보내기 대상을 업데이트합니다.	Extension	Preview
az iot central export list	IoT Central 애플리케이션의 전체 내보내기 목록을 가져옵니다.	Extension	Preview
az iot central export show	내보내기 세부 정보를 가져옵니다.	Extension	Preview
az iot central export update	IoT Central 애플리케이션에 대한 내보내기 업데이트	Extension	Preview
az iot central file-upload-config	IoT Central 파일 업로드를 관리하고 구성합니다.	Extension	GA
az iot central file-upload-config create	파일 업로드 스토리지 계정 구성을 만듭니다.	Extension	GA
az iot central file-upload-config delete	파일 업로드 스토리지 계정 구성을 삭제합니다.	Extension	GA
az iot central file-upload-config show	파일 업로드 스토리지 계정 구성의 세부 정보를 가져옵니다.	Extension	GA
az iot central file-upload-config update	파일 업로드 스토리지 계정 구성을 업데이트합니다.	Extension	GA
az iot central job	IoT Central 애플리케이션에 대한 작업을 관리하고 구성합니다.	Extension	GA
az iot central job create	작업 정의를 통해 작업을 만들고 실행합니다.	Extension	GA
az iot central job get-devices	작업 디바이스 상태를 가져옵니다.	Extension	GA
az iot central job list	IoT Central 애플리케이션에 대한 작업 목록을 가져옵니다.	Extension	GA
az iot central job rerun	실패한 모든 디바이스에서 작업을 다시 실행합니다.	Extension	GA
az iot central job resume	중지된 작업을 다시 시작합니다.	Extension	GA
az iot central job show	ID별로 작업의 세부 정보를 가져옵니다.	Extension	GA
az iot central job stop	실행 중인 작업을 중지합니다.	Extension	GA
az iot central organization	IoT Central 애플리케이션에 대한 조직을 관리하고 구성합니다.	Extension	GA
az iot central organization create	애플리케이션에서 조직을 만듭니다.	Extension	GA
az iot central organization delete	ID로 조직을 삭제합니다.	Extension	GA
az iot central organization list	IoT Central 애플리케이션에 대한 조직 목록을 가져옵니다.	Extension	GA
az iot central organization show	ID로 조직의 세부 정보를 가져옵니다.	Extension	GA
az iot central organization update	애플리케이션에서 조직을 업데이트합니다.	Extension	GA
az iot central query	IoT Central 쿼리 언어를 사용하여 디바이스 원격 분석 또는 속성 데이터를 쿼리합니다.	Extension	Preview
az iot central role	IoT Central 애플리케이션에 대한 역할을 관리하고 구성합니다.	Extension	GA
az iot central role list	IoT Central 애플리케이션에 대한 역할 목록을 가져옵니다.	Extension	GA
az iot central role show	ID별로 역할의 세부 정보를 가져옵니다.	Extension	GA
az iot central scheduled-job	IoT Central 일정 작업을 관리하고 구성합니다.	Extension	GA
az iot central scheduled-job create	ID별로 예약된 작업을 만듭니다.	Extension	GA
az iot central scheduled-job delete	ID별로 예약된 기존 작업을 삭제합니다.	Extension	GA
az iot central scheduled-job list	애플리케이션에서 예약된 작업 정의 목록을 가져옵니다.	Extension	GA
az iot central scheduled-job list-runs	예약된 작업 정의에 대한 작업 인스턴스 목록을 가져옵니다.	Extension	GA
az iot central scheduled-job show	ID별로 예약된 작업에 대한 세부 정보를 가져옵니다.	Extension	GA
az iot central scheduled-job update	ID별로 예약된 작업을 업데이트합니다.	Extension	GA
az iot central user	IoT Central 사용자를 관리하고 구성합니다.	Extension	GA
az iot central user create	애플리케이션에 사용자를 추가합니다.	Extension	GA
az iot central user delete	애플리케이션에서 사용자를 삭제합니다.	Extension	GA
az iot central user list	IoT Central 애플리케이션에 대한 사용자 목록을 가져옵니다.	Extension	GA
az iot central user show	ID로 사용자의 세부 정보를 가져옵니다.	Extension	GA
az iot central user update	애플리케이션에서 사용자의 역할을 업데이트합니다.	Extension	GA

az iot central query

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Central 쿼리 언어를 사용하여 디바이스 원격 분석 또는 속성 데이터를 쿼리합니다.

쿼리 구문 세부 정보는 다음을 방문하세요 https://learn.microsoft.com/en-us/azure/iot-central/core/howto-query-with-rest-api.

az iot central query --app-id
                     --qs --query-string
                     [--api-version --av {2022-06-30-preview}]
                     [--central-api-uri --central-dns-suffix]
                     [--token]

예제

디바이스 원격 분석 쿼리

az iot central query --app-id {appid} --query-string {query_string}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--qs --query-string

원격 분석 또는 속성 데이터를 검색하는 쿼리 절입니다.

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--api-version --av

사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

요청된 작업에 대한 API 버전입니다.

속성	값
Default value:	2022-06-30-preview
허용되는 값:	2022-06-30-preview

--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

속성	값
Default value:	azureiotcentral.com

--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

전역 매개 변수

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

명령

az iot central query

예제

필수 매개 변수

선택적 매개 변수

피드백