device-group

Artikel
09/27/2024

Wichtig

Dies ist die Dokumentation zu Azure Sphere (Legacy). Azure Sphere (Legacy) wird am 27. September 2027 eingestellt, und Benutzer müssen bis zu diesem Zeitpunkt zu Azure Sphere (integriert) migrieren. Verwenden Sie die Versionsauswahl oberhalb des Inhaltsverzeichniss, um die Dokumentation zu Azure Sphere (Integriert) anzuzeigen.

Erstellt und verwaltet Gerätegruppen.

Gerätegruppen werden entweder durch den Bezeichner (ID) oder durch ein Paar aus Produktname und Gerätegruppenname adressiert.

Vorgang	Beschreibung
erstellen	Erstellt eine neue Gerätegruppe.
list	Auflisten aller Gerätegruppen in Ihrem Azure Sphere-Mandanten.
Löschen	Löscht eine vorhandene Gerätegruppe.
deployment	Verwaltet Bereitstellungen innerhalb einer Gerätegruppe.
Gerät	Listet Geräte in einer Gerätegruppe auf.
show	Zeigt Informationen zu einer Gerätegruppe an.
Aktualisierung	Ändert eine vorhandene Gerätegruppe.

create

Erstellt eine Gerätegruppe mit dem angegebenen Namen für das angegebene Produkt. Die Gerätegruppe organisiert Geräte, die über dasselbe Produkt verfügen und dieselben Anwendungen aus der Cloud erhalten.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-p, --product	GUID oder Name	Gibt das Produkt an, dem diese Gerätegruppe hinzugefügt werden soll. Sie können entweder die ID oder den Namen des Azure Sphere-Produkts angeben.
-n, --name	String	Gibt einen Namen für die Gerätegruppe an. Der Name kann nur alphanumerische Zeichen enthalten. Wenn der Name Leerzeichen enthält, schließen Sie ihn in Anführungszeichen ein. Der Gerätegruppenname darf maximal 50 Zeichen lang sein. Die Groß-/Kleinschreibung wird nicht beachtet, muss innerhalb des Produkts eindeutig sein.

Optionale Parameter

Parameter	Typ	Beschreibung
-a, --application-update	Enum	Gibt die Anwendungsupdaterichtlinie an, die für diese Gerätegruppe gelten soll. Akzeptierte Werte: `No3rdPartyAppUpdates`, `UpdateAll`, und `NoUpdates`. Der Standardwert ist `UpdateAll`. Die `NoUpdates` Richtlinie ist derzeit nur für die interne Verwendung reserviert.
-f, --os-feed	Enum	Gibt den Betriebssystemfeedtyp an, der für Betriebssystemupdates verwendet werden soll. Zulässige Werte: `Retail`, `RetailEval`.
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.
-d, --description	String	Gibt den optionalen Text zur Beschreibung der Gerätegruppe an. Die maximale Länge beträgt 100 Zeichen. Wenn die Beschreibung Leerzeichen enthält, müssen Sie sie in Anführungszeichen einschließen.
-r, --regional-data-boundary	String	Regionale Datengrenze für dieses Bild. Zulässige Werte: `EU`, `None`. Der Standardwert ist `None`. Wenn kein Wert angegeben ist, wird der Standardwert verwendet. Weitere Informationen finden Sie unter Konfigurieren von Absturzabbildern – Überlegungen zu Pivacy

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device-group create --name Marketing --product DW100

 ------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- ---------------------
 Id                                   TenantId                             OsFeedType ProductId                            Name       UpdatePolicy                                               AllowCrashDumpsCollection     RegionalDataBoundary
 ===================================================================================================================================================================================================================================================
 7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     6f52bead-700d-4289-bdc2-2f11f774270e Marketing Accept all updates from the Azure Sphere Security Service. False                          None
 ------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------

list

Auflisten aller Gerätegruppen in Ihrem Azure Sphere-Mandanten.

Optionale Parameter

Parameter	Typ	Beschreibung
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device-group list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb

  ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- ---------------------
 Id                                   Name                     Description                                   ProductId                            OsFeedType UpdatePolicy                                                           AllowCrashDumpsCollection     RegionalDataBoundary
 =====================================================================================================================================================================================================================================================================================
 a3a49688-4601-4422-8b51-a0838ea84627 Development              Default development device group              6f52bead-700d-4289-bdc2-2f11f774270e Retail     Accept only system software updates. Don't accept application updates. False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
 7cb46b96-8c17-4afd-bd3f-614acad9d264 Field Test               Default test device group                     6f52bead-700d-4289-bdc2-2f11f774270e Retail     Accept all updates from the Azure Sphere Security Service.             False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
 30c39bae-f525-4094-8008-d03705429ef0 Production               Default production device group               6f52bead-700d-4289-bdc2-2f11f774270e Retail     Accept all updates from the Azure Sphere Security Service.             False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
 cb5c9685-5dbe-470c-91a9-91dc129884d6 Production OS Evaluation Default Production OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service.             False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
 63e72035-3fcf-4fdc-b88a-05e30d1ba224 Field Test OS Evaluation Default Field Test OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service.             False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------

delete

Löscht die angegebene Gerätegruppe in Ihrem Azure Sphere-Mandanten.

Eine Gerätegruppe kann nur gelöscht werden, wenn:

Der Benutzer verfügt über Administratorberechtigungen für den Mandanten.
Die Gerätegruppe ist leer und enthält keine Geräte. Der Befehl "gerätegruppenspezifische Geräteliste " listet alle Geräte in einer Gerätegruppe auf. Führen Sie azsphere Device Update --device-group aus, um das Gerät in eine andere Gerätegruppe zu verschieben.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-g, --device-group	String	Gibt die zu löschende Gerätegruppe an. Sie können entweder die Gerätegruppen-ID oder den Gerätegruppennamen angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Gerätegruppennamen im `<product-name/device-group-name>` Format angeben.

Optionale Parameter

Parameter	Typ	Beschreibung
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

azsphere device-group delete --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Successfully deleted the device group

azsphere device-group delete --device-group DW100/Development
Successfully deleted the device group

deployment

Verwaltet Bereitstellungen für eine Gerätegruppe.

Vorgang	Beschreibung
erstellen	Erstellt eine neue Bereitstellung für die angegebene Gerätegruppe.
list	Zeigt die Bereitstellungen für eine Gerätegruppe an.

deployment create

Erstellt eine neue Bereitstellung für eine Gerätegruppe mit den bereitgestellten Images.

Sie können die Gerätegruppe entweder durch den Bezeichner (ID) oder durch ein Paar aus Produktname und Gerätegruppenname identifizieren.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-g, --device-group	String	Gibt die Gerätegruppe an, in der die Bereitstellung erstellt werden soll. Sie können entweder die Gerätegruppen-ID oder den Gerätegruppennamen angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Gerätegruppennamen im `<product-name/device-group-name>` Format angeben.
-i, --images	String	Gibt die Image-IDs für ein oder mehrere Images an, die in die Bereitstellung einbezogen werden sollen. Sie können mehrere Bilder hinzufügen, indem Sie zusätzliche Parameter hinzufügen, oder mehrere Bild-IDs können in einem einzelnen Parameter in einer durch Leerzeichen getrennten Liste kombiniert werden. Führen Sie den Befehl "azsphere image add " aus, um die Bild-ID abzurufen.

Optionale Parameter

Parameter	Typ	Beschreibung
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

Der --device-group Parameter identifiziert die Gerätegruppe. Die Gerätegruppen-ID stellt eine GUID bereit, die die Gerätegruppe für alle Produkte eindeutig identifiziert. Alternativ können Sie das Produktnamen- und Gerätegruppennamenpaar im <Produktnamen>-/<Gerätegruppennamenformat> verwenden. Durch diese Namenskombination wird eine Gerätegruppe für ein bestimmtes Produkt eindeutig identifiziert.

Beispiel zum Angeben der Gerätegruppe nach ID:

azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1

Beispiel zum Angeben der Gerätegruppe nach Name:

azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1

Beispiel zum Angeben mehrerer Bild-IDs durch Angeben einer Liste von Werten, die durch Leerzeichen getrennt sind:

azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4

Es sollte in etwa folgende Ausgabe angezeigt werden:

------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id                                   TenantId                             DeployedImages                       DeploymentDateUtc                    
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb 5572509b-43a4-45b0-88c5-365cbf9732c1 2021-04-01T18:48:41.721662+00:00     
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------

deployment list

Zeigt den Bereitstellungsverlauf für eine Gerätegruppe an. Gibt die Bereitstellungs-ID, den Zeitstempel und eine Liste der enthaltenen Images zurück. Die Liste nach den jüngsten Bereitstellungen sortiert.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-g, --device-group	String	Gibt die Gerätegruppe an, für die die Bereitstellungsverlaufsliste angezeigt werden soll. Sie können entweder die Gerätegruppen-ID oder den Gerätegruppennamen angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Gerätegruppennamen im `<product-name/device-group-name>` Format angeben.

Optionale Parameter

Parameter	Typ	Beschreibung
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

Beispiel zum Angeben der Gerätegruppe nach ID:

azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd

Beispiel zum Angeben der Gerätegruppe nach Name:

azsphere device-group deployment list --device-group DW100/Development

Es sollte in etwa folgende Ausgabe angezeigt werden:

------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id                                   TenantId                             DeployedImages                       DeploymentDateUtc                   
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb e3769536-dc4b-48d9-afd4-22ed321ba4bc 2020-11-18T19:46:50.514429+00:00    
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------

Gerät

Verwaltet Geräte für eine Gerätegruppe.

Vorgang	Beschreibung
list	Zeigt die Geräte in einer Gerätegruppe an.
show-count	Zeigt die Anzahl der Geräte in einer Gerätegruppe an.

device list

Zeigt die Geräte in einer Gerätegruppe an.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-g, --device-group	String	Gibt die Gerätegruppe an, für die die Geräteliste angezeigt werden soll. Sie können entweder die Gerätegruppen-ID oder den Gerätegruppennamen angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Gerätegruppennamen im `<product-name/device-group-name>` Format angeben.

Optionale Parameter

Parameter	Typ	Beschreibung
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

Beispiel zum Angeben der Gerätegruppe nach ID:

azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd

Beispiel zum Angeben der Gerätegruppe nach Name:

azsphere device-group device list --device-group DW100/Marketing

Es sollte in etwa folgende Ausgabe angezeigt werden:

-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId                                                                                                                         TenantId                             ProductId                            DeviceGroupId                           
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd    
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------

device show-count

Zeigt die Anzahl der Geräte in einer Gerätegruppe an.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-g, --device-group	String	Gibt die Gerätegruppe an, für die die Geräteanzahl angezeigt werden soll. Sie können entweder die Gerätegruppen-ID oder den Gerätegruppennamen angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Gerätegruppennamen im `<product-name/device-group-name>` Format angeben.

Optionale Parameter

Parameter	Typ	Beschreibung
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

Beispiel zum Angeben der Gerätegruppe nach ID:

azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd

Beispiel für die Angabe der Gerätegruppe nach Name:

azsphere device-group device show-count --device-group DW100/Marketing

Es sollte in etwa folgende Ausgabe angezeigt werden:

------
Result
======
1
------

Zeigen

Gibt Informationen zu einer Gerätegruppe zurück.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-g, --device-group	String	Gibt die Gerätegruppe an, für die Details angezeigt werden sollen. Sie können entweder die Gerätegruppen-ID oder den Gerätegruppennamen angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Gerätegruppennamen im `<product-name/device-group-name>` Format angeben.

Optionale Parameter

Parameter	Typ	Beschreibung
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

Beispiel zum Angeben der Gerätegruppe nach ID:

azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd

Beispiel für die Angabe der Gerätegruppe nach Name:

azsphere device-group show --device-group DW100/Marketing

Es sollte in etwa folgende Ausgabe angezeigt werden:

------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Id                                   Name      Description            TenantId                             ProductId                            OsFeedType UpdatePolicy                                               AllowCrashDumpsCollection     RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd Marketing Marketing device group 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e Retail     Accept all updates from the Azure Sphere Security Service. False                         None                         
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------

aktualisieren

Aktualisiert eine vorhandene Gerätegruppe, die entweder durch die ID oder durch ein Paar aus Produktname und Gerätegruppenname identifiziert wird.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-g, --device-group	String	Gibt die Gerätegruppe an, für die Details aktualisiert werden sollen. Sie können entweder die Gerätegruppen-ID oder den Gerätegruppennamen angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Gerätegruppennamen im `<product-name/device-group-name>` Format angeben.

Optionale Parameter

Parameter	Typ	Beschreibung
-c, --allow-crash-dumps-collection	String	Legen Sie die Zustimmung für die Sammlung von Absturzabbildern durch Microsoft für die Gerätegruppe fest. Der Standardwert ist `Off`. Zulässige Werte: `Off` und `On`. Verwenden Sie den `--regional-data-boundary` Parameter, um anzugeben, wo die Absturzabbilddateien gespeichert werden sollen. Weitere Informationen finden Sie unter Konfigurieren von Absturzabbildern.
-a, --application-update	ApplicationUpdatePolicyType	Gibt die Anwendungsupdaterichtlinie für die Gerätegruppe an. Zulässige Werte: `No3rdPartyAppUpdates`, `UpdateAll` und `NoUpdates`. Der Standardwert ist `UpdateAll`. Die `NoUpdates` Richtlinie ist derzeit nur für die interne Verwendung reserviert.
-d, --new-description	String	Gibt optionalen Text zur Beschreibung der Gerätegruppe an. Die maximale Länge beträgt 100 Zeichen.
-n, --new-name	String	Gibt einen neuen Namen für die Gerätegruppe an. Der Name kann nur alphanumerische Zeichen enthalten. Wenn der Name Leerzeichen enthält, schließen Sie ihn in Anführungszeichen ein. Der Gerätegruppenname darf 50 Zeichen nicht überschreiten, die Groß-/Kleinschreibung wird nicht beachtet und muss innerhalb des Produkts eindeutig sein.
-f, --os-feed	String	Gibt den Betriebssystemfeed für die Gerätegruppe an. Mögliche Werte sind `Retail` und `RetailEval`.
-t, --tenant	GUID oder Name	Gibt den Mandanten an, in dem dieser Vorgang ausgeführt werden soll. Überschreibt den ausgewählten Standardmandanten. Sie können entweder die Mandanten-ID oder den Mandantennamen angeben.
-r, --regional-data-boundary	String	Regionale Datengrenze für dieses Bild. Zulässige Werte: `EU`, `None`. Der Standardwert ist `None`. Wenn kein Wert angegeben ist, wird der Standardwert verwendet. Weitere Informationen finden Sie unter Konfigurieren von Absturzabbildern – Überlegungen zu Pivacy

Globale Parameter

Die folgenden globalen Parameter sind für die Azure Sphere CLI verfügbar:

Parameter	Beschreibung
--debug	Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn ein Fehler auftritt, stellen Sie beim Übermitteln eines Fehlerberichts die mit dem Flag `--debug` generierte Ausgabe bereit.
-h, --help	Druckt CLI-Referenzinformationen zu Befehlen und deren Argumenten und Listen verfügbarer Untergruppen und Befehle.
--only-show-errors	Zeigt nur Fehler an, wobei Warnungen unterdrückt werden.
-o, --output	Ändert das Ausgabeformat. Die verfügbaren Ausgabeformate sind json, jsonc (colorized JSON), tsv (Tab-Separated Values), Table (human-lesbare ASCII-Tabellen) und Yaml. Die CLI gibt standardmäßig `table` aus. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere CLI-Befehle.
--query	Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie im JMESPath-Lernprogramm und in der Abfrage der Azure CLI-Befehlsausgabe .
--verbose	Druckt Informationen zu Ressourcen, die während eines Vorgangs in Azure Sphere erstellt wurden, und andere nützliche Informationen. Verwenden Sie `--debug`, um vollständige Debugprotokolle zu erhalten.

Hinweis

Wenn Sie die klassische Azure Sphere CLI verwenden, finden Sie unter "Globale Parameter " weitere Informationen zu den verfügbaren Optionen.

Beispiel

Beispiel zum Angeben der Gerätegruppe nach ID:

azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"

Beispiel für die Angabe der Gerätegruppe nach Name:

azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"

Es sollte in etwa folgende Ausgabe angezeigt werden:

------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
Id                                   TenantId                             OsFeedType ProductId                            Name      Description            UpdatePolicy                                               AllowCrashDumpsCollection     RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     6f52bead-700d-4289-bdc2-2f11f774270e Marketing Marketing device group Accept all updates from the Azure Sphere Security Service. False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------

Teilen über

device-group

create

Erforderliche Parameter

Optionale Parameter

Beispiel

list

Optionale Parameter

Beispiel

delete

Erforderliche Parameter

Optionale Parameter

Beispiel

deployment

deployment create

Erforderliche Parameter

Optionale Parameter

Beispiel

deployment list

Erforderliche Parameter

Optionale Parameter

Beispiel

Gerät

device list

Erforderliche Parameter

Optionale Parameter

Beispiel

device show-count

Erforderliche Parameter

Optionale Parameter

Beispiel

Zeigen

Erforderliche Parameter

Optionale Parameter

Beispiel

aktualisieren

Erforderliche Parameter

Optionale Parameter

Beispiel

Feedback

Zusätzliche Ressourcen