Produkte verwalten
Ein Produkt identifiziert eine Azure Sphere-MCU, die in ein verbundenes Gerät integriert ist, um eine bestimmte Funktion auszuführen. Als Hersteller erstellen Sie ein Produkt für jedes Modell eines verbundenen Geräts, z. B. einen Geschirrspüler oder eine Kaffeemaschine. Beispielsweise erstellt Contoso ein Produkt für seine DW100-Geschirrspüler und weist dieses Produkt während der Herstellung jedem DW100-Geschirrspüler zu. Jedes Produkt verfügt über eine GUID, die innerhalb des Mandanten eindeutig ist und nicht geändert werden kann.
Jedes verbundene Gerät verfügt über ein einzelnes Produkt, aber ein einzelnes Produkt kann vielen Geräten zugeordnet werden. Jedes Produkt hat einen Namen, der innerhalb seines Mandanten eindeutig sein muss, zusammen mit einer Beschreibung. Der Produktname und die Beschreibung bieten eine lesbare Möglichkeit, ein Produkt von einem anderen zu unterscheiden. Der Name und die Beschreibung des Produkts können beliebig oft geändert werden.
Produkte auflisten
Listen Sie alle Produkte in Ihrem Azure Sphere-Mandanten auf, indem Sie den Befehl azsphere product list oder die öffentliche Azure Sphere-API verwenden.
So listen Sie alle Produkte auf:
azsphere product list
Wenn der Standardmandant nicht ausgewählt ist, wird möglicherweise eine Meldung angezeigt. Wählen Sie den erforderlichen Mandanten aus der Liste aus, und wiederholen Sie den Befehl.
So listen Sie alle Produkte in einem Azure Sphere-Mandanten auf:
Wählen Sie das Symbol azure Sphere Explorer in der Aktivitätsleiste von Visual Studio Code aus, um Azure Sphere Explorer zu öffnen. Wenn im Bereich Mandant die Option Anmelden angezeigt wird, um Mandanten anzuzeigen, melden Sie sich bei Azure Sphere an, und wählen Sie Aktualisieren aus, um die verfügbaren Mandanten anzuzeigen.
Erweitern Sie den Mandanten, an dem Sie interessiert sind.
Erweitern Sie den Produktknoten.
Wählen Sie Weitere>Windows>Azure Sphere-Explorer anzeigen aus, um Azure Sphere Explorer zu öffnen. Wenn im Bereich Mandant die Option Anmelden angezeigt wird, um Mandanten anzuzeigen, melden Sie sich bei Azure Sphere an, und wählen Sie Aktualisieren aus, um die verfügbaren Mandanten anzuzeigen.
Erweitern Sie den Mandanten, an dem Sie interessiert sind.
Erweitern Sie den Produktknoten.
Erstellen eines Produkts
Erstellen Sie ein Produkt in Ihrem Azure Sphere-Mandanten, indem Sie den Befehl azsphere product create oder die öffentliche Azure Sphere-API verwenden.
So erstellen Sie ein Produkt:
azsphere product create --name <product-name>
Ersetzen Sie <product-name> durch einen lesbaren Namen für Ihr Produkt, z. B. DW100. Namen für Produkte dürfen nur alphanumerische Zeichen und Leerzeichen enthalten. Sie dürfen 50 Zeichen nicht überschreiten. Wenn der Name oder die Beschreibung Leerzeichen enthält, schließen Sie sie in Anführungszeichen ein.
Wenn Sie ein neues Produkt erstellen, erstellt Azure Sphere standardmäßig automatisch fünf Gerätegruppen, die beim Erstellen von Bereitstellungen verwendet werden können. Die fünf Standardgerätegruppen sind "Entwicklung", "Feldtest", "Produktion", "Feldtestbetriebssystemauswertung" und "Produktionsbetriebssystemauswertung". Verwenden Sie den Folgenden Befehl, um das Produkt ohne die Standardgerätegruppen zu erstellen:
azsphere product create --name <product-name> --no-default-device-groups
Ein Mandant kann viele Produkte enthalten. Es kann hilfreich sein, jeweils eine Beschreibung anzugeben. Sie können einem Produkt wie folgt eine Beschreibung hinzufügen:
azsphere product create --name <product-name> --description <product-description>
So erstellen Sie ein Produkt:
Klicken Sie für den Mandanten, an dem Sie interessiert sind, mit der rechten Maustaste auf den Knoten Produkt, und wählen Sie Neues Produkt aus.
Geben Sie einen Namen für das Produkt an, und drücken Sie die EINGABETASTE. Namen für Produkte dürfen nur alphanumerische Zeichen und Leerzeichen enthalten. Sie dürfen 50 Zeichen nicht überschreiten. Wenn Sie einen ungültigen Namen angeben, wird im Ausgabefenster ein Fehler gemeldet.
Wenn Sie ein Produkt in Azure Sphere Explorer erstellen, werden die fünf Standardgerätegruppen automatisch erstellt. Wenn Sie ein Produkt ohne Gerätegruppen erstellen möchten, verwenden Sie den Befehl azsphere product create oder die öffentliche Azure Sphere-API , und geben Sie --no-default-device-groups an.
Sie können ein Produkt in Azure Sphere Explorer erstellen, aber nicht löschen. Verwenden Sie zum Löschen von Produkten den Befehl azsphere product delete oder die öffentliche Azure Sphere-API.
So erstellen Sie ein Produkt:
Klicken Sie für den Mandanten, an dem Sie interessiert sind, mit der rechten Maustaste auf den Knoten Produkt, und wählen Sie Neues Produkt aus.
Geben Sie einen Namen für das Produkt an, und drücken Sie dann die EINGABETASTE , oder klicken Sie auf Übernehmen. Namen für Produkte dürfen nur alphanumerische Zeichen und Leerzeichen enthalten. Sie dürfen 50 Zeichen nicht überschreiten. Wenn Sie einen ungültigen Namen angeben, wird im Ausgabefenster ein Fehler gemeldet.
Wenn Sie ein Produkt in Azure Sphere Explorer erstellen, werden die fünf Standardgerätegruppen automatisch erstellt. Wenn Sie ein Produkt ohne Gerätegruppen erstellen möchten, verwenden Sie den Befehl azsphere product create oder die öffentliche Azure Sphere-API , und geben Sie --no-default-device-groups an.
Sie können ein Produkt in Azure Sphere Explorer erstellen, aber nicht löschen. Verwenden Sie zum Löschen von Produkten den Befehl azsphere product delete oder die öffentliche Azure Sphere-API.
Aktualisieren eines Produkts
Ändern Sie den Namen oder die Beschreibung eines Produkts jederzeit mithilfe des Befehls azsphere product update oder mithilfe der öffentlichen Azure Sphere-API. So aktualisieren Sie den Namen und die Beschreibung eines Produkts:
azsphere product update --product <product-name> --new-name <new-product-name> --new-description <new-product-description>
Löschen eines Produkts
Löschen Sie ein Produkt jederzeit mithilfe des Befehls azsphere product delete oder mithilfe der öffentlichen Azure Sphere-API.
Ein Produkt kann nur in folgenden Fällen gelöscht werden:
- Der Benutzer verfügt über Administratorberechtigungen für den Mandanten.
- Das Produkt ist leer, und die Gerätegruppen enthalten keine Geräte. Der Befehl azsphere product device list listet alle Geräte in einem Produkt auf. Führen Sie azsphere device update --device-group aus, um das Gerät in eine andere Gerätegruppe zu verschieben, oder azsphere device-group delete , um eine Gerätegruppe zu löschen.
So löschen Sie ein Produkt:
azsphere product delete --product <product-name>
Erweitern Sie für den Mandanten, an dem Sie interessiert sind, den Knoten Produkt.
Um das Produkt umzubenennen, klicken Sie mit der rechten Maustaste auf den Produktnamen, wählen Sie Umbenennen aus, geben Sie einen neuen Produktnamen an, und drücken Sie dann die EINGABETASTE.
Klicken Sie zum Aktualisieren der Beschreibung mit der rechten Maustaste auf den Produktnamen, wählen Sie Beschreibung aktualisieren aus, geben Sie eine neue Beschreibung an, und drücken Sie dann die EINGABETASTE.
Erweitern Sie für den Mandanten, an dem Sie interessiert sind, den Knoten Produkt.
Um das Produkt umzubenennen, wählen Sie den Produktnamen aus, drücken Sie F2 , oder klicken Sie mit der rechten Maustaste auf den Produktnamen, wählen Sie Umbenennen aus, geben Sie einen neuen Produktnamen an, und drücken Sie dann die EINGABETASTE , oder klicken Sie auf Übernehmen.
Um die Beschreibung zu aktualisieren, erweitern Sie das Produkt, wählen Sie Beschreibung aus, drücken Sie F2 , oder klicken Sie mit der rechten Maustaste auf Beschreibung , wählen Sie Ändern aus, geben Sie eine neue Beschreibung an, und drücken Sie dann die EINGABETASTE , oder klicken Sie auf Übernehmen.
Produktdetails anzeigen
Zeigen Sie die Details eines Produkts in Ihrem Mandanten mithilfe des Befehls azsphere product show oder mithilfe der öffentlichen Azure Sphere-API an.
azsphere product show --product <product-name>
So zeigen Sie die Details eines Produkts in Ihrem Mandanten an:
Wählen Sie das Symbol azure Sphere Explorer in der Aktivitätsleiste von Visual Studio Code aus, um Azure Sphere Explorer zu öffnen. Wenn im Bereich Mandant die Option Anmelden angezeigt wird, um Mandanten anzuzeigen, melden Sie sich bei Azure Sphere an, und wählen Sie Aktualisieren aus, um die verfügbaren Mandanten anzuzeigen.
Erweitern Sie für den Mandanten, an dem Sie interessiert sind, den Knoten Produkt.
Erweitern Sie das Produkt, an dem Sie interessiert sind.
Wählen Sie Weitere>Windows>Azure Sphere-Explorer anzeigen aus, um Azure Sphere Explorer zu öffnen. Wenn im Bereich Mandant die Option Anmelden angezeigt wird, um Mandanten anzuzeigen, melden Sie sich bei Azure Sphere an, und wählen Sie Aktualisieren aus, um die verfügbaren Mandanten anzuzeigen.
Erweitern Sie für den Mandanten, an dem Sie interessiert sind, den Knoten Produkt.
Erweitern Sie das Produkt, an dem Sie interessiert sind.