az iot ops

Kommentar

Den här referensen är en del av azure-iot-ops-tillägget för Azure CLI (version 2.53.0 eller senare). Tillägget installeras automatiskt första gången du kör kommandot az iot ops . Läs mer om tillägg.

Den här kommandogruppen är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hantera Azure IoT-åtgärder.

Azure IoT Operations är en uppsättning mycket anpassade, men löst kopplade Kubernetes-tjänster från första part som gör att du kan aggregera data från lokala tillgångar till en MQTT Broker i industriell kvalitet, lägga till edge-beräkning och konfigurera dubbelriktade dataflöden med en mängd olika tjänster i molnet.

Som standard kontrollerar CLI-kommandon för IoT Operations regelbundet om en ny tilläggsversion är tillgänglig. Det här beteendet kan inaktiveras med az config set iotops.check_latest=false.

Kommandon

Name Description Typ Status
az iot ops asset

Hantera tillgångar.

Anknytning Förhandsversion
az iot ops asset create

Skapa en tillgång.

Anknytning Förhandsversion
az iot ops asset data-point

Hantera datapunkter i en tillgång.

Anknytning Förhandsversion
az iot ops asset data-point add

Lägg till en datapunkt i en tillgång.

Anknytning Förhandsversion
az iot ops asset data-point export

Exportera datapunkter i en tillgång.

Anknytning Förhandsversion
az iot ops asset data-point import

Importera datapunkter i en tillgång.

Anknytning Förhandsversion
az iot ops asset data-point list

Visa en lista över datapunkter i en tillgång.

Anknytning Förhandsversion
az iot ops asset data-point remove

Ta bort en datapunkt i en tillgång.

Anknytning Förhandsversion
az iot ops asset delete

Ta bort en tillgång.

Anknytning Förhandsversion
az iot ops asset endpoint

Hantera tillgångsslutpunktsprofiler.

Anknytning Förhandsversion
az iot ops asset endpoint certificate

Hantera ägda certifikat i en tillgångsslutpunkt.

Anknytning Förhandsversion
az iot ops asset endpoint certificate add

Lägg till ett ägt certifikat till en tillgångsslutpunkt.

Anknytning Förhandsversion
az iot ops asset endpoint certificate list

Visa en lista över ägda certifikat i en tillgångsslutpunkt.

Anknytning Förhandsversion
az iot ops asset endpoint certificate remove

Ta bort ett ägt certifikat i en tillgångsslutpunkt.

Anknytning Förhandsversion
az iot ops asset endpoint create

Skapa en tillgångsslutpunkt.

Anknytning Förhandsversion
az iot ops asset endpoint delete

Ta bort en tillgångsslutpunkt.

Anknytning Förhandsversion
az iot ops asset endpoint query

Fråga Resource Graph efter tillgångsslutpunkter.

Anknytning Förhandsversion
az iot ops asset endpoint show

Visa en tillgångsslutpunkt.

Anknytning Förhandsversion
az iot ops asset endpoint update

Uppdatera en tillgångsslutpunkt.

Anknytning Förhandsversion
az iot ops asset event

Hantera händelser i en tillgång.

Anknytning Förhandsversion
az iot ops asset event add

Lägg till en händelse i en tillgång.

Anknytning Förhandsversion
az iot ops asset event export

Exportera händelser i en tillgång.

Anknytning Förhandsversion
az iot ops asset event import

Importera händelser i en tillgång.

Anknytning Förhandsversion
az iot ops asset event list

Visa en lista över händelser i en tillgång.

Anknytning Förhandsversion
az iot ops asset event remove

Ta bort en händelse i en tillgång.

Anknytning Förhandsversion
az iot ops asset query

Fråga Resursdiagrammet efter tillgångar.

Anknytning Förhandsversion
az iot ops asset show

Visa en tillgång.

Anknytning Förhandsversion
az iot ops asset update

Uppdatera en tillgång.

Anknytning Förhandsversion
az iot ops broker

Hantering och åtgärder för Mqtt-koordinatorer.

Anknytning Förhandsversion
az iot ops broker authn

Hantering av autentisering med asynkron autentisering.

Anknytning Förhandsversion
az iot ops broker authn list

Visa en lista över mqtt broker-autentiseringsresurser som är associerade med en instans.

Anknytning Förhandsversion
az iot ops broker authn show

Visa information om en mqtt broker-autentiseringsresurs.

Anknytning Förhandsversion
az iot ops broker authz

Koordinatorauktoriseringshantering.

Anknytning Förhandsversion
az iot ops broker authz list

Visa en lista över auktoriseringsresurser för mqtt-auktorisering som är associerade med en instans.

Anknytning Förhandsversion
az iot ops broker authz show

Visa information om en mqtt broker-auktoriseringsresurs.

Anknytning Förhandsversion
az iot ops broker list

Lista mqtt-koordinatorer som är associerade med en instans.

Anknytning Förhandsversion
az iot ops broker listener

Hantering av mäklarlyssnare.

Anknytning Förhandsversion
az iot ops broker listener list

Lista mqtt broker lyssnare som är associerade med en mäklare.

Anknytning Förhandsversion
az iot ops broker listener show

Visa information om en mqtt-koordinatorlyssnare.

Anknytning Förhandsversion
az iot ops broker show

Visa information om en mqtt-asynkron meddelandekö.

Anknytning Förhandsversion
az iot ops broker stats

Visa dmqtt-körningsstatistik.

Anknytning Förhandsversion
az iot ops check

Utvärdera körningshälsan på klustersidan för distribuerade IoT Operations-tjänster.

Anknytning Förhandsversion
az iot ops dataflow

Dataflödeshantering.

Anknytning Förhandsversion
az iot ops dataflow endpoint

Dataflödesslutpunktshantering.

Anknytning Förhandsversion
az iot ops dataflow endpoint list

Visa en lista över dataflödesslutpunktsresurser som är associerade med en instans.

Anknytning Förhandsversion
az iot ops dataflow endpoint show

Visa information om en dataflödesslutpunktsresurs.

Anknytning Förhandsversion
az iot ops dataflow list

Visa en lista över dataflöden som är associerade med en dataflödesprofil.

Anknytning Förhandsversion
az iot ops dataflow profile

Hantering av dataflödesprofil.

Anknytning Förhandsversion
az iot ops dataflow profile list

Visa en lista över dataflödesprofiler som är associerade med en instans.

Anknytning Förhandsversion
az iot ops dataflow profile show

Visa information om en dataflödesprofil.

Anknytning Förhandsversion
az iot ops dataflow show

Visa information om ett dataflöde som är associerat med en dataflödesprofil.

Anknytning Förhandsversion
az iot ops delete

Ta bort IoT-åtgärder från klustret.

Anknytning Förhandsversion
az iot ops init

Bootstrap, konfigurera och distribuera IoT-åtgärder till det Arc-aktiverade målklustret.

Anknytning Förhandsversion
az iot ops list

Lista IoT Operations-instanser.

Anknytning Förhandsversion
az iot ops show

Visa en IoT Operations-instans.

Anknytning Förhandsversion
az iot ops support

IoT Operations stöder kommandoutrymme.

Anknytning Förhandsversion
az iot ops support create-bundle

Skapar ett zip-arkiv för standardsupportpaket för användning i felsökning och diagnostik.

Anknytning Förhandsversion
az iot ops update

Uppdatera en IoT Operations-instans.

Anknytning Förhandsversion
az iot ops verify-host

Kör en uppsättning klustervärdverifieringar för IoT Operations-distributionskompatibilitet.

Anknytning Förhandsversion

az iot ops check

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Utvärdera körningshälsan på klustersidan för distribuerade IoT Operations-tjänster.

Kommandot visar som standard en människovänlig sammanfattningsvy över den valda tjänsten. Mer information kan begäras via --detail-level.

{Tjänst-API:er som stöds}

  • akri.sh/[v0]
  • deviceregistry.microsoft.com/[v1beta1]
  • mqttbroker.iotoperations.azure.com/[v1beta1]
  • opcuabroker.iotoperations.azure.com/[v1beta1]

Mer information om klusterkrav finns i 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}]

Exempel

Grundläggande användning. Kontrollerar hälsotillståndet "broker" med sammanfattningsutdata.

az iot ops check

Utvärderar "broker" som tidigare exempel, men utdata är optimerade för CI.

az iot ops check --as-object

Kontrollerar "opcua" hälsa och konfiguration med detaljerade utdata.

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

Kontrollerar hälsotillståndet för enhetsregister, men begränsar resultatet till "tillgångsresurser".

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

Använda resursnamn för att begränsa resultatet till "tillgångsresurser" med prefixet "my-asset-"

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

Valfria parametrar

--as-object

Utdata kontrollerar innehåll och valideringar i en CI-vänlig datastruktur.

Godkända värden: false, true
--context

Kubeconfig-kontextnamn som ska användas för k8s-klusterkommunikation. Om ingen kontext anges används current_context.

--detail-level

Styr detaljnivån som visas i kontrollutdata. Välj 0 för en sammanfattningsvy (minimala utdata), 1 för en detaljerad vy (mer omfattande information) eller 2 för en utförlig vy (all tillgänglig information).

Godkända värden: 0, 1, 2
Standardvärde: 0
--ops-service --svc

Distributionen av IoT Operations-tjänsten som ska utvärderas.

Godkända värden: akri, broker, deviceregistry, opcua
Standardvärde: broker
--post

Kör kontroller efter distributionen.

Godkända värden: false, true
--pre

Kör nödvändiga kontroller för att avgöra om minimikraven för en tjänstdistribution uppfylls.

Godkända värden: false, true
--resource-name --rn

Kör endast kontroller för det specifika resursnamnet. Namnet är skiftlägesokänsligt. Globmönster "" och "?" stöds. Obs! Endast alfanumeriska tecken, bindestreck, "?" och "" tillåts.

--resources

Kör endast kontroller på specifika resurstyper. Använd blankstegsavgränsade värden.

Godkända värden: asset, assetendpointprofile, assettype, broker, brokerlistener, configuration, instance
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops delete

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Ta bort IoT-åtgärder från klustret.

Åtgärden använder Azure Resource Graph för att fastställa korrelerade resurser. Att Resource Graph slutligen är konsekvent garanterar inte ett synkroniserat tillstånd vid tidpunkten för körningen.

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

Exempel

Minsta indata för fullständig borttagning.

az iot ops delete --cluster mycluster -g myresourcegroup

Hoppa över bekräftelseprompten och fortsätt till borttagningsprocessen. Användbart för CI-scenarier.

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

Framtvinga borttagning oavsett varningar. Kan leda till fel.

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

Obligatoriska parametrar

--cluster

Målklusternamn för borttagning av IoT-åtgärder.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--force

Tvinga åtgärden att köras.

Godkända värden: false, true
--no-progress

Inaktivera visuell representation av arbete.

Godkända värden: false, true
--yes -y

Bekräfta [y]es utan att fråga. Användbart för CI- och automationsscenarier.

Godkända värden: false, true
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops init

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Bootstrap, konfigurera och distribuera IoT-åtgärder till det Arc-aktiverade målklustret.

Ytterligare resurser, inklusive hur du arcaktiverar ett kluster, finns i https://video2.skills-academy.com/en-us/azure/iot-operations/deploy-iot-ops/howto-prepare-cluster

IoT-åtgärder är beroende av ett tjänsthuvudnamn (SP) för CSI-drivrutinshemlighetssynkronisering för Key Vault.

Som standard fungerar init med att skapa och konfigurera en lämplig appregistrering via Microsoft Graph och sedan tillämpa den på klustret.

Du kan kortsluta det här arbetet genom att skapa en appregistrering i förväg och sedan ange värden för --sp-app-id, --sp-object-id och --sp-secret. Genom att tillhandahålla SP-fälten utförs inget ytterligare arbete via Microsoft Graph-åtgärder.

Att skapa en appregistrering i förväg är användbart när det inloggade huvudkontot har begränsade Entra-ID-behörigheter. Till exempel i CI/automation-scenarier eller en organisationsavgränsning av användaransvar.

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]

Exempel

Minsta indata för fullständig installation. Detta omfattar Key Vault-konfiguration, CSI-drivrutinsdistribution, TLS-konfiguration och distribution av IoT-åtgärder.

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

Samma konfiguration som tidigare exempel, förutom med användning av ett befintligt app-ID och en flagga för att inkludera en simulerad PLC-server som en del av distributionen. Om du inkluderar app-ID:t förhindras init från att skapa en appregistrering.

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

Om du vill hoppa över distributionen och bara fokusera på Key Vault CSI-drivrutinen och TLS-konfigurationsarbetsflödena skickar du enkelt in --no-deploy. Detta kan vara användbart när du vill distribuera från ett annat verktyg, till exempel portalen.

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

Om du bara vill distribuera IoT-åtgärder i ett kluster som redan har förberetts utelämnar du bara --kv-id och inkluderar --no-tls.

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

Använd --no-block för att utföra annat arbete medan distributionen pågår jämfört med att vänta på att distributionen ska slutföras innan du påbörjar det andra arbetet.

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

Det här exemplet visar värden för --sp-app-id, --sp-object-id och --sp-secret. Dessa värden bör återspegla det önskade tjänstens huvudnamn som ska användas för key vault CSI-drivrutinshemlighetssynkronisering. Mer information finns i kommandosammanfattningen.

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

Om du vill anpassa körningskonfigurationen för Key Vault CSI-drivrutinen kan --csi-config användas. Till exempel att ange resursgränser för telegrafcontainerns beroende.

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

Obligatoriska parametrar

--cluster

Målklusternamn för IoT Operations-distribution.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--add-insecure-listener

När den är aktiverad innehåller Mqtt Broker-distributionen en lyssnare som är bunden till port 1883 utan authN eller authZ.Endast för icke-produktionsarbetsbelastningar.

Godkända värden: false, true
--bfr --broker-frontend-replicas

Mqtt Broker-klientdelsrepliker.

Standardvärde: 2
--bfw --broker-frontend-workers

Mqtt broker frontend workers.

Standardvärde: 2
--broker

Namnet på mqtt-koordinatorn.

Standardvärde: broker
--broker-authn

Namnet på mqtt broker authN.

Standardvärde: authn
--broker-backend-part

Mqtt Broker-serverdelspartitioner.

Standardvärde: 2
--broker-backend-rf

Mqtt broker backend redundancy factor.

Standardvärde: 2
--broker-backend-workers

Mqtt broker backend workers.

Standardvärde: 2
--broker-config-file

Sökväg till en json-fil med anpassade egenskaper för koordinatorkonfiguration. Användbart för avancerade scenarier. Det förväntade formatet beskrivs i https://aka.ms/aziotops-broker-config.

--broker-listener

Lyssnarnamnet för mqtt-koordinatorn.

Standardvärde: listener
--broker-mem-profile

Mqtt-koordinatorminnesprofil.

Godkända värden: High, Low, Medium, Tiny
Standardvärde: Medium
--broker-service-type

Mqtt-koordinatortjänsttyp.

Godkända värden: ClusterIp, LoadBalancer, NodePort
Standardvärde: ClusterIp
--ca-dir

Den lokala katalogen som den genererade test-CA:en och den privata nyckeln placeras i. Om ingen katalog anges skrivs inga filer till disken. Gäller när ingen --ca-file och --ca-key-file tillhandahålls.

--ca-file

Sökvägen till önskad CA-fil i PEM-format.

--ca-key-file

Sökvägen till ca:ens privata nyckelfil i PEM-format. ! Krävs! när --ca-file tillhandahålls.

--ca-valid-days

Alternativ för att styra varaktigheten i dagar för den init-genererade x509 CA:en. Gäller om --ca-file och --ca-key-file inte tillhandahålls.

Standardvärde: 365
--cluster-namespace

Infra för klusternamnområdet IoT Operations distribueras till. Måste vara gemener.

Standardvärde: azure-iot-operations
--context

Kubeconfig-kontextnamn som ska användas för k8s-klusterkommunikation. Om ingen kontext anges används current_context.

--csi-config

Anpassad konfiguration av CSI-drivrutinstillägg. Formatet är blankstegsavgränsade nyckel=värdepar. --csi-config kan användas en eller flera gånger.

--csi-ver

CSI-drivrutinstilläggsversion.

Standardvärde: 1.5.6
--custom-location

Det anpassade platsnamnet som motsvarar IoT Operations-distributionen. Standardvärdet är i formatet {cluster_name}-{token}-ops-init-cl.

--desc

Beskrivning av IoT Operations-instansen.

--df-profile-instances

Antalet instanser som är associerade med standardprofilen för dataflöde.

Standardvärde: 1
--disable-rotation

Flagga för att inaktivera hemlig rotation.

Godkända värden: false, true
--disable-rsync-rules

Regler för resurssynkronisering tas inte med i IoT Operations-distributionen.

Godkända värden: false, true
--ensure-latest

Se till att den senaste IoT Ops CLI används, vilket ger upphov till ett fel om en uppgradering är tillgänglig.

Godkända värden: false, true
--kubernetes-distro

Kubernetes-distributionen som ska användas för Akri-konfiguration. Den valda distributionen innebär standardsökvägen för containerkörningssocketen när inget --runtime-socket-värde anges.

Godkända värden: k3s, k8s, microk8s
Standardvärde: k8s
--kv-id

Key Vault ARM-resurs-ID. Om du anger det här resurs-ID:t kan klienten konfigurera alla nödvändiga resurser och konfiguration på klustersidan för att aktivera Key Vault CSI-drivrutinen för IoT-åtgärder.

--kv-spc-secret-name

Det Nyckelvalvshemlighetsnamn som ska användas som standard-SPC-hemlighet. Om hemligheten inte finns skapas den med ett kryptografiskt säkert platshållarvärde.

Standardvärde: azure-iot-operations
--location

ARM-platsen som ska användas för etablerade RPSaaS-säkerheter. Om det inte anges används den anslutna klusterplatsen.

--name -n

IoT Operations-instansens namn. Standardvärdet är i formatet {cluster_name}-ops-instance.

--no-block

Returnera omedelbart efter att IoT Operations-distributionen har startats.

Godkända värden: false, true
--no-deploy

Arbetsflödet för IoT Operations-distributionen hoppas över.

Godkända värden: false, true
--no-progress

Inaktivera visuell representation av arbete.

Godkända värden: false, true
--no-tls

TLS-konfigurationsarbetsflödet hoppas över.

Godkända värden: false, true
--rotation-int

Rotationsmätningsintervall.

Standardvärde: 1h
--runtime-socket

Standardnodsökvägen för containerkörningssocketen. Om den inte anges (standard) bestäms socketsökvägen av --kubernetes-distro.

--show-template

Flagga när den anges, matar ut mallen som är avsedd för distribution.

Godkända värden: false, true
--simulate-plc

Flagga när den ställs in, konfigurerar OPC-UA broker installer för att starta en PLC-server.

Godkända värden: false, true
--sp-app-id

App-ID för tjänstens huvudnamn. Om detta anges kommer att användas för CSI-drivrutinskonfiguration. Annars skapas en appregistrering. Krävs om det inloggade huvudkontot inte har behörighet att köra frågor mot grafen.

--sp-object-id

Objekt-ID för tjänstens huvudnamn (sp). Om detta anges kommer att användas för CSI-drivrutinskonfiguration. Annars kommer objekt-ID:t att frågas från app-ID:t – skapa sp om det inte finns något. Krävs om det inloggade huvudkontot inte har behörighet att köra frågor mot grafen. Använd az ad sp show --id <app Id> --query id -o tsv för att skapa rätt objekt-ID. Du kan också navigera till Företagsprogram i Entra-ID-klientorganisationen med hjälp av portalen.

--sp-secret

Hemligheten som motsvarar det angivna app-ID:t för tjänstens huvudnamn. Om detta anges kommer att användas för CSI-drivrutinskonfiguration. Annars skapas en ny hemlighet. Krävs om det inloggade huvudkontot inte har behörighet att köra frågor mot grafen.

--sp-secret-valid-days

Alternativ för att styra varaktigheten i dagar för den init-genererade tjänstens huvudnamnshemlighet. Gäller om --sp-secret inte har angetts.

Standardvärde: 365
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops list

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Lista IoT Operations-instanser.

Använd --query med önskad JMESPath-syntax för att köra frågor mot resultatet.

az iot ops list [--resource-group]

Exempel

Visa en lista över alla instanser i prenumerationen.

az iot ops list

Visa en lista över alla instanser av en viss resursgrupp.

az iot ops list -g myresourcegroup

Visa en lista över instanser i prenumerationen som har ett visst taggvärde.

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

Valfria parametrar

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops show

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Visa en IoT Operations-instans.

Alternativt kan kommandot mata ut en trädstruktur med associerade resurser som representerar IoT Operations-distributionen mot säkerhetskopieringsklustret.

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

Exempel

Grundläggande användning för att visa en instans.

az iot ops show --name myinstance -g myresourcegroup

Mata ut en trädstruktur med associerade resurser som representerar IoT Operations-distributionen.

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

Obligatoriska parametrar

--name -n

IoT Operations-instansens namn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--tree

Använd för att visualisera IoT Operations-distributionen mot säkerhetskopieringsklustret.

Godkända värden: false, true
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops update

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Uppdatera en IoT Operations-instans.

För närvarande kan instanstaggar och beskrivning uppdateras.

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

Exempel

Uppdatera instanstaggar. Detta motsvarar en ersättning.

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

Ta bort instanstaggar.

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

Uppdatera instansbeskrivningen.

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

Obligatoriska parametrar

--name -n

IoT Operations-instansens namn.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--desc

Beskrivning av IoT Operations-instansen.

--tags

Instanstaggar. Egenskapsväska i nyckel/värde-par med följande format: a=b c=d.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az iot ops verify-host

Förhandsgranskning

Kommandogruppen "iot ops" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Kör en uppsättning klustervärdverifieringar för IoT Operations-distributionskompatibilitet.

Avsett att köras direkt på en målklustervärd. Kommandot kan uppmana till att tillämpa en uppsättning privilegierade åtgärder, till exempel att installera ett beroende. I det här fallet måste CLI köras med förhöjd behörighet. Till exempel sudo AZURE_EXTENSION_DIR=~/.azure/cliextensions az iot ops verify-host.

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

Valfria parametrar

--no-progress

Inaktivera visuell representation av arbete.

Godkända värden: false, true
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.