Udostępnij przez

az iot du instance

Note

Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.67.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.

 Extension ogólna dostępność
az iot du instance delete

Usuń wystąpienie usługi Device Update.

 Extension ogólna dostępność
az iot du instance list

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

 Extension ogólna dostępność
az iot du instance show

Pokaż wystąpienie usługi Device Update.

 Extension ogólna dostępność
az iot du instance update

Aktualizowanie wystąpienia usługi Device Update.

 Extension ogólna dostępność
az iot du instance wait

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

 Extension 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. Nazwę konta domyślnego można skonfigurować przy użyciu az config set defaults.adu_account={name}.

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments
--instance -i

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

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments
--iothub-ids

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

Właściwość Wartość
Grupa parametrów: IoT Hub Arguments

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--diagnostics-storage-id

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

Właściwość Wartość
Grupa parametrów: Storage Arguments
--enable-diagnostics

Włącza zbieranie dzienników diagnostycznych.

Właściwość Wartość
Dopuszczalne wartości: false, true
--no-wait

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

Właściwość Wartość
Domyślna wartość: False
--resource-group -g

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

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments
--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.

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False

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. Nazwę konta domyślnego można skonfigurować przy użyciu az config set defaults.adu_account={name}.

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments
--instance -i

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

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--no-wait

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

Właściwość Wartość
Domyślna wartość: False
--resource-group -g

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

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments
--yes -y

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

Właściwość Wartość
Dopuszczalne wartości: false, true
Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False

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. Nazwę konta domyślnego można skonfigurować przy użyciu az config set defaults.adu_account={name}.

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--resource-group -g

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

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments
Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False

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. Nazwę konta domyślnego można skonfigurować przy użyciu az config set defaults.adu_account={name}.

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments
--instance -i

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

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--resource-group -g

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

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments
Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False

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. Nazwę konta domyślnego można skonfigurować przy użyciu az config set defaults.adu_account={name}.

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments
--instance -i

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

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

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

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: []
--force-string

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

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: False
--no-wait

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

Właściwość Wartość
Domyślna wartość: False
--remove

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

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: []
--resource-group -g

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

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments
--set

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

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: []
Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False

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. Nazwę konta domyślnego można skonfigurować przy użyciu az config set defaults.adu_account={name}.

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments
--instance -i

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

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--created

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

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: False
--custom

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

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
--deleted

Poczekaj na usunięcie.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: False
--exists

Zaczekaj, aż zasób istnieje.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: False
--interval

Interwał sondowania w sekundach.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: 30
--resource-group -g

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

Właściwość Wartość
Grupa parametrów: Account Identifier Arguments
--timeout

Maksymalny czas oczekiwania w sekundach.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: 3600
--updated

Zaczekaj na zaktualizowanie stanu provisioningState o 'Powodzenie'.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: False
Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False