az iot du device group

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

Zarządzanie grupami urządzeń.

Grupa urządzeń to kolekcja urządzeń. Grupy urządzeń umożliwiają skalowanie wdrożeń na wiele urządzeń. Każde urządzenie należy do dokładnie jednej grupy urządzeń jednocześnie. Grupa urządzeń jest tworzona automatycznie, gdy urządzenie z włączoną aktualizacją urządzenia jest połączone z centrum i zgłasza jego właściwości.

Polecenia

Nazwa	Opis	Typ	Stan
az iot du device group delete	Usuń grupę urządzeń.	Numer wewnętrzny	Ogólna dostępność
az iot du device group list	Wyświetlanie listy grup urządzeń w ramach wystąpienia.	Numer wewnętrzny	Ogólna dostępność
az iot du device group show	Pokaż szczegóły dotyczące grupy urządzeń, w tym najlepszą aktualizację i zgodność aktualizacji.	Numer wewnętrzny	Ogólna dostępność

az iot du device group delete

Usuń grupę urządzeń.

Grupy urządzeń nie są automatycznie czyszczone, ale są zachowywane do celów historycznych. Tej operacji można użyć, jeśli nie ma potrzeby grupy lub trzeba zachować historię dla niej. Jeśli urządzenie jest kiedykolwiek połączone ponownie dla grupy po usunięciu grupy, zostanie automatycznie utworzone ponownie bez historii.

az iot du device group delete --account
                              --gid
                              --instance
                              [--resource-group]
                              [--yes {false, true}]

Przykłady

Usuń grupę urządzeń.

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

Usuń grupę urządzeń pomijając monit o potwierdzenie.

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

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

--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 polecenia az config set defaults.adu_instance=<name>.

Parametry opcjonalne

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

Wyświetlanie listy grup urządzeń w ramach wystąpienia.

az iot du device group list --account
                            --instance
                            [--order-by]
                            [--resource-group]

Przykłady

Wyświetlanie listy grup urządzeń.

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

Wyświetl listę grup urządzeń w żądanej kolejności, w tym przypadku według wartości deviceCount.

az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCount

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

--order-by

Określa kolejność zwracanego zestawu grup. Można zamówić według groupId, deviceCount, createdDateTime, podgrupWithNew Aktualizacje AvailableCount, podgrupyWith Aktualizacje InProgressCount lub podgrupyWithOnLatestUpdateCount.

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

Pokaż szczegóły dotyczące grupy urządzeń, w tym najlepszą aktualizację i zgodność aktualizacji.

az iot du device group show --account
                            --gid
                            --instance
                            [--best-updates {false, true}]
                            [--resource-group]
                            [--update-compliance {false, true}]

Przykłady

Pokaż grupę urządzeń.

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

Pokaż najlepsze aktualizacje dostępne dla grupy urządzeń. Ta flaga modyfikuje polecenie w celu zwracania listy.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --best-updates

Pokaż zgodność aktualizacji dla grupy urządzeń.

az iot du device group show -n {account_name} -i {instance_name} --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>.

--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 polecenia az config set defaults.adu_instance=<name>.

Parametry opcjonalne

--best-updates

Flaga wskazująca, że polecenie powinno pobrać najlepsze dostępne aktualizacje dla grupy urządzeń, w tym liczbę urządzeń wymagających każdej aktualizacji. Najlepszą aktualizacją jest najnowsza aktualizacja spełniająca wszystkie specyfikacje zgodności 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 grupy urządzeń, takie jak liczba urządzeń w najnowszej aktualizacji, ile jest potrzebnych nowych aktualizacji i ile jest w toku podczas odbierania nowej aktualizacji.

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.