az iot du device class
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 class . Dowiedz się więcej o rozszerzeniach.
Zarządzanie klasą urządzeń i podgrupą klas urządzeń.
Klasa urządzenia opisuje zestaw urządzeń, które współdzielą wspólny zestaw atrybutów między grupami, podczas gdy podgrupa klasy urządzeń jest podzbiorem urządzeń w grupie, która współużytkuje ten sam identyfikator klasy urządzenia. Klasy urządzeń są tworzone automatycznie, gdy urządzenia z obsługą aktualizacji urządzeń są połączone z koncentratorem.
Polecenia
Nazwa | Opis | Typ | Stan |
---|---|---|---|
az iot du device class delete |
Usuń klasę urządzenia lub podgrupę klasy urządzeń. |
Numer wewnętrzny | Ogólna dostępność |
az iot du device class list |
Wyświetlanie listy klas urządzeń lub podgrup klas urządzeń. |
Numer wewnętrzny | Ogólna dostępność |
az iot du device class show |
Pokaż szczegółowe informacje o klasie urządzeń lub podgrupie klasy urządzeń, w tym aktualizacje możliwe do zainstalowania, najlepszą aktualizację i zgodność aktualizacji. |
Numer wewnętrzny | Ogólna dostępność |
az iot du device class update |
Aktualizowanie klasy urządzenia. |
Numer wewnętrzny | Ogólna dostępność |
az iot du device class delete
Usuń klasę urządzenia lub podgrupę klasy urządzeń.
Klasy urządzeń są tworzone automatycznie, gdy urządzenia z włączoną aktualizacją urządzeń są połączone z koncentratorem, ale nie są automatycznie czyszczone, ponieważ są przywoływane przez podgrupy klas urządzeń. Jeśli wszystkie podgrupy klas urządzeń dla docelowej klasy urządzeń zostaną usunięte, można również usunąć samą klasę urządzenia, aby usunąć rekordy z systemu i zatrzymać sprawdzanie zgodności klasy urządzenia z nowymi aktualizacjami. Jeśli urządzenie zostanie kiedykolwiek ponownie połączone, jego klasa urządzenia zostanie ponownie utworzona, jeśli nie istnieje.
az iot du device class delete --account
--cid
--instance
[--gid]
[--resource-group]
[--yes {false, true}]
Przykłady
Usuń klasę urządzenia.
az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id}
Usuń klasę urządzenia i pomiń monit o potwierdzenie.
az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} -y
Usuń podgrupę klasy urządzeń.
az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_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.
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 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 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 class list
Wyświetlanie listy klas urządzeń lub podgrup klas urządzeń.
az iot du device class list --account
--instance
[--filter]
[--gid]
[--resource-group]
Przykłady
Wyświetlanie listy klas urządzeń w ramach wystąpienia.
az iot du device class list -n {account_name} -i {instance_name}
Wyświetlanie listy klas urządzeń wystąpień filtrowanych według przyjaznej nazwy.
az iot du device class list -n {account_name} -i {instance_name} --filter "friendlyName eq 'my-favorite-class'"
Wyświetlanie listy podgrup klas urządzeń dla grupy.
az iot du device class list -n {account_name} -i {instance_name} --group-id {device_group_id}
Wyświetl listę podgrup klas urządzeń dla grupy, filtrowanych według wartości compatProperties/manufacturer.
az iot du device class list -n {account_name} -i {instance_name} --group-id {device_group_id} --filter "compatProperties/manufacturer eq 'Contoso'"
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>
.
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
W przypadku podania parametru --group-id obsługuje filtrowanie na podstawie nazw właściwości i wartości klasy urządzenia. Na przykład "compatProperties/manufacturer eq 'Contoso'". W przeciwnym razie obsługuje filtrowanie według przyjaznej nazwy klasy.
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 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 class show
Pokaż szczegółowe informacje o klasie urządzeń lub podgrupie klasy urządzeń, w tym aktualizacje możliwe do zainstalowania, najlepszą aktualizację i zgodność aktualizacji.
az iot du device class show --account
--cid
--instance
[--best-update {false, true}]
[--gid]
[--installable-updates {false, true}]
[--resource-group]
[--update-compliance {false, true}]
Przykłady
Pokaż klasę urządzenia.
az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id}
Pokaż możliwe do zainstalowania aktualizacje dla klasy urządzenia. Ta flaga modyfikuje polecenie w celu zwracania listy.
az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --installable-updates
Pokaż podgrupę klasy urządzeń.
az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id}
Pokaż najlepszą aktualizację dostępną dla podgrupy klasy urządzeń.
az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id} --best-update
Pokaż zgodność aktualizacji dla podgrupy klasy urządzeń.
az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --group-id {device_group_id} --update-compliance
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.
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
Flaga wskazująca, że polecenie powinno pobrać najlepszą dostępną aktualizację dla podgrupy klasy urządzeń, w tym liczbę urządzeń wymagających aktualizacji. Identyfikator grupy jest wymagany dla tej flagi. Najlepszą aktualizacją jest najnowsza aktualizacja spełniająca wszystkie specyfikacje zgodności klasy urządzenia.
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.
Flaga wskazująca, że polecenie powinno pobrać możliwe do zainstalowania aktualizacje dla klasy urządzenia.
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>
.
Flaga wskazująca, że polecenie powinno pobrać informacje o zgodności aktualizacji klasy urządzenia podgrupy urządzeń, takie jak liczba urządzeń w najnowszej aktualizacji, ile jest potrzebnych nowych aktualizacji i ile jest w toku podczas odbierania nowej aktualizacji. Identyfikator grupy jest wymagany dla tej flagi.
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 class update
Aktualizowanie klasy urządzenia.
az iot du device class update --account
--cid
--instance
[--friendly-name]
[--resource-group]
Przykłady
Zaktualizuj przyjazną nazwę klasy urządzenia.
az iot du device class update -n {account_name} -i {instance_name} --class-id {device_class_id} --friendly-name "EU-region"
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.
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
Przyjazna nazwa klasy urządzenia. Przyjazna nazwa musi zawierać od 1 do 100 znaków i obsługuje wartości alfanumeryczne, kropkowe i kreskowe.
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.