Produkt

Verwaltet Produkte.

Vorgang Beschreibung
Erstellen Erstellt ein neues Produkt.
Löschen Löscht ein vorhandenes Produkt.
Gerät Zeigt Geräte in diesem Produkt an.
device-group Verwaltet Produktgerätegruppen.
Liste Listet alle Produkte im Azure Sphere-Mandanten auf.
Zeigen Zeigt Details zu einem Produkt an.
aktualisieren Updates angegebenen Metadaten.

Erstellen

Erstellt ein neues Produkt.

Der Befehl azsphere product create fügt dem erstellten Produkt automatisch fünf Standardgerätegruppen hinzu:

  • Die Gerätegruppe "Entwicklung " deaktiviert Cloudanwendungsupdates und stellt das Einzelhandelsbetriebssystem bereit.
  • Die Gerätegruppe "Feldtest " ermöglicht Cloudanwendungsupdates und stellt das Einzelhandelsbetriebssystem bereit.
  • Die Produktionsgerätegruppe ermöglicht Cloudanwendungsupdates und stellt das Einzelhandelsbetriebssystem bereit.
  • Die Gerätegruppe "Auswertung von Produktionsbetriebssystemen" ermöglicht Cloudanwendungsupdates und stellt das Retail Evaluation-Betriebssystem bereit.
  • Die Gerätegruppe "Field Test Os Evaluation " ermöglicht Cloudanwendungsupdates und stellt das Retail Evaluation-Betriebssystem bereit.

Erforderliche Parameter

Parameter Typ Beschreibung
-n, --name Schnur Gibt einen Namen für das Produkt an. Der Name darf nur alphanumerische Zeichen enthalten. Wenn der Name Leerzeichen enthält, schließen Sie ihn in Anführungszeichen ein. Der Produktname darf 50 Zeichen nicht überschreiten, die Groß-/Kleinschreibung wird nicht beachtet und muss innerhalb eines Mandanten eindeutig sein.

Optionale Parameter

Parameter Typ Beschreibung
-g, --no-default-device-groups Boolean Gibt ein optionales Flag an, das die Erstellung der Standardgerätegruppen verhindert.
-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 des Produkts an. Die maximale Länge beträgt 100 Zeichen. Wenn die Beschreibung Leerzeichen enthält, schließen Sie sie in Anführungszeichen ein.
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 product create --name DW100 --description "Contoso DW100 models"
Default device groups will been created for this product, use the 'azsphere product device-group list' command to see them.
 ------------------------------------ -------------------- ----- ------------------------------------
 TenantId                             Description          Name  Id
 ====================================================================================================
 143adbc9-1bf0-4be2-84a2-084a331d81cb Contoso DW100 models DW100 6f52bead-700d-4289-bdc2-2f11f774270e
 ------------------------------------ -------------------- ----- ------------------------------------

Löschen

Löscht das angegebene Produkt in Ihrem Azure Sphere-Mandanten.

Ein Produkt kann nur in folgenden Fällen gelöscht werden:

Erforderliche Parameter

Parameter Typ Beschreibung
-p, --product GUID oder Name Gibt das zu löschende Produkt an. Sie können entweder die ID oder den Namen des Azure Sphere-Produkts 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 des Produkts nach ID:

azsphere product delete --product 6f52bead-700d-4289-bdc2-2f11f774270e

Beispiel zum Angeben des Produkts anhand des Namens:

azsphere product delete --product DW100

Die Ausgabe sollte wie folgt aussehen:

Successfully deleted the product

Gerät

Zeigt Geräte in einem Produkt an.

Vorgang Beschreibung
Liste Zeigt Geräte innerhalb des angegebenen Produkts an.
show-count Gibt die Anzahl der Geräte innerhalb des Produkts zurück.

Geräteliste

Zeigt Geräte innerhalb des angegebenen Produkts an, die nach Geräte-ID aufgeführt sind.

Erforderliche Parameter

Parameter Typ Beschreibung
-p, --product GUID oder Name Gibt das Produkt an, in dem die Geräte aufgelistet werden sollen. Sie können entweder die ID oder den Namen des Azure Sphere-Produkts 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 des Produkts nach ID:

azsphere product device list --product 6f52bead-700d-4289-bdc2-2f11f774270e

Beispiel zum Angeben des Produkts anhand des Namens:

azsphere product device list --product DW100

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

Gibt die Gesamtzahl aller Geräte in allen Gerätegruppen innerhalb eines Produkts zurück.

Erforderliche Parameter

Parameter Typ Beschreibung
-p, --product GUID oder Name Gibt das Produkt an, für das die Anzahl der Zielgeräte angezeigt wird. Sie können entweder die ID oder den Namen des Azure Sphere-Produkts 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 des Produkts nach ID:

azsphere product device show-count --product 6f52bead-700d-4289-bdc2-2f11f774270e

Beispiel zum Angeben des Produkts anhand des Namens:

azsphere product device show-count --product DW100

Die Ausgabe sollte wie folgt aussehen:

------
Result
======
2
------

device-group

Verwaltet Produktgerätegruppen.

Vorgang Beschreibung
create-defaults Erstellt die Standardgerätegruppen innerhalb des angegebenen Produkts.
Liste Zeigt Gerätegruppen innerhalb des angegebenen Produkts an.

device-group create-defaults

Erstellt die Standardgerätegruppen in einem vorhandenen Produkt.

Erforderliche Parameter

Parameter Typ Beschreibung
-p, --product GUID oder Name Gibt das abzurufende Produkt an. Sie können entweder die ID oder den Namen des Azure Sphere-Produkts 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 des Produkts nach ID:

azsphere product device-group create-defaults --product 6f52bead-700d-4289-bdc2-2f11f774270e

Beispiel zum Angeben des Produkts anhand des Namens:

azsphere product device-group create-defaults --product  DW100

Die Ausgabe sollte wie folgt aussehen:

------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- -------------------------
Id                                   Name                     Description                                   ProductId                            OsFeedType UpdatePolicy                                                           AllowCrashDumpsCollection     RegionalDataBoundary
=====================================================================================================================================================================================================================================================================================
6406868c-19bb-4bea-b4cf-fd80608ee5cb Development              Default development device group              ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail     Accept only system software updates. Don't accept application updates. False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
d2e2b2e7-e219-4af8-8876-f8d10624778b Field Test               Default test device group                     ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail     Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
822f1bda-32d7-404a-bf37-9f90aad09509 Production               Default production device group               ac181192-2569-4d95-8f70-f8fd9e8dd2e3 Retail     Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
3fafc0e1-f336-4a8a-9be4-fb275322d2cc Production OS Evaluation Default Production OS Evaluation device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 RetailEval Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
b9b7f388-2ad4-4a7e-a4dc-6559fb80741d Field Test OS Evaluation Default Field Test OS Evaluation device group ac181192-2569-4d95-8f70-f8fd9e8dd2e3 RetailEval Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------

Gerätegruppenliste

Listet alle Gerätegruppen in einem Produkt auf.

Erforderliche Parameter

Parameter Typ Beschreibung
-p, --product GUID oder Name Gibt das Produkt an, für das die Gerätegruppen aufgelistet werden sollen. Sie können entweder die ID oder den Namen des Azure Sphere-Produkts 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 des Produkts nach ID:

azsphere product device-group list --product 6f52bead-700d-4289-bdc2-2f11f774270e

Beispiel zum Angeben des Produkts anhand des Namens:

azsphere product device-group list --product DW100

Die Ausgabe sollte wie folgt aussehen:

------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- -------------------------
Id                                   TenantId                             OsFeedType ProductId                            Name                     Description                                   UpdatePolicy                                                           AllowCrashDumpsCollection     RegionalDataBoundary
==========================================================================================================================================================================================================================================================================================================================
6406868c-19bb-4bea-b4cf-fd80608ee5cb 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     4f48d618-09f7-45dc-a5a4-1433cabbee91 Development              Default development device group              Accept only system software updates. Don't accept application updates. False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
d2e2b2e7-e219-4af8-8876-f8d10624778b 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     4f48d618-09f7-45dc-a5a4-1433cabbee91 Field Test               Default test device group                     Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
822f1bda-32d7-404a-bf37-9f90aad09509 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     4f48d618-09f7-45dc-a5a4-1433cabbee91 Production               Default production device group               Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
a6c64cda-4ff0-48bb-8a30-6ffab322b846 143adbc9-1bf0-4be2-84a2-084a331d81cb RetailEval 4f48d618-09f7-45dc-a5a4-1433cabbee91 Production OS Evaluation Default Production OS Evaluation device group Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
3fafc0e1-f336-4a8a-9be4-fb275322d2cc 143adbc9-1bf0-4be2-84a2-084a331d81cb RetailEval 4f48d618-09f7-45dc-a5a4-1433cabbee91 Field Test OS Evaluation Default Field Test OS Evaluation device group Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------
b9b7f388-2ad4-4a7e-a4dc-6559fb80741d 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     4f48d618-09f7-45dc-a5a4-1433cabbee91 Marketing                Default Marketing device group                Accept all updates from the Azure Sphere Security Service.             False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ ------------------------ --------------------------------------------- ---------------------------------------------------------------------- ----------------------------- --------------------

Liste

Listet alle Produkte im 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 product list
------------------------------------ ------------------------------------ --------- --------------------
Id                                   TenantId                             Name      Description
========================================================================================================
6f52bead-700d-4289-bdc2-2f11f774270e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW100     Contoso DW100 models
------------------------------------ ------------------------------------ --------- --------------------
6a82518f-8965-4bd6-ba79-43aa3fcafe5e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW200     Contoso DW200 models
------------------------------------ ------------------------------------ --------- --------------------

Zeigen

Zeigt Details zu einem Produkt an.

Erforderliche Parameter

Parameter Typ Beschreibung
-p, --product GUID oder Name Gibt das abzurufende Produkt an. Sie können entweder die ID oder den Namen des Azure Sphere-Produkts 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 von Produkt und Mandant nach ID:

azsphere product show --product 6f52bead-700d-4289-bdc2-2f11f774270e --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb

Beispiel zum Angeben von Produkt und Mandant anhand des Namens:

azsphere product show --product DW100 --tenant MyTenant

Die Ausgabe sollte wie folgt aussehen:

------------------------------------ ------------------------------------ ----- --------------------
Id                                   TenantId                             Name  Description
====================================================================================================
6f52bead-700d-4289-bdc2-2f11f774270e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW100 Contoso DW100 models
------------------------------------ ------------------------------------ ----- --------------------

aktualisieren

Updates angegebenen Produktmetadaten.

Mindestens ein optionaler Parameter muss bereitgestellt werden, entweder --newname oder --newdescription. Beide können in einem einzigen Befehl angegeben werden.

Erforderliche Parameter

Parameter Typ Beschreibung
-p, --product GUID oder Name Gibt das zu aktualisierende Produkt an. Sie können entweder die ID oder den Namen des Azure Sphere-Produkts angeben.

Optionale Parameter

Parameter Typ Beschreibung
-n, --new-name Schnur Gibt einen neuen Namen für das Produkt an. Der Name darf nur alphanumerische Zeichen enthalten. Wenn der Name Leerzeichen enthält, schließen Sie ihn in Anführungszeichen ein. Der Produktname darf 50 Zeichen nicht überschreiten, die Groß-/Kleinschreibung wird nicht beachtet und muss innerhalb eines Mandanten eindeutig sein.
-d, --new-description Schnur Gibt optionalen Text zur Beschreibung des Produkts an. Die maximale Länge beträgt 100 Zeichen.
-t, --tenant Schnur 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 des Produkts nach ID:

azsphere product update --product 6f52bead-700d-4289-bdc2-2f11f774270e --new-description Contoso DW100 models

Beispiel zum Angeben des Produkts anhand des Namens:

azsphere product update --product DW100 --new-description Contoso DW100 models

Die Ausgabe sollte wie folgt aussehen:

------------------------------------ ------------------------------------ ----- ------------------
Id                                   TenantId                             Name  Description
==================================================================================================
6a82518f-8965-4bd6-ba79-43aa3fcafe5e 143adbc9-1bf0-4be2-84a2-084a331d81cb DW200 Contoso DW200 models
------------------------------------ ------------------------------------ ----- ------------------