Freigeben über

az sphere device-group

  • Referenz

Hinweis

Diese Referenz ist Teil der Azure-Kugel-Erweiterung für die Azure CLI (Version 2.45.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az-Kugel-Gerätegruppenbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten sie Gerätegruppen in Ihrer Ressourcengruppe und ihrem Katalog.

Befehle

Name Beschreibung Typ Status
az sphere device-group create

Erstellen einer Gerätegruppe.

 Erweiterung Allgemein verfügbar
az sphere device-group create-defaults

Erstellen Sie Standardgerätegruppen für ein Produkt.

 Erweiterung Allgemein verfügbar
az sphere device-group delete

Löschen Sie die angegebene Gerätegruppe.

 Erweiterung Allgemein verfügbar
az sphere device-group list

Listet alle Gerätegruppen in einem Katalog auf.

 Erweiterung Allgemein verfügbar
az sphere device-group show

Zeigen Sie die Details einer Gerätegruppe an.

 Erweiterung Allgemein verfügbar
az sphere device-group update

Aktualisieren Sie die Details einer Gerätegruppe.

 Erweiterung Allgemein verfügbar

az sphere device-group create

Erstellen einer Gerätegruppe.

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

Beispiele

Erstellen Sie eine neue Gerätegruppe "MyDeviceGroup" in der Ressourcengruppe "MyResourceGroup", Katalog "MyCatalog", Produkt "MyProduct", Beschreibung "MyDescription" und standardregionale Datengrenze.

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

Erstellen Sie eine neue Gerätegruppe "MyDeviceGroup" in der Ressourcengruppe "MyResourceGroup", Katalog "MyCatalog", Produkt "MyProduct", Beschreibung "MyDescription", und geben Sie eine regionale Datengrenze an.

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

Erforderliche Parameter

--catalog -c

Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mithilfe von az config set defaults.sphere.catalog=<name>Azure Sphere konfigurieren. Werte aus: az kugelkatalogliste.

--description -d

Beschreibung der Gerätegruppe.

--name -n

Alphanumerischer Name der Gerätegruppe.

--product -p

Der Produktname.

Wert aus: az sphere product list
--resource-group -g

Der Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name> konfigurieren. Werte aus: az group list.

Optionale Parameter

--allow-crash-dumps-collection -cd

Geben Sie die Zustimmung für die Sammlung von Absturzabbildern von Microsoft für diese Gerätegruppe an. Weitere Informationen finden Sie unter https://aka.ms/AzureSphereCrashDumpsCollection.

Zulässige Werte: Disabled, Enabled
Standardwert: Disabled
--application-update -a

Anwendungsupdaterichtlinie für diese Gerätegruppe.

Zulässige Werte: No3rdPartyAppUpdates, UpdateAll
Standardwert: UpdateAll
--os-feed -f

Der Betriebssystemfeedtyp, der für Betriebssystemupdates verwendet werden soll.

Zulässige Werte: Retail, RetailEval
Standardwert: Retail
--regional-data-boundary -r

Regionale Datengrenze für diese Gerätegruppe.

Zulässige Werte: EU, None
Standardwert: None
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sphere device-group create-defaults

Erstellen Sie Standardgerätegruppen für ein Produkt.

az sphere device-group create-defaults --catalog
                                       --product
                                       --resource-group

Beispiele

Erstellen Sie Standardgerätegruppen in der Ressourcengruppe "MyResourceGroup", Katalog "MyCatalog" und Produkt "MyProduct".

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

Erforderliche Parameter

--catalog -c

Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mithilfe von az config set defaults.sphere.catalog=<name>Azure Sphere konfigurieren. Werte aus: az kugelkatalogliste.

--product -p

Der Produktname.

Wert aus: az sphere product list
--resource-group -g

Der Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name> konfigurieren. Werte aus: az group list.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sphere device-group delete

Löschen Sie die angegebene Gerätegruppe.

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

Beispiele

Löschen Sie eine Gerätegruppe mithilfe der Ressourcengruppe, des Katalognamens, des Produktnamens und des Gerätegruppennamens.

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

Erforderliche Parameter

--catalog -c

Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mithilfe von az config set defaults.sphere.catalog=<name>Azure Sphere konfigurieren. Werte aus: az kugelkatalogliste.

--device-group -dg

Der Gerätegruppenname.

Wert aus: az sphere device-group list
--product -p

Das Produkt, für das die Gerätegruppen gelöscht werden sollen.

Wert aus: az sphere product list
--resource-group -g

Der Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name> konfigurieren. Werte aus: az group list.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sphere device-group list

Listet alle Gerätegruppen in einem Katalog auf.

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

Beispiele

Listet alle Gerätegruppen in einer Ressourcengruppe und einem Katalog auf.

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

Listet alle Gerätegruppen mit dem angegebenen Namen in einer Ressourcengruppe und einem Katalog auf.

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

Listet alle Gerätegruppen in einer Ressourcengruppe, einem Katalog und einem Produkt auf.

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

Erforderliche Parameter

--catalog -c

Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mithilfe von az config set defaults.sphere.catalog=<name>Azure Sphere konfigurieren. Werte aus: az kugelkatalogliste.

--resource-group -g

Der Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name> konfigurieren. Werte aus: az group list.

Optionale Parameter

--device-group -dg

Listet alle Gerätegruppen auf, die einen angegebenen Namen haben.

--product -p

Listet alle Gerätegruppen in einem Produkt auf.

Wert aus: az sphere product list
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sphere device-group show

Zeigen Sie die Details einer Gerätegruppe an.

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

Beispiele

Zeigen Sie Details einer Gerätegruppe mithilfe der Ressourcengruppe, des Katalognamens, des Produktnamens und des Gerätegruppennamens an.

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

Erforderliche Parameter

--catalog -c

Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mithilfe von az config set defaults.sphere.catalog=<name>Azure Sphere konfigurieren. Werte aus: az kugelkatalogliste.

--device-group -dg

Die anzuzeigende Gerätegruppe.

Wert aus: az sphere device-group list
--product -p

Der Produktname, für den die Gerätegruppe angezeigt werden soll.

Wert aus: az sphere product list
--resource-group -g

Der Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name> konfigurieren. Werte aus: az group list.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sphere device-group update

Aktualisieren Sie die Details einer Gerätegruppe.

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

Beispiele

Dient zum Aktualisieren der Eigenschaften einer Gerätegruppe.

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

Erforderliche Parameter

--catalog -c

Der Azure Sphere-Katalog, in dem dieser Vorgang ausgeführt werden soll. Geben Sie den Namen des Azure Sphere-Katalogs an. Sie können den Azure Sphere-Standardkatalog mithilfe von az config set defaults.sphere.catalog=<name>Azure Sphere konfigurieren. Werte aus: az kugelkatalogliste.

--device-group -dg

Der Gerätegruppenname.

Wert aus: az sphere device-group list
--product -p

Der Produktname.

Wert aus: az sphere product list
--resource-group -g

Der Name der Azure-Ressourcengruppe. Sie können die Standardgruppe mit az config set defaults.group=<name> konfigurieren. Werte aus: az group list.

Optionale Parameter

--allow-crash-dumps-collection -cd

Geben Sie die Zustimmung für die Sammlung von Absturzabbildern von Microsoft für diese Gerätegruppe an. Weitere Informationen finden Sie unter https://aka.ms/AzureSphereCrashDumpsCollection.

Zulässige Werte: Disabled, Enabled
--application-update -a

Anwendungsupdaterichtlinie für diese Gerätegruppe.

Zulässige Werte: No3rdPartyAppUpdates, UpdateAll
--description -d

Eine neue Beschreibung der Gerätegruppe.

--os-feed -f

Der Betriebssystemfeedtyp, der für Betriebssystemupdates verwendet werden soll.

Zulässige Werte: Retail, RetailEval
--regional-data-boundary -r

Regionale Datengrenze für diese Gerätegruppe.

Zulässige Werte: EU, None
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.