az iot du device class

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

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

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

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

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

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

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

--filter

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.

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

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

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

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

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

--best-update

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.

akceptowane wartości: false, true

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

--installable-updates

Flaga wskazująca, że polecenie powinno pobrać możliwe do zainstalowania aktualizacje dla klasy urządzenia.

akceptowane wartości: false, true

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

--update-compliance

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.

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

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

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

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

--friendly-name

Przyjazna nazwa klasy urządzenia. Przyjazna nazwa musi zawierać od 1 do 100 znaków i obsługuje wartości alfanumeryczne, kropkowe i kreskowe.

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