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 data-point	자산의 데이터 요소를 관리합니다.	내선 번호	프리뷰
az iot ops asset data-point add	자산에 데이터 포인트를 추가합니다.	내선 번호	프리뷰
az iot ops asset data-point export	자산의 데이터 요소를 내보냅니다.	내선 번호	프리뷰
az iot ops asset data-point import	자산의 데이터 요소를 가져옵니다.	내선 번호	프리뷰
az iot ops asset data-point list	자산의 데이터 요소를 나열합니다.	내선 번호	프리뷰
az iot ops asset data-point remove	자산에서 데이터 포인트를 제거합니다.	내선 번호	프리뷰
az iot ops asset delete	자산을 삭제합니다.	내선 번호	프리뷰
az iot ops asset endpoint	자산 엔드포인트 프로필을 관리합니다.	내선 번호	프리뷰
az iot ops asset endpoint certificate	자산 엔드포인트에서 소유 인증서를 관리합니다.	내선 번호	프리뷰
az iot ops asset endpoint certificate add	자산 엔드포인트에 소유 인증서를 추가합니다.	내선 번호	프리뷰
az iot ops asset endpoint certificate list	자산 엔드포인트에서 소유 인증서를 나열합니다.	내선 번호	프리뷰
az iot ops asset endpoint certificate remove	자산 엔드포인트에서 소유 인증서를 제거합니다.	내선 번호	프리뷰
az iot ops asset endpoint create	자산 엔드포인트를 만듭니다.	내선 번호	프리뷰
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 list	인스턴스와 연결된 mqtt broker 인증 리소스를 나열합니다.	내선 번호	프리뷰
az iot ops broker authn show	mqtt broker 인증 리소스의 세부 정보를 표시합니다.	내선 번호	프리뷰
az iot ops broker authz	Broker 권한 부여 관리.	내선 번호	프리뷰
az iot ops broker authz list	인스턴스와 연결된 mqtt broker 권한 부여 리소스를 나열합니다.	내선 번호	프리뷰
az iot ops broker authz show	mqtt broker 권한 부여 리소스의 세부 정보를 표시합니다.	내선 번호	프리뷰
az iot ops broker list	인스턴스와 연결된 mqtt broker를 나열합니다.	내선 번호	프리뷰
az iot ops broker listener	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 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 init	대상 Arc 지원 클러스터에 IoT 작업을 부트스트랩, 구성 및 배포합니다.	내선 번호	프리뷰
az iot ops list	IoT Operations 인스턴스를 나열합니다.	내선 번호	프리뷰
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 verify-host	IoT Operations 배포 호환성에 대한 클러스터 호스트 확인 집합을 실행합니다.	내선 번호	프리뷰

az iot ops check

미리 보기

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

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

이 명령은 기본적으로 선택한 서비스의 사용자 친화적인 요약 보기를 표시합니다. 자세한 내용은 .를 통해 --detail-level요청할 수 있습니다.

{지원되는 서비스 API}

• akri.sh/[v0]
• deviceregistry.microsoft.com/[v1beta1]
• mqttbroker.iotoperations.azure.com/[v1beta1]
• opcuabroker.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, deviceregistry, opcua}]
                 [--post {false, true}]
                 [--pre {false, true}]
                 [--resource-name]
                 [--resources {asset, assetendpointprofile, assettype, broker, brokerlistener, configuration, instance}]

예제

기본 사용. 요약 출력을 사용하여 'broker' 상태를 확인합니다.

az iot ops check

이전 예제와 같이 'broker'를 평가합니다. 그러나 출력은 CI에 최적화되어 있습니다.

az iot ops check --as-object

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

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

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

az iot ops check --svc deviceregistry --detail-level 1 --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, deviceregistry, opcua

Default value: broker

--post

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

허용되는 값: false, true

--pre

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

허용되는 값: false, true

--resource-name --rn

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

--resources

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

허용되는 값: asset, assetendpointprofile, assettype, broker, brokerlistener, configuration, instance

전역 매개 변수

--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 --cluster
                  --resource-group
                  [--force {false, true}]
                  [--no-progress {false, true}]
                  [--yes {false, true}]

예제

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

az iot ops delete --cluster mycluster -g myresourcegroup

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

az iot ops delete --cluster mycluster -g myresourcegroup -y

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

az iot ops delete --cluster mycluster -g myresourcegroup --force

필수 매개 변수

--cluster

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

--resource-group -g

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

선택적 매개 변수

--force

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

허용되는 값: false, true

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

대상 Arc 지원 클러스터에 IoT 작업을 부트스트랩, 구성 및 배포합니다.

클러스터를 Arc 사용으로 설정하는 방법을 비롯한 추가 리소스는 다음을 참조하세요. https://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/howto-prepare-cluster

IoT 작업은 Key Vault CSI 드라이버 비밀 동기화에 대한 SP(서비스 주체)에 따라 달라집니다.

기본적으로 init는 Microsoft Graph를 통해 적합한 앱 등록을 만들고 구성한 다음 클러스터에 적용하는 작업을 수행합니다.

앱 등록을 미리 만든 다음 --sp-app-id, --sp-object-id 및 --sp-secret에 대한 값을 제공하여 이 작업을 단락할 수 있습니다. SP 필드를 제공하면 Microsoft Graph 작업을 통한 추가 작업이 수행되지 않습니다.

앱 등록을 미리 만드는 것은 로그인한 보안 주체에 제한된 Entra ID 권한이 있는 경우에 유용합니다. 예를 들어 CI/자동화 시나리오 또는 조직에서 사용자 책임을 분리합니다.

az iot ops init --cluster
                --resource-group
                [--add-insecure-listener {false, true}]
                [--bfr]
                [--bfw]
                [--broker]
                [--broker-authn]
                [--broker-backend-part]
                [--broker-backend-rf]
                [--broker-backend-workers]
                [--broker-config-file]
                [--broker-listener]
                [--broker-mem-profile {High, Low, Medium, Tiny}]
                [--broker-service-type {ClusterIp, LoadBalancer, NodePort}]
                [--ca-dir]
                [--ca-file]
                [--ca-key-file]
                [--ca-valid-days]
                [--cluster-namespace]
                [--context]
                [--csi-config]
                [--csi-ver]
                [--custom-location]
                [--desc]
                [--df-profile-instances]
                [--disable-rotation {false, true}]
                [--disable-rsync-rules {false, true}]
                [--ensure-latest {false, true}]
                [--kubernetes-distro {k3s, k8s, microk8s}]
                [--kv-id]
                [--kv-spc-secret-name]
                [--location]
                [--name]
                [--no-block {false, true}]
                [--no-deploy {false, true}]
                [--no-progress {false, true}]
                [--no-tls {false, true}]
                [--rotation-int]
                [--runtime-socket]
                [--show-template {false, true}]
                [--simulate-plc {false, true}]
                [--sp-app-id]
                [--sp-object-id]
                [--sp-secret]
                [--sp-secret-valid-days]

예제

전체 설치를 위한 최소 입력입니다. 여기에는 Key Vault 구성, CSI 드라이버 배포, TLS 구성 및 IoT Operations 배포가 포함됩니다.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id /subscriptions/2cb3a427-1abc-48d0-9d03-dd240819742a/resourceGroups/myresourcegroup/providers/Microsoft.KeyVault/vaults/mykeyvault

기존 앱 ID 및 배포의 일부로 시뮬레이션된 PLC 서버를 포함하는 플래그를 사용하는 경우를 제외하고 이전 예제와 동일한 설정입니다. 앱 ID를 포함하면 init에서 앱 등록을 만들지 못하게 됩니다.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --simulate-plc

배포를 건너뛰고 Key Vault CSI 드라이버 및 TLS 구성 워크플로에만 집중하려면 --no-deploy를 간단히 전달합니다. 포털과 같은 다른 도구에서 배포하려는 경우에 유용할 수 있습니다.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --no-deploy

이미 미리 준비된 클러스터에만 IoT 작업을 배포하려면 --kv-id를 생략하고 --no-tls를 포함하기만 하면 됩니다.

az iot ops init --cluster mycluster -g myresourcegroup --no-tls

--no-block을 사용하여 배포가 진행 중인 동안 다른 작업을 수행할 수 있으며 다른 작업을 시작하기 전에 배포가 완료되기를 기다립니다.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --no-block

이 예제에서는 --sp-app-id, --sp-object-id 및 --sp-secret에 대한 값을 제공하는 방법을 보여줍니다. 이러한 값은 Key Vault CSI 드라이버 비밀 동기화에 사용할 원하는 서비스 주체를 반영해야 합니다. 자세한 내용은 명령 요약을 검토하세요.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --sp-object-id 224a7a3f-c63d-4923-8950-c4a85f0d2f29 --sp-secret $SP_SECRET

Key Vault CSI 드라이버의 런타임 구성을 사용자 지정하기 위해 --csi-config를 사용할 수 있습니다. 예를 들어 telegraf 컨테이너 종속성에 대한 리소스 제한을 설정합니다.

az iot ops init --cluster mycluster -g myresourcegroup --kv-id $KEYVAULT_ID --sp-app-id a14e216b-6802-4e9c-a6ac-844f9ffd230d --csi-config telegraf.resources.limits.memory=500Mi telegraf.resources.limits.cpu=100m

필수 매개 변수

--cluster

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

--resource-group -g

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

선택적 매개 변수

--add-insecure-listener

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

허용되는 값: false, true

--bfr --broker-frontend-replicas

Mqtt broker 프런트 엔드 복제본.

Default value: 2

--bfw --broker-frontend-workers

Mqtt broker 프런트 엔드 작업자입니다.

Default value: 2

--broker

mqtt broker 이름입니다.

Default value: broker

--broker-authn

mqtt broker authN 이름입니다.

Default value: authn

--broker-backend-part

Mqtt broker 백 엔드 파티션.

Default value: 2

--broker-backend-rf

Mqtt broker 백 엔드 중복 요소입니다.

Default value: 2

--broker-backend-workers

Mqtt broker 백 엔드 작업자입니다.

Default value: 2

--broker-config-file

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

--broker-listener

mqtt broker 수신기 이름입니다.

Default value: listener

--broker-mem-profile

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

허용되는 값: High, Low, Medium, Tiny

Default value: Medium

--broker-service-type

Mqtt broker 서비스 유형입니다.

허용되는 값: ClusterIp, LoadBalancer, NodePort

Default value: ClusterIp

--ca-dir

생성된 테스트 CA 및 프라이빗 키가 배치되는 로컬 디렉터리입니다. 디렉터리가 제공되지 않으면 디스크에 파일이 기록되지 않습니다. --ca-file 및 --ca-key-file이 제공되지 않는 경우에 적용됩니다.

--ca-file

원하는 CA 파일의 경로(PEM 형식)입니다.

--ca-key-file

PEM 형식의 CA 프라이빗 키 파일 경로입니다. ! 필수! --ca-file이 제공되면 입니다.

--ca-valid-days

init에서 생성된 x509 CA의 기간(일)을 제어하는 옵션입니다. --ca-file 및 --ca-key-file이 제공되지 않은 경우 적용됩니다.

Default value: 365

--cluster-namespace

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

Default value: azure-iot-operations

--context

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

--csi-config

CSI 드라이버 확장 사용자 지정 구성입니다. 형식은 공백으로 구분된 키=값 쌍입니다. --csi-config를 하나 이상 사용할 수 있습니다.

--csi-ver

CSI 드라이버 확장 버전입니다.

Default value: 1.5.6

--custom-location

IoT Operations 배포에 해당하는 사용자 지정 위치 이름입니다. 기본값은 '{cluster_name}-{token}-ops-init-cl' 형식입니다.

--desc

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

--df-profile-instances

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

Default value: 1

--disable-rotation

비밀 회전을 사용하지 않도록 설정하는 플래그입니다.

허용되는 값: false, true

--disable-rsync-rules

리소스 동기화 규칙은 IoT Operations 배포에 포함되지 않습니다.

허용되는 값: false, true

--ensure-latest

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

허용되는 값: false, true

--kubernetes-distro

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

허용되는 값: k3s, k8s, microk8s

Default value: k8s

--kv-id

Key Vault ARM 리소스 ID. 이 리소스 ID를 제공하면 클라이언트가 필요한 모든 리소스 및 클러스터 쪽 구성을 설정하여 IoT 작업에 Key Vault CSI 드라이버를 사용하도록 설정할 수 있습니다.

--kv-spc-secret-name

기본 SPC 비밀 로 사용할 Key Vault 비밀 이름 입니다. 비밀이 없으면 암호화된 보안 개체 틀 값으로 만들어집니다.

Default value: azure-iot-operations

--location

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

--name -n

IoT Operations 인스턴스 이름입니다. 기본값은 '{cluster_name}-ops-instance' 형식입니다.

--no-block

IoT Operations 배포가 시작된 직후에 반환합니다.

허용되는 값: false, true

--no-deploy

IoT Operations 배포 워크플로는 건너뜁니다.

허용되는 값: false, true

--no-progress

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

허용되는 값: false, true

--no-tls

TLS 구성 워크플로는 건너뜁습니다.

허용되는 값: false, true

--rotation-int

회전 폴링 간격입니다.

Default value: 1h

--runtime-socket

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

--show-template

플래그를 설정하면 배포를 위한 템플릿이 출력됩니다.

허용되는 값: false, true

--simulate-plc

설정되면 플래그를 지정하고, PLC 서버를 스핀업하도록 OPC-UA 브로커 설치 관리자를 구성합니다.

허용되는 값: false, true

--sp-app-id

서비스 주체 앱 ID입니다. 제공된 경우 CSI 드라이버 설정에 사용됩니다. 그렇지 않으면 앱 등록이 만들어집니다. 로그인한 보안 주체에 쿼리 그래프에 대한 권한이 없는 경우 필요합니다 .

--sp-object-id

서비스 주체(sp) 개체 ID입니다. 제공된 경우 CSI 드라이버 설정에 사용됩니다. 그렇지 않으면 앱 ID에서 개체 ID를 쿼리합니다. sp가 없으면 sp를 만듭니다. 로그인한 보안 주체에 쿼리 그래프에 대한 권한이 없는 경우 필요합니다 . 적절한 개체 ID를 생성하는 데 사용합니다 az ad sp show --id <app Id> --query id -o tsv . 또는 포털을 사용하여 Entra Id 테넌트에서 엔터프라이즈 애플리케이션으로 이동할 수 있습니다.

--sp-secret

제공된 서비스 주체 앱 ID에 해당하는 비밀입니다. 제공된 경우 CSI 드라이버 설정에 사용됩니다. 그렇지 않으면 새 비밀이 만들어집니다. 로그인한 보안 주체에 쿼리 그래프에 대한 권한이 없는 경우 필요합니다 .

--sp-secret-valid-days

init에서 생성된 서비스 주체 비밀의 기간(일)을 제어하는 옵션입니다. --sp-secret이 제공되지 않은 경우 적용됩니다.

Default value: 365

전역 매개 변수

--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 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 update --name
                  --resource-group
                  [--desc]
                  [--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>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--desc

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

--tags

인스턴스 태그입니다. a=b c=d 형식의 키-값 쌍의 속성 모음입니다.

전역 매개 변수

--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를 사용합니다.