Verwalten von Produkten
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.
Ein Produkt identifiziert einen Azure Sphere-Mikrocontroller (MCU), der in ein verbundenes Gerät integriert ist und eine bestimmte Funktion ausführen soll. Als Hersteller erstellen Sie ein Produkt für jedes Modell eines angeschlossenen Geräts, z. B. einen Kühlschrank oder einen Kaffeemaschine. Contoso erstellt beispielsweise ein Produkt für seine DW100-Geschirrspüler und ordnet bei der Fertigung dieses Produkt jedem DW100-Geschirrspüler zu. Jedes Produkt hat eine GUID, die innerhalb des Mandanten eindeutig ist und nicht geändert werden kann.
Jedes verbundene Gerät verfügt über ein einzelnes Produkt, ein einzelnes Produkt kann jedoch vielen Geräten zugeordnet werden. Jedes Produkt verfügt über einen Namen, der innerhalb des Mandanten eindeutig sein muss, und zusätzlich über eine Beschreibung. Produktname und Beschreibung bieten eine von Menschen lesbare Unterscheidungsmöglichkeit für die einzelnen Produkte. Name und Beschreibung des Produkts können beliebig oft geändert werden.
Produkte auflisten
Auflisten aller Produkte in Ihrem Azure Sphere-Mandanten mithilfe des Azsphere-Produktlistenbefehls oder mithilfe der öffentlichen Azure Sphere-API.
So listen Sie alle Produkte auf:
azsphere product list
Eine Meldung wird möglicherweise angezeigt, wenn der Standardmandant nicht ausgewählt ist. 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 Azure Sphere Explorer-Symbol in der Aktivitätsleiste von Visual Studio Code aus, um Azure Sphere Explorer zu öffnen. Wenn im Mandantenbereich "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 "Andere Windows>Azure Sphere Explorer anzeigen>" aus, um Azure Sphere Explorer zu öffnen. Wenn im Mandantenbereich "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.
Ein Produkt erstellen
Erstellen Sie ein Produkt in Ihrem Azure Sphere-Mandanten mithilfe des Azsphere-Produkterstellungsbefehls oder mithilfe der öffentlichen Azure Sphere-API.
So erstellen Sie ein Produkt
azsphere product create --name <product-name>
Ersetzen Sie <den Produktnamen> 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 entweder der Name oder die Beschreibung Leerzeichen enthält, schließen Sie ihn in Anführungszeichen ein.
Wenn Sie ein neues Produkt erstellen, erstellt Azure Sphere standardmäßig automatisch fünf Gerätegruppen zur Verwendung bei der Erstellung von Bereitstellungen. Die fünf Standardgerätegruppen sind "Development", "Field Test", "Production", "Field Test OS Evaluation" und "Production OS Evaluation". Verwenden Sie den 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, eine Beschreibung der einzelnen Produkte bereitzustellen. Sie können einem Produkt eine Beschreibung wie folgt hinzufügen:
azsphere product create --name <product-name> --description <product-description>
So erstellen Sie ein Produkt
Klicken Sie für den gewünschten Mandanten 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 im 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 Azsphere-Produkterstellungsbefehl oder die öffentliche Azure Sphere-API , und geben Sie "--no-default-device-groups" an.
Sie können ein Produkt im Azure Sphere Explorer erstellen, aber nicht löschen. Um Produkte zu löschen, verwenden Sie den Befehl zum Löschen des Azsphere-Produkts oder die öffentliche Azure Sphere-API.
So erstellen Sie ein Produkt
Klicken Sie für den gewünschten Mandanten 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 im 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 Azsphere-Produkterstellungsbefehl oder die öffentliche Azure Sphere-API , und geben Sie "--no-default-device-groups" an.
Sie können ein Produkt im Azure Sphere Explorer erstellen, aber nicht löschen. Um Produkte zu löschen, verwenden Sie den Befehl zum Löschen des Azsphere-Produkts oder die öffentliche Azure Sphere-API.
Aktualisieren eines Produkts
Ändern Sie den Namen oder die Beschreibung eines Produkts jederzeit mithilfe des Azsphere-Produktupdatebefehls 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>
Ein Produkt löschen
Löschen Sie ein Produkt jederzeit mithilfe des Azsphere-Produktlöschbefehls oder mithilfe der öffentlichen Azure Sphere-API.
Ein Produkt kann nur gelöscht werden, wenn:
- 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-Produktgeräteliste " 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 oder Azsphere-Gerätegruppe zu verschieben, 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, und wählen Sie "Umbenennen" aus, geben Sie einen neuen Produktnamen an, und drücken Sie dann die EINGABETASTE.
Um die Beschreibung zu aktualisieren, klicken Sie mit der rechten Maustaste auf den Produktnamen, wählen Sie "Beschreibung aktualisieren", 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, und 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", 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-Produktpräsentation" 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 Azure Sphere Explorer-Symbol in der Aktivitätsleiste von Visual Studio Code aus, um Azure Sphere Explorer zu öffnen. Wenn im Mandantenbereich "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 "Andere Windows>Azure Sphere Explorer anzeigen>" aus, um Azure Sphere Explorer zu öffnen. Wenn im Mandantenbereich "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.