az iot du device group

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 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ń.	Extension	ogólna dostępność
az iot du device group list	Wyświetlanie listy grup urządzeń w ramach wystąpienia.	Extension	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.	Extension	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 --group-id
                              --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. 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.

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

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

--order-by

Określa kolejność zwracanego zestawu grup. Można zamówić według groupId, deviceCount, createdDateTime, podgrupyWithNewUpdatesAvailableCount, podgrupyWithUpdatesInProgressCount lub podgrupyWithOnLatestUpdateCount.

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

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

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

Właściwość	Wartość
Grupa parametrów:	Update Arguments
Dopuszczalne 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 az config set defaults.adu_group={name}.

Właściwość	Wartość
Grupa parametrów:	Account Identifier Arguments

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

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

Sprzężenie zwrotne

Czy ta strona była pomocna?

Udostępnij przez

az iot du device group

Polecenia

az iot du device group delete

Przykłady

Parametry wymagane

Parametry opcjonalne

az iot du device group list

Przykłady

Parametry wymagane

Parametry opcjonalne

az iot du device group show

Przykłady

Parametry wymagane

Parametry opcjonalne

Sprzężenie zwrotne