az sphere device-group

Note

To odwołanie jest częścią rozszerzenia azure-sphere dla Azure CLI (wersja 2.45.0 lub nowsza). Rozszerzenie automatycznie zainstaluje polecenie az sphere device-group. Dowiedz się więcej o rozszerzeniach.

Zarządzanie grupami urządzeń w grupie zasobów i katalogu.

Polecenia

Nazwisko Opis Typ Stan
az sphere device-group create

Utwórz grupę urządzeń.

 Extension ogólna dostępność
az sphere device-group create-defaults

Utwórz domyślne grupy urządzeń przeznaczone dla produktu.

 Extension ogólna dostępność
az sphere device-group delete

Usuń określoną grupę urządzeń.

 Extension ogólna dostępność
az sphere device-group list

Wyświetl listę wszystkich grup urządzeń w wykazie.

 Extension ogólna dostępność
az sphere device-group show

Pokaż szczegóły grupy urządzeń.

 Extension ogólna dostępność
az sphere device-group update

Zaktualizuj szczegóły grupy urządzeń.

 Extension ogólna dostępność

az sphere device-group create

Utwórz grupę urządzeń.

az sphere device-group create --catalog
                              --description
                              --name
                              --product
                              --resource-group
                              [--acquire-policy-token]
                              [--allow-crash-dumps-collection {Disabled, Enabled}]
                              [--application-update {No3rdPartyAppUpdates, UpdateAll}]
                              [--change-reference]
                              [--os-feed {Retail, RetailEval}]
                              [--regional-data-boundary {EU, None}]

Przykłady

Utwórz nową grupę urządzeń "MyDeviceGroup" w grupie zasobów "MyResourceGroup", katalogu "MyCatalog", produktu "MyProduct", opisu "MyDescription" i domyślnej granicy danych regionalnych.

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --name MyDeviceGroup --description MyDescription

Utwórz nową grupę urządzeń "MyDeviceGroup" w grupie zasobów "MyResourceGroup", wykaz "MyCatalog", produkt "MyProduct", opis "MyDescription" i określ regionalną granicę danych.

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --name MyDeviceGroup --description MyDescription --regional-data-boundary EU

Parametry wymagane

--catalog -c

Wykaz Azure Sphere, w którym ma być wykonywana ta operacja. Określ nazwę katalogu Azure Sphere. Domyślny katalog Azure Sphere można skonfigurować przy użyciu az config set defaults.sphere.catalog=<name>. Wartości z: az sphere catalog list.

--description -d

Opis grupy urządzeń.

--name -n

Alfanumeryczna nazwa grupy urządzeń.

--product -p

Nazwa produktu.

Właściwość Wartość
Wartość od: az sphere product list
--resource-group -g

Nazwa grupy zasobów Azure. Grupę domyślną można skonfigurować przy użyciu az config set defaults.group=<name>. Wartości z: az group list.

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.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--allow-crash-dumps-collection -cd

Podaj zgodę na zbieranie zrzutów awaryjnych według Microsoft dla tej grupy urządzeń. Aby uzyskać więcej informacji, zobacz https://aka.ms/AzureSphereCrashDumpsCollection.

Właściwość Wartość
Domyślna wartość: Disabled
Dopuszczalne wartości: Disabled, Enabled
--application-update -a

Zasady aktualizacji aplikacji dla tej grupy urządzeń.

Właściwość Wartość
Domyślna wartość: UpdateAll
Dopuszczalne wartości: No3rdPartyAppUpdates, UpdateAll
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--os-feed -f

Typ kanału informacyjnego systemu operacyjnego do użycia na potrzeby aktualizacji systemu operacyjnego.

Właściwość Wartość
Domyślna wartość: Retail
Dopuszczalne wartości: Retail, RetailEval
--regional-data-boundary -r

Regionalna granica danych dla tej grupy urządzeń.

Właściwość Wartość
Domyślna wartość: None
Dopuszczalne wartości: EU, None
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 sphere device-group create-defaults

Utwórz domyślne grupy urządzeń przeznaczone dla produktu.

az sphere device-group create-defaults --catalog
                                       --product
                                       --resource-group
                                       [--acquire-policy-token]
                                       [--change-reference]

Przykłady

Utwórz domyślne grupy urządzeń w grupie zasobów "MyResourceGroup", katalogu "MyCatalog" i produktu "MyProduct".

az sphere device-group create-defaults --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

Parametry wymagane

--catalog -c

Wykaz Azure Sphere, w którym ma być wykonywana ta operacja. Określ nazwę katalogu Azure Sphere. Domyślny katalog Azure Sphere można skonfigurować przy użyciu az config set defaults.sphere.catalog=<name>. Wartości z: az sphere catalog list.

--product -p

Nazwa produktu.

Właściwość Wartość
Wartość od: az sphere product list
--resource-group -g

Nazwa grupy zasobów Azure. Grupę domyślną można skonfigurować przy użyciu az config set defaults.group=<name>. Wartości z: az group list.

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.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy 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 sphere device-group delete

Usuń określoną grupę urządzeń.

az sphere device-group delete --catalog
                              --device-group
                              --product
                              --resource-group
                              [--acquire-policy-token]
                              [--change-reference]

Przykłady

Usuń grupę urządzeń przy użyciu grupy zasobów, nazwy katalogu, nazwy produktu i nazwy grupy urządzeń.

az sphere device-group delete --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

Parametry wymagane

--catalog -c

Wykaz Azure Sphere, w którym ma być wykonywana ta operacja. Określ nazwę katalogu Azure Sphere. Domyślny katalog Azure Sphere można skonfigurować przy użyciu az config set defaults.sphere.catalog=<name>. Wartości z: az sphere catalog list.

--device-group -dg

Nazwa grupy urządzeń.

Właściwość Wartość
Wartość od: az sphere device-group list
--product -p

Produkt, dla którego mają zostać usunięte grupy urządzeń.

Właściwość Wartość
Wartość od: az sphere product list
--resource-group -g

Nazwa grupy zasobów Azure. Grupę domyślną można skonfigurować przy użyciu az config set defaults.group=<name>. Wartości z: az group list.

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.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy 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 sphere device-group list

Wyświetl listę wszystkich grup urządzeń w wykazie.

az sphere device-group list --catalog
                            --resource-group
                            [--device-group]
                            [--product]

Przykłady

Wyświetl listę wszystkich grup urządzeń w grupie zasobów i katalogu.

az sphere device-group list --resource-group MyResourceGroup --catalog MyCatalog

Wyświetl listę wszystkich grup urządzeń o określonej nazwie w grupie zasobów i katalogu.

az sphere device-group list --resource-group MyResourceGroup --catalog MyCatalog --device-group Development

Wyświetl listę wszystkich grup urządzeń w grupie zasobów, katalogu i produkcie.

az sphere device-group list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

Parametry wymagane

--catalog -c

Wykaz Azure Sphere, w którym ma być wykonywana ta operacja. Określ nazwę katalogu Azure Sphere. Domyślny katalog Azure Sphere można skonfigurować przy użyciu az config set defaults.sphere.catalog=<name>. Wartości z: az sphere catalog list.

--resource-group -g

Nazwa grupy zasobów Azure. Grupę domyślną można skonfigurować przy użyciu az config set defaults.group=<name>. Wartości z: az group list.

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.

--device-group -dg

Wyświetl listę wszystkich grup urządzeń, które mają określoną nazwę.

--product -p

Wyświetl listę wszystkich grup urządzeń w produkcie.

Właściwość Wartość
Wartość od: az sphere product list
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 sphere device-group show

Pokaż szczegóły grupy urządzeń.

az sphere device-group show --catalog
                            --device-group
                            --product
                            --resource-group

Przykłady

Pokaż szczegóły grupy urządzeń przy użyciu grupy zasobów, nazwy katalogu, nazwy produktu i nazwy grupy urządzeń.

az sphere device-group show --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

Parametry wymagane

--catalog -c

Wykaz Azure Sphere, w którym ma być wykonywana ta operacja. Określ nazwę katalogu Azure Sphere. Domyślny katalog Azure Sphere można skonfigurować przy użyciu az config set defaults.sphere.catalog=<name>. Wartości z: az sphere catalog list.

--device-group -dg

Grupa urządzeń do pokazania.

Właściwość Wartość
Wartość od: az sphere device-group list
--product -p

Nazwa produktu, dla którego ma być wyświetlana grupa urządzeń.

Właściwość Wartość
Wartość od: az sphere product list
--resource-group -g

Nazwa grupy zasobów Azure. Grupę domyślną można skonfigurować przy użyciu az config set defaults.group=<name>. Wartości z: az group list.

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 sphere device-group update

Zaktualizuj szczegóły grupy urządzeń.

az sphere device-group update --catalog
                              --device-group
                              --product
                              --resource-group
                              [--acquire-policy-token]
                              [--allow-crash-dumps-collection {Disabled, Enabled}]
                              [--application-update {No3rdPartyAppUpdates, UpdateAll}]
                              [--change-reference]
                              [--description]
                              [--os-feed {Retail, RetailEval}]
                              [--regional-data-boundary {EU, None}]

Przykłady

Zaktualizuj właściwości grupy urządzeń.

az sphere device-group update --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --description NewDescription

Parametry wymagane

--catalog -c

Wykaz Azure Sphere, w którym ma być wykonywana ta operacja. Określ nazwę katalogu Azure Sphere. Domyślny katalog Azure Sphere można skonfigurować przy użyciu az config set defaults.sphere.catalog=<name>. Wartości z: az sphere catalog list.

--device-group -dg

Nazwa grupy urządzeń.

Właściwość Wartość
Wartość od: az sphere device-group list
--product -p

Nazwa produktu.

Właściwość Wartość
Wartość od: az sphere product list
--resource-group -g

Nazwa grupy zasobów Azure. Grupę domyślną można skonfigurować przy użyciu az config set defaults.group=<name>. Wartości z: az group list.

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.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--allow-crash-dumps-collection -cd

Podaj zgodę na zbieranie zrzutów awaryjnych według Microsoft dla tej grupy urządzeń. Aby uzyskać więcej informacji, zobacz https://aka.ms/AzureSphereCrashDumpsCollection.

Właściwość Wartość
Dopuszczalne wartości: Disabled, Enabled
--application-update -a

Zasady aktualizacji aplikacji dla tej grupy urządzeń.

Właściwość Wartość
Dopuszczalne wartości: No3rdPartyAppUpdates, UpdateAll
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--description -d

Nowy opis grupy urządzeń.

--os-feed -f

Typ kanału informacyjnego systemu operacyjnego do użycia na potrzeby aktualizacji systemu operacyjnego.

Właściwość Wartość
Dopuszczalne wartości: Retail, RetailEval
--regional-data-boundary -r

Regionalna granica danych dla tej grupy urządzeń.

Właściwość Wartość
Dopuszczalne wartości: EU, None
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