Udostępnij przez


az iot du device deployment

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 device deployment. Dowiedz się więcej o rozszerzeniach.

Zarządzanie wdrażaniem urządzeń.

Wdrożenia będą stosować żądaną zgodną aktualizację dla docelowej grupy urządzeń, która dystrybuuje aktualizację między klasy urządzeń w grupie. Zasady wycofywania inicjowane przez chmurę można opcjonalnie skonfigurować.

Polecenia

Nazwa Opis Typ Stan
az iot du device deployment cancel

Anulowanie wdrożenia podgrupy klas urządzeń.

Extension ogólna dostępność
az iot du device deployment create

Utwórz wdrożenie dla grupy urządzeń. Wdrożenie będzie rzutować wielowymiarowo względem każdej podgrupy klasy urządzeń w grupie docelowej.

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

Usuń wdrożenie według grupy urządzeń lub podgrupy klas urządzeń.

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

Wyświetlanie listy wdrożeń dla grupy urządzeń lub podgrupy klas urządzeń.

Extension ogólna dostępność
az iot du device deployment list-devices

Wyświetl listę urządzeń we wdrożeniu podgrupy klasy urządzeń wraz ze stanem. Przydatne do uzyskiwania listy urządzeń, które zakończyły się niepowodzeniem.

Extension ogólna dostępność
az iot du device deployment retry

Ponów próbę wdrożenia podgrupy klasy urządzeń.

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

Pokaż wdrożenie dla grupy urządzeń lub podgrupy klas urządzeń, w tym stan, który zawiera szczegóły podziału liczby urządzeń w toku, ukończonych lub zakończonych niepowodzeniem.

Extension ogólna dostępność

az iot du device deployment cancel

Anulowanie wdrożenia podgrupy klas urządzeń.

az iot du device deployment cancel --account
                                   --cid --class-id
                                   --deployment-id --did
                                   --gid --group-id
                                   --instance
                                   [--resource-group]

Przykłady

Anuluj docelowe wdrożenie podgrupy klas urządzeń.

az iot du device deployment cancel -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_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
--cid --class-id

Identyfikator klasy urządzenia. Jest to generowane na podstawie identyfikatora modelu i właściwości zgodności zgłoszonych przez agenta aktualizacji urządzenia w interfejsie PnP aktualizacji urządzenia w usłudze IoT Hub. Jest to skrót SHA1 zakodowany w formacie szesnastkowym.

--deployment-id --did

Identyfikator wdrożenia dostarczonego przez obiekt wywołujący. Nie może to być więcej niż 73 znaki, musi zawierać tylko małe litery i nie może zawierać &znaków , , ^[]{}|<>ukośnika do przodu, ukośnika odwrotnego lub podwójnego cudzysłowu.

--gid --group-id

Identyfikator grupy urządzeń. Jest to tworzone na podstawie wartości tagu ADUGroup w bliźniaczej reprezentacji urządzenia/modułu połączonej usługi IoT Hub lub $default dla urządzeń bez tagu.

--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 device deployment create

Utwórz wdrożenie dla grupy urządzeń. Wdrożenie będzie rzutować wielowymiarowo względem każdej podgrupy klasy urządzeń w grupie docelowej.

az iot du device deployment create --account
                                   --deployment-id --did
                                   --gid --group-id
                                   --instance
                                   --un --update-name
                                   --up --update-provider
                                   --update-version --uv
                                   [--failed-count --fc]
                                   [--failed-percentage --fp]
                                   [--rbun --rollback-update-name]
                                   [--rbup --rollback-update-provider]
                                   [--rbuv --rollback-update-version]
                                   [--resource-group]
                                   [--start-time]

Przykłady

Utwórz wdrożenie grupy urządzeń zaplanowane do natychmiastowego rozpoczęcia (w odniesieniu do czasu UTC).

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version}

Utwórz wdrożenie grupy urządzeń zaplanowane do rozpoczęcia na żądanym zgodnym formacie iso-8601 data/godzina.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --start-time "2022-12-20T01:00:00"

Utwórz wdrożenie grupy urządzeń zaplanowane do natychmiastowego rozpoczęcia od zdefiniowanych zasad wycofywania inicjowanych przez chmurę. Wycofanie chmury jest inicjowane po osiągnięciu liczby nieudanych lub nieudanych celów procentowych.

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --failed-count 10 --failed-percentage 5 --rollback-update-name {rollback_update_name} --rollback-update-provider {rollback_update_provider} --rollback-update-version {rollback_update_version}

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
--deployment-id --did

Identyfikator wdrożenia dostarczonego przez obiekt wywołujący. Nie może to być więcej niż 73 znaki, musi zawierać tylko małe litery i nie może zawierać &znaków , , ^[]{}|<>ukośnika do przodu, ukośnika odwrotnego lub podwójnego cudzysłowu.

--gid --group-id

Identyfikator grupy urządzeń. Jest to tworzone na podstawie wartości tagu ADUGroup w bliźniaczej reprezentacji urządzenia/modułu połączonej usługi IoT Hub lub $default dla urządzeń bez tagu.

--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
--un --update-name

Nazwa aktualizacji.

Właściwość Wartość
Grupa parametrów: Update Id Arguments
--up --update-provider

Dostawca aktualizacji.

Właściwość Wartość
Grupa parametrów: Update Id Arguments
--update-version --uv

Wersja aktualizacji.

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

--failed-count --fc

Liczba całkowita reprezentująca liczbę nieudanych urządzeń we wdrożeniu przed wystąpieniem wycofywania zainicjowanego w chmurze. Wymagane podczas definiowania zasad wycofywania.

Właściwość Wartość
Grupa parametrów: Update Rollback Policy Arguments
--failed-percentage --fp

Liczba całkowita reprezentująca procent nieudanych urządzeń we wdrożeniu przed wystąpieniem wycofywania zainicjowanego w chmurze. Wymagane podczas definiowania zasad wycofywania.

Właściwość Wartość
Grupa parametrów: Update Rollback Policy Arguments
--rbun --rollback-update-name

Nazwa aktualizacji wycofywania.

Właściwość Wartość
Grupa parametrów: Update Rollback Policy Arguments
--rbup --rollback-update-provider

Dostawca aktualizacji wycofywania.

Właściwość Wartość
Grupa parametrów: Update Rollback Policy Arguments
--rbuv --rollback-update-version

Wycofana wersja aktualizacji.

Właściwość Wartość
Grupa parametrów: Update Rollback Policy Arguments
--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
--start-time

Czas rozpoczęcia wdrożenia zgodny ze standardem iso-8601. Jeśli żadna wartość nie zostanie podana, zostanie użyta odpowiednia wartość czasu UTC "now".

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 device deployment delete

Usuń wdrożenie według grupy urządzeń lub podgrupy klas urządzeń.

az iot du device deployment delete --account
                                   --deployment-id --did
                                   --gid --group-id
                                   --instance
                                   [--cid --class-id]
                                   [--resource-group]
                                   [--yes {false, true}]

Przykłady

Usuń docelowe wdrożenie grupy urządzeń.

az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id}

Usuń docelowe wdrożenie podgrupy klas urządzeń.

az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_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
--deployment-id --did

Identyfikator wdrożenia dostarczonego przez obiekt wywołujący. Nie może to być więcej niż 73 znaki, musi zawierać tylko małe litery i nie może zawierać &znaków , , ^[]{}|<>ukośnika do przodu, ukośnika odwrotnego lub podwójnego cudzysłowu.

--gid --group-id

Identyfikator grupy urządzeń. Jest to tworzone na podstawie wartości tagu ADUGroup w bliźniaczej reprezentacji urządzenia/modułu połączonej usługi IoT Hub lub $default dla urządzeń bez tagu.

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

--cid --class-id

Identyfikator klasy urządzenia. Jest to generowane na podstawie identyfikatora modelu i właściwości zgodności zgłoszonych przez agenta aktualizacji urządzenia w interfejsie PnP aktualizacji urządzenia w usłudze IoT Hub. Jest to skrót SHA1 zakodowany w formacie szesnastkowym.

--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 device deployment list

Wyświetlanie listy wdrożeń dla grupy urządzeń lub podgrupy klas urządzeń.

az iot du device deployment list --account
                                 --gid --group-id
                                 --instance
                                 [--cid --class-id]
                                 [--order-by]
                                 [--resource-group]

Przykłady

Wyświetlanie listy wdrożeń dla grupy urządzeń.

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id}

Wyświetl listę wdrożeń dla wyników porządkowania grup urządzeń według startDateTime malejąco.

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --order-by "startDateTime desc"

Wyświetlanie listy wdrożeń dla podgrupy klasy urządzeń.

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_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
--gid --group-id

Identyfikator grupy urządzeń. Jest to tworzone na podstawie wartości tagu ADUGroup w bliźniaczej reprezentacji urządzenia/modułu połączonej usługi IoT Hub lub $default dla urządzeń bez tagu.

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

--cid --class-id

Identyfikator klasy urządzenia. Jest to generowane na podstawie identyfikatora modelu i właściwości zgodności zgłoszonych przez agenta aktualizacji urządzenia w interfejsie PnP aktualizacji urządzenia w usłudze IoT Hub. Jest to skrót SHA1 zakodowany w formacie szesnastkowym.

--order-by

Kolejność zwracanych zestawów wdrożeń. Możesz zamówić od startDateTime [desc/asc].

--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 device deployment list-devices

Wyświetl listę urządzeń we wdrożeniu podgrupy klasy urządzeń wraz ze stanem. Przydatne do uzyskiwania listy urządzeń, które zakończyły się niepowodzeniem.

az iot du device deployment list-devices --account
                                         --cid --class-id
                                         --deployment-id --did
                                         --gid --group-id
                                         --instance
                                         [--filter]
                                         [--resource-group]

Przykłady

Wyświetlanie listy urządzeń we wdrożeniu podgrupy klasy urządzeń.

az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}

Wyświetlanie listy urządzeń w podgrupie urządzeń filtrowanie wdrożenia podgrup według identyfikatorów deviceId i deviceState.

az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --filter "deviceId eq 'd0' and deviceState eq 'InProgress'"

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
--cid --class-id

Identyfikator klasy urządzenia. Jest to generowane na podstawie identyfikatora modelu i właściwości zgodności zgłoszonych przez agenta aktualizacji urządzenia w interfejsie PnP aktualizacji urządzenia w usłudze IoT Hub. Jest to skrót SHA1 zakodowany w formacie szesnastkowym.

--deployment-id --did

Identyfikator wdrożenia dostarczonego przez obiekt wywołujący. Nie może to być więcej niż 73 znaki, musi zawierać tylko małe litery i nie może zawierać &znaków , , ^[]{}|<>ukośnika do przodu, ukośnika odwrotnego lub podwójnego cudzysłowu.

--gid --group-id

Identyfikator grupy urządzeń. Jest to tworzone na podstawie wartości tagu ADUGroup w bliźniaczej reprezentacji urządzenia/modułu połączonej usługi IoT Hub lub $default dla urządzeń bez tagu.

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

--filter

Ogranicza zwracany zestaw stanów urządzeń wdrażania. Można filtrować według identyfikatorów deviceId i moduleId i/lub deviceState.

--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 device deployment retry

Ponów próbę wdrożenia podgrupy klasy urządzeń.

az iot du device deployment retry --account
                                  --cid --class-id
                                  --deployment-id --did
                                  --gid --group-id
                                  --instance
                                  [--resource-group]

Przykłady

Ponów próbę wdrożenia docelowej podgrupy klas urządzeń.

az iot du device deployment retry -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_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
--cid --class-id

Identyfikator klasy urządzenia. Jest to generowane na podstawie identyfikatora modelu i właściwości zgodności zgłoszonych przez agenta aktualizacji urządzenia w interfejsie PnP aktualizacji urządzenia w usłudze IoT Hub. Jest to skrót SHA1 zakodowany w formacie szesnastkowym.

--deployment-id --did

Identyfikator wdrożenia dostarczonego przez obiekt wywołujący. Nie może to być więcej niż 73 znaki, musi zawierać tylko małe litery i nie może zawierać &znaków , , ^[]{}|<>ukośnika do przodu, ukośnika odwrotnego lub podwójnego cudzysłowu.

--gid --group-id

Identyfikator grupy urządzeń. Jest to tworzone na podstawie wartości tagu ADUGroup w bliźniaczej reprezentacji urządzenia/modułu połączonej usługi IoT Hub lub $default dla urządzeń bez tagu.

--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 device deployment show

Pokaż wdrożenie dla grupy urządzeń lub podgrupy klas urządzeń, w tym stan, który zawiera szczegóły podziału liczby urządzeń w toku, ukończonych lub zakończonych niepowodzeniem.

az iot du device deployment show --account
                                 --deployment-id --did
                                 --gid --group-id
                                 --instance
                                 [--cid --class-id]
                                 [--resource-group]
                                 [--status {false, true}]

Przykłady

Pokaż wdrożenie dla grupy urządzeń.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id}

Pokaż stan wdrożenia grupy urządzeń.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --status

Pokaż wdrożenie podgrupy klasy urządzeń.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}

Pokaż stan wdrożenia podgrupy klasy urządzeń.

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --status

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
--deployment-id --did

Identyfikator wdrożenia dostarczonego przez obiekt wywołujący. Nie może to być więcej niż 73 znaki, musi zawierać tylko małe litery i nie może zawierać &znaków , , ^[]{}|<>ukośnika do przodu, ukośnika odwrotnego lub podwójnego cudzysłowu.

--gid --group-id

Identyfikator grupy urządzeń. Jest to tworzone na podstawie wartości tagu ADUGroup w bliźniaczej reprezentacji urządzenia/modułu połączonej usługi IoT Hub lub $default dla urządzeń bez tagu.

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

--cid --class-id

Identyfikator klasy urządzenia. Jest to generowane na podstawie identyfikatora modelu i właściwości zgodności zgłoszonych przez agenta aktualizacji urządzenia w interfejsie PnP aktualizacji urządzenia w usłudze IoT Hub. Jest to skrót SHA1 zakodowany w formacie szesnastkowym.

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

Pobiera stan wdrożenia, w tym podział liczby urządzeń w toku, ukończonych lub zakończonych niepowodzeniem.

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