az iot du instance

  • Odwołanie

Uwaga

Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.37.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az iot du instance . Dowiedz się więcej o rozszerzeniach.

Zarządzanie wystąpieniami aktualizacji urządzeń.

Polecenia

Nazwa Opis Typ Stan
az iot du instance create

Utwórz wystąpienie usługi Device Update.

 Numer wewnętrzny Ogólna dostępność
az iot du instance delete

Usuń wystąpienie usługi Device Update.

 Numer wewnętrzny Ogólna dostępność
az iot du instance list

Wyświetl listę wystąpień usługi Device Update.

 Numer wewnętrzny Ogólna dostępność
az iot du instance show

Pokaż wystąpienie usługi Device Update.

 Numer wewnętrzny Ogólna dostępność
az iot du instance update

Aktualizowanie wystąpienia usługi Device Update.

 Numer wewnętrzny Ogólna dostępność
az iot du instance wait

Blokuj, dopóki żądany stan zasobu wystąpienia nie zostanie spełniony.

 Numer wewnętrzny Ogólna dostępność

az iot du instance create

Utwórz wystąpienie usługi Device Update.

To polecenie może być również używane do aktualizowania stanu istniejącego wystąpienia.

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

Przykłady

Utwórz wystąpienie z minimalną konfiguracją.

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

Utwórz wystąpienie z włączoną diagnostyką w połączeniu z udostępnionym przez użytkownika kontem magazynu. Uwzględnij tagi.

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

Parametry wymagane

--account -n

Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>.

--instance -i

Nazwa wystąpienia usługi Device Update. Nazwę wystąpienia domyślnego można skonfigurować przy użyciu polecenia az config set defaults.adu_instance=<name>.

--iothub-ids

Identyfikatory zasobów usługi IoT Hub rozdzielone spacjami.

Parametry opcjonalne

--diagnostics-storage-id

Identyfikator zasobu konta magazynu podany przez użytkownika do użycia w kolekcji dzienników diagnostycznych.

--enable-diagnostics

Włącza zbieranie dzienników diagnostycznych.

akceptowane wartości: false, true
--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--resource-group -g

Nazwa grupy zasobów konta usługi Device Update. Grupę domyślną można skonfigurować przy użyciu polecenia az config set defaults.adu_group=<name>.

--tags

Tagi zasobów. Torba właściwości w parach klucz-wartość z następującym formatem: a=b c=d.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot du instance delete

Usuń wystąpienie usługi Device Update.

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

Przykłady

Usuń wystąpienie skojarzone z kontem docelowym.

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

Usuń wystąpienie skojarzone z kontem docelowym i pomiń monit o potwierdzenie.

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

Parametry wymagane

--account -n

Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>.

--instance -i

Nazwa wystąpienia usługi Device Update. Nazwę wystąpienia domyślnego można skonfigurować przy użyciu polecenia az config set defaults.adu_instance=<name>.

Parametry opcjonalne

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--resource-group -g

Nazwa grupy zasobów konta usługi Device Update. Grupę domyślną można skonfigurować przy użyciu polecenia az config set defaults.adu_group=<name>.

--yes -y

Pomiń monity użytkownika. Wskazuje akceptację akcji. Używane głównie w scenariuszach automatyzacji. Wartość domyślna: false.

akceptowane wartości: false, true
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot du instance list

Wyświetl listę wystąpień usługi Device Update.

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

Przykłady

Wyświetl listę wystąpień skojarzonych z kontem docelowym.

az iot du instance list -n {account_name}

Parametry wymagane

--account -n

Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>.

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów konta usługi Device Update. Grupę domyślną można skonfigurować przy użyciu polecenia az config set defaults.adu_group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot du instance show

Pokaż wystąpienie usługi Device Update.

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

Przykłady

Pokaż szczegóły wystąpienia skojarzonego z kontem docelowym.

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

Parametry wymagane

--account -n

Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>.

--instance -i

Nazwa wystąpienia usługi Device Update. Nazwę wystąpienia domyślnego można skonfigurować przy użyciu polecenia az config set defaults.adu_instance=<name>.

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów konta usługi Device Update. Grupę domyślną można skonfigurować przy użyciu polecenia az config set defaults.adu_group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot du instance update

Aktualizowanie wystąpienia usługi Device Update.

Obecnie można zaktualizować następujące właściwości wystąpienia — iotHubs, enableDiagnostics, diagnosticStorageProperties i tags.

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

Przykłady

Ustaw określony atrybut tagu wystąpienia.

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

Włącz diagnostykę i skonfiguruj konto magazynu na potrzeby zbierania dzienników.

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

Parametry wymagane

--account -n

Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>.

--instance -i

Nazwa wystąpienia usługi Device Update. Nazwę wystąpienia domyślnego można skonfigurować przy użyciu polecenia az config set defaults.adu_instance=<name>.

Parametry opcjonalne

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

wartość domyślna: []
--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

wartość domyślna: False
--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

wartość domyślna: False
--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

wartość domyślna: []
--resource-group -g

Nazwa grupy zasobów konta usługi Device Update. Grupę domyślną można skonfigurować przy użyciu polecenia az config set defaults.adu_group=<name>.

--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

wartość domyślna: []
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot du instance wait

Blokuj, dopóki żądany stan zasobu wystąpienia nie zostanie spełniony.

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

Przykłady

Blokuj do momentu usunięcia wystąpienia docelowego.

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

Parametry wymagane

--account -n

Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>.

--instance -i

Nazwa wystąpienia usługi Device Update. Nazwę wystąpienia domyślnego można skonfigurować przy użyciu polecenia az config set defaults.adu_instance=<name>.

Parametry opcjonalne

--created

Zaczekaj na utworzenie polecenia "provisioningState" o godzinie "Succeeded".

wartość domyślna: False
--custom

Poczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Np. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Poczekaj na usunięcie.

wartość domyślna: False
--exists

Zaczekaj, aż zasób istnieje.

wartość domyślna: False
--interval

Interwał sondowania w sekundach.

wartość domyślna: 30
--resource-group -g

Nazwa grupy zasobów konta usługi Device Update. Grupę domyślną można skonfigurować przy użyciu polecenia az config set defaults.adu_group=<name>.

--timeout

Maksymalny czas oczekiwania w sekundach.

wartość domyślna: 3600
--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

wartość domyślna: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.