device-group
Erstellt und verwaltet Gerätegruppen.
Gerätegruppen werden entweder durch einen Bezeichner (ID) oder durch ein Paar aus Produktname und Gerätegruppennamen adressiert.
| Vorgang | Beschreibung |
|---|---|
| Erstellen | Erstellt eine neue Gerätegruppe. |
| Liste | Listet alle Gerätegruppen in Ihrem Azure Sphere-Mandanten auf. |
| Löschen | Löscht eine vorhandene Gerätegruppe. |
| Einsatz | Verwaltet Bereitstellungen innerhalb einer Gerätegruppe. |
| Gerät | Listet Geräte in einer Gerätegruppe auf. |
| Zeigen | Zeigt Informationen zu einer Gerätegruppe an. |
| aktualisieren | Ändert eine vorhandene Gerätegruppe. |
Erstellen
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 die gleichen 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 | Schnur | Gibt einen Namen für die Gerätegruppe an. Der Name darf 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 angewendet werden soll. Akzeptierte Werte: No3rdPartyAppUpdates, UpdateAllund 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. Akzeptierte 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 | Schnur | Gibt den optionalen Text zur Beschreibung der Gerätegruppe an. Die maximale Länge beträgt 100 Zeichen. Wenn die Beschreibung Leerzeichen enthält, schließen Sie sie in Anführungszeichen ein. |
| -r, --regional-data-boundary | Schnur | Regionale Datengrenze für dieses Bild. Zulässige Werte: EU, None. Der Standardwert ist None. Wenn kein Wert angegeben wird, 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 |
|---|---|
| --Debuggen | Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem --debug Flag generierte Ausgabe an. |
| -h, --help | Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf. |
| --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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus table. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle. |
| --Abfrage | Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe . |
| --Ausführliche | Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie --debug für vollständige Debugprotokolle. |
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Liste
Listet alle Gerätegruppen in Ihrem Azure Sphere-Mandanten auf.
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 |
|---|---|
| --Debuggen | Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem --debug Flag generierte Ausgabe an. |
| -h, --help | Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf. |
| --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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus table. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle. |
| --Abfrage | Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe . |
| --Ausführliche | Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie --debug für vollständige Debugprotokolle. |
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
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
Löschen
Löscht die angegebene Gerätegruppe in Ihrem Azure Sphere-Mandanten.
Eine Gerätegruppe kann nur in folgenden Fällen gelöscht werden:
- Der Benutzer verfügt über Administratorberechtigungen für den Mandanten.
- Die Gerätegruppe ist leer und enthält keine Geräte. Der Befehl azsphere device-group device list 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 | Schnur | Gibt die zu löschende Gerätegruppe an. Sie können entweder die Gerätegruppen-ID oder den Namen der Gerätegruppe angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Namen der <product-name/device-group-name> Gerätegruppe im 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 |
|---|---|
| --Debuggen | Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem --debug Flag generierte Ausgabe an. |
| -h, --help | Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf. |
| --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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus table. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle. |
| --Abfrage | Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe . |
| --Ausführliche | Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie --debug für vollständige Debugprotokolle. |
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
Einsatz
Verwaltet Bereitstellungen für eine Gerätegruppe.
| Vorgang | Beschreibung |
|---|---|
| Erstellen | Erstellt eine neue Bereitstellung für die angegebene Gerätegruppe. |
| Liste | Zeigt die Bereitstellungen für eine Gerätegruppe an. |
Bereitstellung erstellen
Erstellt eine neue Bereitstellung für eine Gerätegruppe mit den bereitgestellten Images.
Sie können die Gerätegruppe entweder anhand des Bezeichners (ID) oder eines Paars aus Produkt- und Gerätegruppennamen identifizieren.
Erforderliche Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
| -g, --device-group | Schnur | Gibt die Gerätegruppe an, in der die Bereitstellung erstellt werden soll. Sie können entweder die Gerätegruppen-ID oder den Namen der Gerätegruppe angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Namen der <product-name/device-group-name> Gerätegruppe im Format angeben. |
| -i, --images | Schnur | Gibt die Image-IDs für ein oder mehrere Images an, die in die Bereitstellung eingeschlossen 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 Image-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 |
|---|---|
| --Debuggen | Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem --debug Flag generierte Ausgabe an. |
| -h, --help | Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf. |
| --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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus table. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle. |
| --Abfrage | Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe . |
| --Ausführliche | Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie --debug für vollständige Debugprotokolle. |
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 Paar Produktname und Gerätegruppenname im <Format product-name>/<device-group-name> verwenden. Dieses Namenspaar identifiziert eindeutig eine Gerätegruppe für ein bestimmtes Produkt.
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 anhand des Namens:
azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1
Beispiel zum Angeben mehrerer Bild-IDs durch Bereitstellen 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
Die Ausgabe sollte wie folgt aussehen:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Bereitstellungsliste
Zeigt den Bereitstellungsverlauf für eine Gerätegruppe an. Gibt die Bereitstellungs-ID, den Zeitstempel und die Liste der enthaltenen Images zurück. Die Liste ist nach den neuesten Bereitstellungen sortiert.
Erforderliche Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
| -g, --device-group | Schnur | Gibt die Gerätegruppe an, für die die Bereitstellungsverlaufsliste angezeigt werden soll. Sie können entweder die Gerätegruppen-ID oder den Namen der Gerätegruppe angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Namen der <product-name/device-group-name> Gerätegruppe im 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 |
|---|---|
| --Debuggen | Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem --debug Flag generierte Ausgabe an. |
| -h, --help | Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf. |
| --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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus table. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle. |
| --Abfrage | Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe . |
| --Ausführliche | Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie --debug für vollständige Debugprotokolle. |
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 anhand des Namens:
azsphere device-group deployment list --device-group DW100/Development
Die Ausgabe sollte wie folgt aussehen:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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 |
|---|---|
| Liste | Zeigt die Geräte in einer Gerätegruppe an. |
| show-count | Zeigt die Anzahl der Geräte in einer Gerätegruppe an. |
Geräteliste
Zeigt die Geräte in einer Gerätegruppe an.
Erforderliche Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
| -g, --device-group | Schnur | Gibt die Gerätegruppe an, für die die Geräteliste angezeigt werden soll. Sie können entweder die Gerätegruppen-ID oder den Namen der Gerätegruppe angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Namen der <product-name/device-group-name> Gerätegruppe im 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 |
|---|---|
| --Debuggen | Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem --debug Flag generierte Ausgabe an. |
| -h, --help | Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf. |
| --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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus table. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle. |
| --Abfrage | Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe . |
| --Ausführliche | Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie --debug für vollständige Debugprotokolle. |
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 anhand des Namens:
azsphere device-group device list --device-group DW100/Marketing
Die Ausgabe sollte wie folgt aussehen:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
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 | Schnur | Gibt die Gerätegruppe an, für die die Geräteanzahl angezeigt werden soll. Sie können entweder die Gerätegruppen-ID oder den Namen der Gerätegruppe angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Namen der <product-name/device-group-name> Gerätegruppe im 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 |
|---|---|
| --Debuggen | Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem --debug Flag generierte Ausgabe an. |
| -h, --help | Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf. |
| --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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus table. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle. |
| --Abfrage | Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe . |
| --Ausführliche | Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie --debug für vollständige Debugprotokolle. |
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 zum Angeben von device-group anhand des Namens:
azsphere device-group device show-count --device-group DW100/Marketing
Die Ausgabe sollte wie folgt aussehen:
------
Result
======
1
------
Zeigen
Gibt Informationen zu einer Gerätegruppe zurück.
Erforderliche Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
| -g, --device-group | Schnur | Gibt die Gerätegruppe an, für die Details angezeigt werden sollen. Sie können entweder die Gerätegruppen-ID oder den Namen der Gerätegruppe angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Namen der <product-name/device-group-name> Gerätegruppe im 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 |
|---|---|
| --Debuggen | Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem --debug Flag generierte Ausgabe an. |
| -h, --help | Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf. |
| --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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus table. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle. |
| --Abfrage | Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe . |
| --Ausführliche | Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie --debug für vollständige Debugprotokolle. |
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 zum Angeben von device-group anhand des Namens:
azsphere device-group show --device-group DW100/Marketing
Die Ausgabe sollte wie folgt aussehen:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
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
Updates eine vorhandene Gerätegruppe, die durch die ID oder durch produkt- und gerätegruppennamenpaar identifiziert wird.
Erforderliche Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
| -g, --device-group | Schnur | Gibt die Gerätegruppe an, für die Details aktualisiert werden sollen. Sie können entweder die Gerätegruppen-ID oder den Namen der Gerätegruppe angeben. Um den Gerätegruppennamen zu verwenden, müssen Sie sowohl den Produktnamen als auch den Namen der <product-name/device-group-name> Gerätegruppe im Format angeben. |
Optionale Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
| -c, --allow-crash-dumps-collection | Schnur | 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, UpdateAllund NoUpdates. Der Standardwert ist UpdateAll. Die NoUpdates Richtlinie ist derzeit nur für die interne Verwendung reserviert. |
| -d, --new-description | Schnur | Gibt optionalen Text an, um die Gerätegruppe zu beschreiben. Die maximale Länge beträgt 100 Zeichen. |
| -n, --new-name | Schnur | Gibt einen neuen Namen für die Gerätegruppe an. Der Name darf 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 | Schnur | 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 | Schnur | Regionale Datengrenze für dieses Bild. Zulässige Werte: EU, None. Der Standardwert ist None. Wenn kein Wert angegeben wird, 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 |
|---|---|
| --Debuggen | Erhöht die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen. Wenn Sie einen Fehler finden, geben Sie beim Übermitteln eines Fehlerberichts die mit dem --debug Flag generierte Ausgabe an. |
| -h, --help | Gibt CLI-Referenzinformationen zu Befehlen und deren Argumenten aus und listet verfügbare Untergruppen und Befehle auf. |
| --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 (für Menschen lesbare ASCII-Tabellen) und yaml. Standardmäßig gibt die CLI aus table. Weitere Informationen zu den verfügbaren Ausgabeformaten finden Sie unter Ausgabeformat für Azure Sphere-CLI-Befehle. |
| --Abfrage | Verwendet die JMESPath-Abfragesprache, um die von Azure Sphere Security Services zurückgegebene Ausgabe zu filtern. Weitere Informationen und Beispiele finden Sie unter JMESPath-Tutorial und Abfragen der Azure CLI-Befehlsausgabe . |
| --Ausführliche | Gibt Informationen zu Ressourcen aus, die während eines Vorgangs in Azure Sphere erstellt wurden, sowie andere nützliche Informationen. Verwenden Sie --debug für vollständige Debugprotokolle. |
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 zum Angeben von device-group anhand des Namens:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
Die Ausgabe sollte wie folgt aussehen:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------