az iot du device deployment
Uwaga
Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.46.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ń. |
Numer wewnętrzny | 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. |
Numer wewnętrzny | Ogólna dostępność |
az iot du device deployment delete |
Usuń wdrożenie według grupy urządzeń lub podgrupy klas urządzeń. |
Numer wewnętrzny | Ogólna dostępność |
az iot du device deployment list |
Wyświetlanie listy wdrożeń dla grupy urządzeń lub podgrupy klas urządzeń. |
Numer wewnętrzny | 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. |
Numer wewnętrzny | Ogólna dostępność |
az iot du device deployment retry |
Ponów próbę wdrożenia podgrupy klasy urządzeń. |
Numer wewnętrzny | 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. |
Numer wewnętrzny | 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
--deployment-id
--gid
--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
Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>
.
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.
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.
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.
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
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
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
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
--gid
--instance
--un
--up
--update-version
[--failed-count]
[--failed-percentage]
[--rbun]
[--rbup]
[--rbuv]
[--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
Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>
.
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.
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.
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>
.
Nazwa aktualizacji.
Dostawca aktualizacji.
Wersja aktualizacji.
Parametry opcjonalne
Liczba całkowita reprezentująca liczbę nieudanych urządzeń we wdrożeniu przed wystąpieniem wycofywania zainicjowanego w chmurze. Wymagane podczas definiowania zasad wycofywania.
Liczba całkowita reprezentująca procent nieudanych urządzeń we wdrożeniu przed wystąpieniem wycofywania zainicjowanego w chmurze. Wymagane podczas definiowania zasad wycofywania.
Nazwa aktualizacji wycofywania.
Dostawca aktualizacji wycofywania.
Wycofana wersja aktualizacji.
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>
.
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
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
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
--gid
--instance
[--cid]
[--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
Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>
.
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.
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.
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
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.
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>
.
Pomiń monity użytkownika. Wskazuje akceptację akcji. Używane głównie w scenariuszach automatyzacji. Wartość domyślna: false.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
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
--instance
[--cid]
[--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
Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>
.
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.
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
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.
Kolejność zwracanych zestawów wdrożeń. Możesz zamówić od startDateTime [desc/asc].
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
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
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
--deployment-id
--gid
--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
Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>
.
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.
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.
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.
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
Ogranicza zwracany zestaw stanów urządzeń wdrażania. Można filtrować według identyfikatorów deviceId i moduleId i/lub deviceState.
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
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
az iot du device deployment retry
Ponów próbę wdrożenia podgrupy klasy urządzeń.
az iot du device deployment retry --account
--cid
--deployment-id
--gid
--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
Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>
.
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.
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.
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.
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
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
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
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
--gid
--instance
[--cid]
[--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
Nazwa konta usługi Device Update. Domyślną nazwę konta można skonfigurować przy użyciu polecenia az config set defaults.adu_account=<name>
.
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.
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.
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
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.
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>
.
Pobiera stan wdrożenia, w tym podział liczby urządzeń w toku, ukończonych lub zakończonych niepowodzeniem.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.