Dela via

az iot du instance

  • Referens

Kommentar

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

Hantering av enhetsuppdateringsinstanser.

Kommandon

Name Description Typ Status
az iot du instance create

Skapa en enhetsuppdateringsinstans.

 Anknytning Allmän tillgänglighet
az iot du instance delete

Ta bort en instans av enhetsuppdatering.

 Anknytning Allmän tillgänglighet
az iot du instance list

Visa en lista över instanser av enhetsuppdatering.

 Anknytning Allmän tillgänglighet
az iot du instance show

Visa en instans av enhetsuppdatering.

 Anknytning Allmän tillgänglighet
az iot du instance update

Uppdatera en enhetsuppdateringsinstans.

 Anknytning Allmän tillgänglighet
az iot du instance wait

Blockera tills ett önskat instansresurstillstånd har uppfyllts.

 Anknytning Allmän tillgänglighet

az iot du instance create

Skapa en enhetsuppdateringsinstans.

Det här kommandot kan också användas för att uppdatera tillståndet för en befintlig instans.

az iot du instance create --account
                          --instance
                          --iothub-ids
                          [--diagnostics-storage-id]
                          [--enable-diagnostics {false, true}]
                          [--no-wait]
                          [--resource-group]
                          [--tags]

Exempel

Skapa en instans med minsta möjliga konfiguration.

az iot du instance create -n {account_name} -i {instance_name} --iothub-ids {iothub_resource_id}

Skapa en instans med diagnostik aktiverad, tillsammans med ett användarangivet lagringskonto. Inkludera taggar.

az iot du instance create -n {account_name} -i {instance_name} --iothub-ids {iothub_resource_id} --enable-diagnostics --diagnostics-storage-id {storage_account_resource_id} --tags a=b

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

--iothub-ids

Resurs-ID:t för utrymmesavgränsade IoT Hub.

Valfria parametrar

--diagnostics-storage-id

Användardefinerat resurs-ID för lagringskonto för användning i insamling av diagnostikloggar.

--enable-diagnostics

Aktiverar insamling av diagnostikloggar.

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

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_group=<name>

--tags

Resurstaggar. 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 du instance delete

Ta bort en instans av enhetsuppdatering.

az iot du instance delete --account
                          --instance
                          [--no-wait]
                          [--resource-group]
                          [--yes {false, true}]

Exempel

Ta bort en instans som är associerad med målkontot.

az iot du instance delete -n {account_name} -i {instance_name}

Ta bort en instans som är associerad med målkontot och hoppa över bekräftelseprompten.

az iot du instance delete -n {account_name} -i {instance_name} -y

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

Valfria parametrar

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_group=<name>

--yes -y

Hoppa över användarprompter. Anger godkännande av åtgärd. Används främst för automatiseringsscenarier. Standard: falskt.

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 du instance list

Visa en lista över instanser av enhetsuppdatering.

az iot du instance list --account
                        [--resource-group]

Exempel

Lista instanser som är associerade med målkontot.

az iot du instance list -n {account_name}

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

Valfria parametrar

--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_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 du instance show

Visa en instans av enhetsuppdatering.

az iot du instance show --account
                        --instance
                        [--resource-group]

Exempel

Visa information om en instans som är associerad med målkontot.

az iot du instance show -n {account_name} -i {instance_name}

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

Valfria parametrar

--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_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 du instance update

Uppdatera en enhetsuppdateringsinstans.

För närvarande kan följande instansegenskaper uppdateras – iotHubs, enableDiagnostics, diagnosticStorageProperties och taggar.

az iot du instance update --account
                          --instance
                          [--add]
                          [--force-string]
                          [--no-wait]
                          [--remove]
                          [--resource-group]
                          [--set]

Exempel

Ange ett specifikt instanstaggattribut.

az iot du instance update -n {account_name} -i {instance_name} --set tags.env='test'

Aktivera diagnostik och konfigurera ett lagringskonto för logginsamling.

az iot du instance update -n {account_name} -i {instance_name} --set enableDiagnostics=true diagnosticStorageProperties.resourceId={storage_account_resource_id}

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

Valfria parametrar

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

Standardvärde: []
--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

Standardvärde: False
--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

Standardvärde: []
--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_group=<name>

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

Standardvärde: []
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 du instance wait

Blockera tills ett önskat instansresurstillstånd har uppfyllts.

az iot du instance wait --account
                        --instance
                        [--created]
                        [--custom]
                        [--deleted]
                        [--exists]
                        [--interval]
                        [--resource-group]
                        [--timeout]
                        [--updated]

Exempel

Blockera tills målinstansen har tagits bort.

az iot du instance wait -n {account_name} -i {instance_name} --deleted

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

Valfria parametrar

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

Standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

Standardvärde: False
--exists

Vänta tills resursen finns.

Standardvärde: False
--interval

Avsökningsintervall i sekunder.

Standardvärde: 30
--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_group=<name>

--timeout

Maximal väntetid i sekunder.

Standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

Standardvärde: False
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.