다음을 통해 공유


az iot ops

참고 항목

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

이 명령 그룹은 미리 보기 상태이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

Azure IoT 작업을 관리합니다.

Azure IoT Operations는 온-프레미스 자산의 데이터를 산업용 MQTT Broker로 집계하고, 에지 컴퓨팅을 추가하고, 클라우드의 다양한 서비스와 양방향 데이터 흐름을 설정할 수 있는 고도로 정렬되었지만 느슨하게 결합된 자사 Kubernetes 서비스 집합입니다.

기본적으로 IoT Operations CLI 명령은 정기적으로 새 확장 버전을 사용할 수 있는지 확인합니다. 이 동작은 .을 사용하여 az config set iotops.check_latest=false사용하지 않도록 설정할 수 있습니다.

명령

Name Description 형식 상태
az iot ops asset

자산 관리.

내선 번호 프리뷰
az iot ops asset create

자산을 만듭니다.

내선 번호 프리뷰
az iot ops asset dataset

자산의 데이터 세트를 관리합니다.

내선 번호 프리뷰
az iot ops asset dataset list

자산 내의 데이터 세트를 나열합니다.

내선 번호 프리뷰
az iot ops asset dataset point

자산 데이터 세트의 데이터 요소를 관리합니다.

내선 번호 프리뷰
az iot ops asset dataset point add

자산 데이터 세트에 데이터 포인트를 추가합니다.

내선 번호 프리뷰
az iot ops asset dataset point export

자산 데이터 세트의 데이터 요소를 내보냅니다.

내선 번호 프리뷰
az iot ops asset dataset point import

자산 데이터 세트의 데이터 요소를 가져옵니다.

내선 번호 프리뷰
az iot ops asset dataset point list

자산 데이터 세트의 데이터 요소를 나열합니다.

내선 번호 프리뷰
az iot ops asset dataset point remove

자산 데이터 세트의 데이터 포인트를 제거합니다.

내선 번호 프리뷰
az iot ops asset dataset show

자산 내의 데이터 세트를 표시합니다.

내선 번호 프리뷰
az iot ops asset delete

자산을 삭제합니다.

내선 번호 프리뷰
az iot ops asset endpoint

자산 엔드포인트 프로필을 관리합니다.

내선 번호 프리뷰
az iot ops asset endpoint create

자산 엔드포인트 프로필을 만듭니다.

내선 번호 프리뷰
az iot ops asset endpoint create opcua

OPCUA 커넥터를 사용하여 자산 엔드포인트 프로필을 만듭니다.

내선 번호 프리뷰
az iot ops asset endpoint delete

자산 엔드포인트 프로필을 삭제합니다.

내선 번호 프리뷰
az iot ops asset endpoint query

자산 엔드포인트 프로필에 대한 Resource Graph를 쿼리합니다.

내선 번호 프리뷰
az iot ops asset endpoint show

자산 엔드포인트 프로필을 표시합니다.

내선 번호 프리뷰
az iot ops asset endpoint update

자산 엔드포인트 프로필을 업데이트합니다.

내선 번호 프리뷰
az iot ops asset event

자산의 이벤트를 관리합니다.

내선 번호 프리뷰
az iot ops asset event add

자산에 이벤트를 추가합니다.

내선 번호 프리뷰
az iot ops asset event export

자산의 이벤트를 내보냅니다.

내선 번호 프리뷰
az iot ops asset event import

자산에서 이벤트를 가져옵니다.

내선 번호 프리뷰
az iot ops asset event list

자산의 이벤트를 나열합니다.

내선 번호 프리뷰
az iot ops asset event remove

자산에서 이벤트를 제거합니다.

내선 번호 프리뷰
az iot ops asset query

자산에 대한 Resource Graph를 쿼리합니다.

내선 번호 프리뷰
az iot ops asset show

자산을 표시합니다.

내선 번호 프리뷰
az iot ops asset update

자산을 업데이트합니다.

내선 번호 프리뷰
az iot ops broker

Mqtt broker 관리.

내선 번호 프리뷰
az iot ops broker authn

Broker 인증 관리.

내선 번호 프리뷰
az iot ops broker authn delete

mqtt broker 인증 리소스를 삭제합니다.

내선 번호 프리뷰
az iot ops broker authn list

인스턴스와 연결된 mqtt broker 인증 리소스를 나열합니다.

내선 번호 프리뷰
az iot ops broker authn show

mqtt broker 인증 리소스의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops broker authz

Broker 권한 부여 관리.

내선 번호 프리뷰
az iot ops broker authz delete

mqtt broker 권한 부여 리소스를 삭제합니다.

내선 번호 프리뷰
az iot ops broker authz list

인스턴스와 연결된 mqtt broker 권한 부여 리소스를 나열합니다.

내선 번호 프리뷰
az iot ops broker authz show

mqtt broker 권한 부여 리소스의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops broker delete

mqtt broker를 삭제합니다.

내선 번호 프리뷰
az iot ops broker list

인스턴스와 연결된 mqtt broker를 나열합니다.

내선 번호 프리뷰
az iot ops broker listener

Broker 수신기 관리.

내선 번호 프리뷰
az iot ops broker listener delete

mqtt broker 수신기를 삭제합니다.

내선 번호 프리뷰
az iot ops broker listener list

broker와 연결된 mqtt broker 수신기를 나열합니다.

내선 번호 프리뷰
az iot ops broker listener show

mqtt broker 수신기의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops broker show

mqtt broker의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops broker stats

dmqtt 실행 통계를 표시합니다.

내선 번호 프리뷰
az iot ops check

배포된 IoT Operations 서비스의 클러스터 쪽 준비 상태 및 런타임 상태를 평가합니다.

내선 번호 프리뷰
az iot ops connector

커넥터 관리.

내선 번호 프리뷰
az iot ops connector opcua

OPC UA 커넥터 관리.

내선 번호 프리뷰
az iot ops connector opcua client

OPC UA Broker에 대한 엔터프라이즈급 클라이언트 애플리케이션 인스턴스 인증서를 관리합니다.

내선 번호 프리뷰
az iot ops connector opcua client add

엔터프라이즈급 클라이언트 애플리케이션 인스턴스 인증서를 추가합니다.

내선 번호 프리뷰
az iot ops connector opcua issuer

OPC UA Broker에 대한 발급자 인증서를 관리합니다.

내선 번호 프리뷰
az iot ops connector opcua issuer add

OPC UA Broker의 발급자 인증서 목록에 발급자 인증서를 추가합니다.

내선 번호 프리뷰
az iot ops connector opcua trust

OPC UA Broker에 대한 신뢰할 수 있는 인증서를 관리합니다.

내선 번호 프리뷰
az iot ops connector opcua trust add

OPC UA Broker의 신뢰할 수 있는 인증서 목록에 신뢰할 수 있는 인증서를 추가합니다.

내선 번호 프리뷰
az iot ops create

IoT Operations 인스턴스를 만듭니다.

내선 번호 프리뷰
az iot ops dataflow

데이터 흐름 관리.

내선 번호 프리뷰
az iot ops dataflow endpoint

데이터 흐름 엔드포인트 관리.

내선 번호 프리뷰
az iot ops dataflow endpoint list

인스턴스와 연결된 데이터 흐름 엔드포인트 리소스를 나열합니다.

내선 번호 프리뷰
az iot ops dataflow endpoint show

데이터 흐름 엔드포인트 리소스의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops dataflow list

데이터 흐름 프로필과 연결된 데이터 흐름을 나열합니다.

내선 번호 프리뷰
az iot ops dataflow profile

데이터 흐름 프로필 관리.

내선 번호 프리뷰
az iot ops dataflow profile list

인스턴스와 연결된 데이터 흐름 프로필을 나열합니다.

내선 번호 프리뷰
az iot ops dataflow profile show

데이터 흐름 프로필의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops dataflow show

데이터 흐름 프로필과 연결된 데이터 흐름의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops delete

클러스터에서 IoT 작업을 삭제합니다.

내선 번호 프리뷰
az iot ops identity

인스턴스 ID 관리.

내선 번호 프리뷰
az iot ops identity assign

인스턴스를 사용하여 사용자 할당 관리 ID를 할당합니다.

내선 번호 프리뷰
az iot ops identity remove

인스턴스에서 사용자 할당 관리 ID를 제거합니다.

내선 번호 프리뷰
az iot ops identity show

인스턴스 ID를 표시합니다.

내선 번호 프리뷰
az iot ops init

IoT Operations 배포를 위해 Arc 지원 클러스터를 부트스트랩합니다.

내선 번호 프리뷰
az iot ops list

IoT Operations 인스턴스를 나열합니다.

내선 번호 프리뷰
az iot ops schema

스키마 및 레지스트리 관리.

내선 번호 프리뷰
az iot ops schema create

스키마 레지스트리 내에 스키마를 만듭니다.

내선 번호 프리뷰
az iot ops schema delete

스키마 레지스트리 내에서 대상 스키마를 삭제합니다.

내선 번호 프리뷰
az iot ops schema list

스키마 레지스트리 내의 스키마를 나열합니다.

내선 번호 프리뷰
az iot ops schema registry

스키마 레지스트리 관리.

내선 번호 프리뷰
az iot ops schema registry create

스키마 레지스트리를 만듭니다.

내선 번호 프리뷰
az iot ops schema registry delete

대상 스키마 레지스트리를 삭제합니다.

내선 번호 프리뷰
az iot ops schema registry list

리소스 그룹 또는 구독의 스키마 레지스트리를 나열합니다.

내선 번호 프리뷰
az iot ops schema registry show

스키마 레지스트리의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops schema show

스키마 레지스트리 내의 스키마 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops schema show-dataflow-refs

데이터 흐름에 사용되는 스키마 참조를 표시합니다.

내선 번호 프리뷰
az iot ops schema version

스키마 버전 관리.

내선 번호 프리뷰
az iot ops schema version add

스키마에 스키마 버전을 추가합니다.

내선 번호 프리뷰
az iot ops schema version list

특정 스키마에 대한 스키마 버전을 나열합니다.

내선 번호 프리뷰
az iot ops schema version remove

대상 스키마 버전을 제거합니다.

내선 번호 프리뷰
az iot ops schema version show

스키마 버전의 세부 정보를 표시합니다.

내선 번호 프리뷰
az iot ops secretsync

인스턴스 비밀 동기화 관리.

내선 번호 프리뷰
az iot ops secretsync disable

인스턴스에 대한 비밀 동기화를 사용하지 않도록 설정합니다.

내선 번호 프리뷰
az iot ops secretsync enable

인스턴스에 대해 비밀 동기화를 사용하도록 설정합니다.

내선 번호 프리뷰
az iot ops secretsync list

인스턴스와 연결된 비밀 동기화 구성을 나열합니다.

내선 번호 프리뷰
az iot ops show

IoT Operations 인스턴스를 표시합니다.

내선 번호 프리뷰
az iot ops support

IoT 작업은 작업을 지원합니다.

내선 번호 프리뷰
az iot ops support create-bundle

문제 해결 및 진단에 사용할 표준 지원 번들 zip 보관 파일을 만듭니다.

내선 번호 프리뷰
az iot ops update

IoT Operations 인스턴스를 업데이트합니다.

내선 번호 프리뷰
az iot ops upgrade

IoT Operations 인스턴스를 최신 버전으로 업그레이드합니다.

내선 번호 프리뷰
az iot ops verify-host

IoT Operations 배포 호환성에 대한 클러스터 호스트 확인 집합을 실행합니다.

내선 번호 프리뷰

az iot ops check

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

배포된 IoT Operations 서비스의 클러스터 쪽 준비 상태 및 런타임 상태를 평가합니다.

이 명령은 기본적으로 모든 서비스에 대한 고급 사용자 친화적 인 요약 보기를 보여 줍니다. '--svc' 옵션을 사용하여 단일 서비스에 대한 검사를 지정하고 인수를 통해 --detail-level 세부 정보를 구성합니다. 참고: 리소스 종류(--resources) 및 이름(--resource-name) 필터링은 '--svc' 인수와 함께만 사용할 수 있습니다.

{지원되는 서비스 API}

  • deviceregistry.microsoft.com/[v1beta2]
  • mqttbroker.iotoperations.azure.com/[v1beta1]
  • opcuabroker.iotoperations.azure.com/[v1beta1]
  • connectivity.iotoperations.azure.com/[v1beta1]

클러스터 요구 사항에 대한 자세한 내용은 다음을 확인 https://aka.ms/iot-ops-cluster-requirements하세요.

az iot ops check [--as-object {false, true}]
                 [--context]
                 [--detail-level {0, 1, 2}]
                 [--ops-service {akri, broker, dataflow, deviceregistry, opcua}]
                 [--post {false, true}]
                 [--pre {false, true}]
                 [--resource-name]
                 [--resources {asset, assetendpointprofile, assettype, broker, brokerlistener, dataflow, dataflowendpoint, dataflowprofile}]

예제

기본 사용. 요약 출력을 사용하여 전체 IoT 작업 상태를 확인합니다.

az iot ops check

자세한 출력을 사용하여 'broker' 서비스 상태 및 구성을 확인합니다.

az iot ops check --svc broker --detail-level 1

CI에 최적화된 출력을 사용하여 '데이터 흐름' 서비스만 평가합니다.

az iot ops check --svc dataflow --as-object

자세한 출력으로 'deviceregistry' 상태를 검사하지만 결과를 '자산' 리소스로 제한합니다.

az iot ops check --svc deviceregistry --detail-level 2 --resources asset

리소스 이름을 사용하여 'my-asset-' 이름 접두사를 사용하여 결과를 'asset' 리소스로 제한

az iot ops check --svc deviceregistry --resources asset --resource-name 'my-asset-*'

선택적 매개 변수

--as-object

출력은 CI 친화적인 데이터 구조에서 콘텐츠 및 유효성 검사를 확인합니다.

허용되는 값: false, true
--context

k8s 클러스터 통신에 사용할 Kubeconfig 컨텍스트 이름입니다. 컨텍스트가 제공되지 않으면 current_context 사용됩니다.

--detail-level

검사 출력에 표시되는 세부 정보 수준을 제어합니다. 요약 보기(최소 출력) 0, 자세한 보기(보다 포괄적인 정보)의 경우 1, 자세한 보기(사용 가능한 모든 정보)의 경우 2를 선택합니다.

허용되는 값: 0, 1, 2
Default value: 0
--ops-service --svc

평가할 IoT Operations 서비스 배포입니다.

허용되는 값: akri, broker, dataflow, deviceregistry, opcua
--post

배포 후 검사를 실행합니다.

허용되는 값: false, true
--pre

필수 구성 요소 검사를 실행하여 서비스 배포의 최소 요구 사항이 충족되는지 확인합니다.

허용되는 값: false, true
--resource-name --rn

특정 리소스 이름에 대한 검사만 실행합니다. 이름은 대소문자를 구분하지 않습니다. '' 및 '?' Glob 패턴이 지원됩니다. 참고: 영숫자 문자, 하이픈, '?' 및 ''만 허용됩니다.

--resources

특정 리소스 종류에 대해서만 검사를 실행합니다. 공백으로 구분된 값을 사용합니다.

허용되는 값: asset, assetendpointprofile, assettype, broker, brokerlistener, dataflow, dataflowendpoint, dataflowprofile
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot ops create

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Operations 인스턴스를 만듭니다.

이 명령을 실행하기 전에 init의 성공적인 실행이 필요합니다.

명령의 결과는 응집력 있는 함수에 대해 구성된 기본 리소스 집합을 사용하여 IoT Operations 인스턴스를 그물로 만듭니다.

az iot ops create --cluster
                  --name
                  --resource-group
                  --sr-resource-id
                  [--add-insecure-listener {false, true}]
                  [--bp]
                  [--br]
                  [--broker-backend-workers]
                  [--broker-config-file]
                  [--broker-frontend-replicas]
                  [--broker-frontend-workers]
                  [--broker-listener-type {ClusterIp, LoadBalancer, NodePort}]
                  [--broker-mem-profile {High, Low, Medium, Tiny}]
                  [--cluster-namespace]
                  [--custom-location]
                  [--description]
                  [--df-profile-instances]
                  [--enable-rsync {false, true}]
                  [--kubernetes-distro {K3s, K8s, MicroK8s}]
                  [--location]
                  [--no-progress {false, true}]
                  [--ops-config]
                  [--ops-version]
                  [--runtime-socket]
                  [--tags]
                  [--trust-settings]

예제

최소 입력을 사용하여 대상 인스턴스를 만듭니다.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID

다음 예제에서는 기본 broker 인스턴스 리소스와 인스턴스 설명 및 태그에 사용자 지정을 추가합니다.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --broker-mem-profile High --broker-backend-workers 4 --description 'Contoso Factory' --tags tier=testX1

이 예제에서는 서비스 유형 부하 분산 장치의 포트 1883에 대해 구성된 추가 안전하지 않은(authn 또는 authz 없음) broker 수신기를 배포하는 방법을 보여 줍니다. 테스트 및/또는 데모에 유용합니다. 프로덕션 환경에서 안전하지 않은 옵션을 사용하지 마세요.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --add-insecure-listener

이 양식에서는 인스턴스 배포에 리소스 동기화를 사용하도록 설정하는 방법을 보여 줍니다. 리소스 동기화 역할 할당 쓰기를 사용하도록 설정하려면 대상 리소스 그룹에 필요합니다.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --enable-rsync

이 예제에서는 사용자가 제공한 cert-manager 구성에 대한 신뢰 설정을 강조 표시합니다. 클러스터는 '--user-trust'를 사용하여 초기화되어야 하며 사용자 인증서 관리자 배포가 있어야 합니다.

az iot ops create --cluster mycluster -g myresourcegroup --name myinstance --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID --trust-settings configMapName=example-bundle configMapKey=trust-bundle.pem issuerKind=ClusterIssuer issuerName=trust-manager-selfsigned-issuer

필수 매개 변수

--cluster

IoT Operations 배포의 대상 클러스터 이름입니다.

--name -n

IoT Operations 인스턴스 이름입니다. init 오케스트레이션 중에 인스턴스를 배포하려면 인스턴스 이름을 제공해야 합니다.

--resource-group -g

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

--sr-resource-id

IoT Operations에 사용할 스키마 레지스트리 리소스 ID입니다.

선택적 매개 변수

--add-insecure-listener

mqtt broker 배포를 사용하도록 설정하면 인증 또는 authZ 없이 포트 1883에 바인딩된 서비스 유형 LoadBalancer의 수신기가 포함됩니다. 비프로덕션 워크로드에만 해당합니다.

허용되는 값: false, true
--bp --broker-backend-part

Mqtt broker 백 엔드 파티션. 최소값: 1, 최대값: 16.

Default value: 2
--br --broker-backend-rf

Mqtt broker 백 엔드 중복 요소입니다. 최소값: 1, 최대값: 5.

Default value: 2
--broker-backend-workers --bw

Mqtt broker 백 엔드 작업자입니다. 최소값: 1, 최대값: 16.

Default value: 2
--broker-config-file

사용자 지정 broker 구성 속성이 있는 json 파일의 경로입니다. 파일 구성 콘텐츠는 개별 broker 구성 매개 변수에 사용됩니다. 고급 시나리오에 유용합니다. 예상 형식은 .에 설명되어 있습니다 https://aka.ms/aziotops-broker-config.

--broker-frontend-replicas --fr

Mqtt broker 프런트 엔드 복제본. 최소값: 1, 최대값: 16.

Default value: 2
--broker-frontend-workers --fw

Mqtt broker 프런트 엔드 작업자입니다. 최소값: 1, 최대값: 16.

Default value: 2
--broker-listener-type --lt

기본 mqtt broker 수신기와 연결된 서비스 유형입니다.

허용되는 값: ClusterIp, LoadBalancer, NodePort
Default value: ClusterIp
--broker-mem-profile --mp

Mqtt broker 메모리 프로필입니다.

허용되는 값: High, Low, Medium, Tiny
Default value: Medium
--cluster-namespace

클러스터 네임스페이스 IoT Operations 인프라가 배포됩니다. 소문자여야 합니다.

Default value: azure-iot-operations
--custom-location

IoT Operations 배포에 해당하는 사용자 지정 위치 이름입니다. 기본값은 'location-{hash(5)}' 형식입니다.

--description

IoT Operations 인스턴스에 대한 설명입니다.

--df-profile-instances

기본 데이터 흐름 프로필과 연결된 인스턴스 수입니다.

Default value: 1
--enable-rsync

리소스 동기화 규칙은 IoT 작업 배포에 포함됩니다.

허용되는 값: false, true
--kubernetes-distro

Akri 구성에 사용할 Kubernetes 배포판입니다. 선택한 배포판은 --runtime-socket 값이 제공되지 않는 경우 기본 컨테이너 런타임 소켓 경로를 의미합니다.

허용되는 값: K3s, K8s, MicroK8s
Default value: K8s
--location

프로비전된 리소스 담보에 사용할 지역입니다. 제공되지 않으면 연결된 클러스터 위치가 사용됩니다.

--no-progress

작업의 시각적 표현을 사용하지 않도록 설정합니다.

허용되는 값: false, true
--ops-config

IoT Operations arc 확장 사용자 지정 구성. 형식은 공백으로 구분된 키=값 쌍입니다. --ops-config를 하나 이상 사용할 수 있습니다. 고급 사용 사례의 경우

--ops-version
사용되지 않음

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

기본 제공 IoT Operations Arc 확장 버전을 재정의하는 데 사용합니다.

--runtime-socket

컨테이너 런타임 소켓의 기본 노드 경로입니다. 제공되지 않은 경우(기본값) 소켓 경로는 --kubernetes-distro에 의해 결정됩니다.

--tags

인스턴스 태그입니다. a=b c=d 형식의 키-값 쌍의 속성 모음입니다. --tags ""를 사용하여 모든 태그를 제거합니다.

--trust-settings

사용자가 제공한 신뢰 번들에 대한 설정입니다. 구성 요소 TLS에 사용됩니다. 형식은 공백으로 구분된 키=값 쌍입니다. 다음 키가 필요합니다configMapKey. , configMapName, issuerNameissuerKind. 사용하지 않는 경우 시스템에서 자체 서명된 신뢰 번들을 구성합니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot ops delete

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

클러스터에서 IoT 작업을 삭제합니다.

인스턴스 또는 클러스터의 이름을 제공해야 합니다.

이 작업은 Azure Resource Graph를 사용하여 상관 관계가 있는 리소스를 확인합니다. 결국 일관성이 있는 Resource Graph는 실행 시 동기화된 상태를 보장하지 않습니다.

az iot ops delete --resource-group
                  [--cluster]
                  [--force {false, true}]
                  [--include-deps {false, true}]
                  [--name]
                  [--no-progress {false, true}]
                  [--yes {false, true}]

예제

전체 삭제를 위한 최소 입력입니다.

az iot ops delete -n myinstance -g myresourcegroup

확인 프롬프트를 건너뛰고 프로세스를 계속 삭제합니다. CI 시나리오에 유용합니다.

az iot ops delete -n myinstance -g myresourcegroup -y

경고에 관계없이 강제로 삭제합니다. 오류가 발생할 수 있습니다.

az iot ops delete -n myinstance -g myresourcegroup --force

조회에 인스턴스 대신 클러스터 이름을 사용합니다.

az iot ops delete --cluster mycluster -g myresourcegroup

init의 역방향 애플리케이션입니다.

az iot ops delete -n myinstance -g myresourcegroup --include-deps

필수 매개 변수

--resource-group -g

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

선택적 매개 변수

--cluster

IoT 작업 삭제의 대상 클러스터 이름입니다.

--force

작업을 강제로 실행합니다.

허용되는 값: false, true
--include-deps

명령이 IoT 작업 종속성을 제거해야 임을 나타냅니다. 이 옵션은 init의 애플리케이션을 반대로 하기 위한 것입니다.

허용되는 값: false, true
--name -n

IoT Operations 인스턴스 이름입니다.

--no-progress

작업의 시각적 표현을 사용하지 않도록 설정합니다.

허용되는 값: false, true
--yes -y

프롬프트 없이 [y]es를 확인합니다. CI 및 자동화 시나리오에 유용합니다.

허용되는 값: false, true
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot ops init

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Operations 배포를 위해 Arc 지원 클러스터를 부트스트랩합니다.

IoT 작업을 배포하려면 Arc 지원 클러스터가 필요합니다. 자세한 내용은 다음 리소스를 참조하세요 https://aka.ms/aziotops-arcconnect.

init 작업은 IoT Operations 배포에 필요한 에지 서비스의 기본 계층을 설치하고 구성하는 작업을 수행합니다.

기본 계층이 설치되면 az iot ops create 명령을 사용하여 인스턴스를 배포해야 합니다.

az iot ops init --cluster
                --resource-group
                [--enable-fault-tolerance {false, true}]
                [--ensure-latest {false, true}]
                [--no-progress {false, true}]
                [--user-trust {false, true}]

예제

최소 입력이 있는 사용량입니다. 이 양식은 IoT Operations 기본 계층을 배포합니다.

az iot ops init --cluster mycluster -g myresourcegroup

이전 예제와 비슷하지만 Arc Container Storage 내결함성을 사용하도록 설정했습니다(노드가 3개 이상 필요).

az iot ops init --cluster mycluster -g myresourcegroup --enable-fault-tolerance

이 예제에서는 사용자 지정 cert-manager 구성에 대한 사용자 신뢰 설정을 사용하도록 설정하는 것을 강조 표시합니다. 그러면 시스템 cert-manager 및 trust-manager 배포가 건너뜁니다.

az iot ops init --cluster mycluster -g myresourcegroup --user-trust

필수 매개 변수

--cluster

IoT Operations 배포의 대상 클러스터 이름입니다.

--resource-group -g

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

선택적 매개 변수

--enable-fault-tolerance

Azure Arc Container Storage에 내결함성을 사용하도록 설정합니다. 3개 이상의 클러스터 노드가 필요합니다.

허용되는 값: false, true
--ensure-latest

최신 IoT Ops CLI가 사용되고 있는지 확인하여 업그레이드를 사용할 수 있는 경우 오류가 발생합니다.

허용되는 값: false, true
--no-progress

작업의 시각적 표현을 사용하지 않도록 설정합니다.

허용되는 값: false, true
--user-trust --ut

사용자가 제공한 구성을 위해 시스템 cert-manager 및 trust-manager 배포를 건너뜁니다.

허용되는 값: false, true
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot ops list

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Operations 인스턴스를 나열합니다.

원하는 JMESPath 구문을 사용하여 --query를 사용하여 결과를 쿼리합니다.

az iot ops list [--resource-group]

예제

구독의 모든 인스턴스를 나열합니다.

az iot ops list

특정 리소스 그룹의 모든 인스턴스를 나열합니다.

az iot ops list -g myresourcegroup

특정 태그 값이 있는 구독의 인스턴스를 나열합니다.

az iot ops list -g myresourcegroup --query "[?tags.env == 'prod']"

선택적 매개 변수

--resource-group -g

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

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot ops show

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Operations 인스턴스를 표시합니다.

필요에 따라 명령은 지원 클러스터에 대한 IoT Operations 배포를 나타내는 연결된 리소스의 트리 구조를 출력할 수 있습니다. 이 명령이 실패하면 계속하기 전에 인스턴스를 최신 버전으로 업그레이드하는 데 사용 az iot ops upgrade 하세요.

az iot ops show --name
                --resource-group
                [--tree {false, true}]

예제

인스턴스를 표시하는 기본 사용법입니다.

az iot ops show --name myinstance -g myresourcegroup

IoT Operations 배포를 나타내는 연결된 리소스의 트리 구조를 출력합니다.

az iot ops show --name myinstance -g myresourcegroup --tree

필수 매개 변수

--name -n

IoT Operations 인스턴스 이름입니다.

--resource-group -g

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

선택적 매개 변수

--tree

지원 클러스터에 대해 IoT Operations 배포를 시각화하는 데 사용합니다.

허용되는 값: false, true
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot ops update

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Operations 인스턴스를 업데이트합니다.

현재 인스턴스 태그 및 설명을 업데이트할 수 있습니다. 인스턴스를 최신 버전으로 업그레이드하려면 대신 사용 az iot ops upgrade 하세요.

az iot ops update --name
                  --resource-group
                  [--description]
                  [--tags]

예제

인스턴스 태그를 업데이트합니다. 이는 바꾸기와 동일합니다.

az iot ops update --name myinstance -g myresourcegroup --tags a=b c=d

인스턴스 태그를 제거합니다.

az iot ops update --name myinstance -g myresourcegroup --tags ""

인스턴스 설명을 업데이트합니다.

az iot ops update --name myinstance -g myresourcegroup --desc "Fabrikam Widget Factory B42"

필수 매개 변수

--name -n

IoT Operations 인스턴스 이름입니다.

--resource-group -g

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

선택적 매개 변수

--description

IoT Operations 인스턴스에 대한 설명입니다.

--tags

인스턴스 태그입니다. a=b c=d 형식의 키-값 쌍의 속성 모음입니다. --tags ""를 사용하여 모든 태그를 제거합니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot ops upgrade

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Operations 인스턴스를 최신 버전으로 업그레이드합니다.

경고: 이 명령이 실패할 수 있으며 클러스터 및 인스턴스를 삭제하고 다시 만들어야 합니다.

확장을 최신 버전으로 업데이트하는 것을 포함하여 IoT Operations 인스턴스를 업그레이드합니다. 오류가 발생하거나 유사한 명령이 실패하는 경우 az iot ops show 이 명령을 사용합니다.

스키마 레지스트리 리소스 ID는 선택적 매개 변수이며 특정 시나리오에서 필요할 수 있습니다.

az iot ops upgrade --name
                   --resource-group
                   [--no-progress {false, true}]
                   [--sr-resource-id]
                   [--yes {false, true}]

예제

최소한의 입력으로 인스턴스를 업그레이드합니다.

az iot ops upgrade --name myinstance -g myresourcegroup

인스턴스 업그레이드 중에 규칙 프롬프트를 건너뜁니다.

az iot ops upgrade --name myinstance -g myresourcegroup -y

인스턴스를 업그레이드하고 스키마 레지스트리 리소스 ID를 지정합니다.

az iot ops upgrade --name myinstance -g myresourcegroup --sr-resource-id $SCHEMA_REGISTRY_RESOURCE_ID

필수 매개 변수

--name -n

IoT Operations 인스턴스 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-progress

작업의 시각적 표현을 사용하지 않도록 설정합니다.

허용되는 값: false, true
--sr-resource-id

IoT Operations에 사용할 스키마 레지스트리 리소스 ID입니다. IoT 작업 내에서 스키마 레지스트리 리소스 ID를 더 이상 찾을 수 없는 경우 필수입니다.

--yes -y

프롬프트 없이 [y]es를 확인합니다. CI 및 자동화 시나리오에 유용합니다.

허용되는 값: false, true
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot ops verify-host

미리 보기

명령 그룹 'iot ops'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Operations 배포 호환성에 대한 클러스터 호스트 확인 집합을 실행합니다.

대상 클러스터 호스트에서 직접 실행하기 위한 것입니다. 이 명령은 종속성 설치와 같은 권한 있는 작업 집합을 적용하라는 메시지를 표시할 수 있습니다. 이 경우 CLI는 관리자 권한으로 실행해야 합니다. 예: sudo AZURE_EXTENSION_DIR=~/.azure/cliextensions az iot ops verify-host.

az iot ops verify-host [--no-progress {false, true}]

선택적 매개 변수

--no-progress

작업의 시각적 표현을 사용하지 않도록 설정합니다.

허용되는 값: false, true
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.