Mieter
Verwaltet einen Azure Sphere-Mandanten.
Wichtig
Die Befehle azsphere tenant download-ca-certificate
, azsphere tenant download-ca-certificate-chain
und azsphere tenant download-validation-certificate
sind veraltet. Verwenden Sie azsphere ca-certificate download
stattdessen , azsphere ca-certificate download-chain
, azsphere ca-certificate download-proof
und azsphere ca-certificate list
.
In der Azure Sphere CLI wird der Standardmandant nicht automatisch ausgewählt, wenn ein Mandant erstellt wird. Sie müssen den Befehl azsphere tenant select ausführen, um den Standardmandanten auszuwählen, der für den aktuellen Benutzer auf dem PC verwendet werden soll. Dadurch wird sichergestellt, dass der Standardmandant der richtige ist, der beim Ausführen eines einmaligen Vorgangs verwendet werden kann, den Sie nicht rückgängig machen können, z. B. das Anfordern des Geräts.
Vorgang | Beschreibung |
---|---|
Erstellen | Erstellt einen neuen Mandanten. |
download-error-report | Gibt Fehlerinformationen für Geräte innerhalb des aktuellen Mandanten zurück. |
Liste | Listet die verfügbaren Azure Sphere-Mandanten auf. |
Auswählen | Wählt den Azure Sphere-Standardmandanten aus, der auf diesem Computer verwendet werden soll. |
ausgewählt anzeigen | Zeigt den Azure Sphere-Standardmandanten für diesen Computer an. |
aktualisieren | Updates die Details des Mandanten, z. B. den Namen des Mandanten. |
Erstellen
Erstellt einen neuen Azure Sphere-Mandanten. Zum Ausführen dieses Befehls ist ein angeschlossenes Gerät erforderlich. Weitere Informationen finden Sie unter Erstellen eines Azure Sphere-Mandanten.
Wenn Sie bereits über einen Mandanten verfügen und sicher sind, dass Sie einen anderen Mandanten wünschen, verwenden Sie den --force-additional
-Parameter. Derzeit können Sie einen Azure Sphere-Mandanten nicht löschen.
Nachdem der Mandant erstellt wurde, führen Sie azsphere tenant select aus , um den Standardmandanten auszuwählen, der für den aktuellen Benutzer auf diesem PC verwendet werden soll. Sie können Rollen für Benutzer im aktuellen Azure Sphere-Mandanten hinzufügen, indem Sie den Befehl azsphere role add verwenden .
Der Befehl azsphere tenant create funktioniert mit einem lokal angefügten Azure Sphere-Gerät. Wenn Sie den Befehl ohne angeschlossenes Gerät versuchen, erhalten Sie eine Fehlermeldung. Die Geräte-ID wird beim Erstellen eines Mandanten aufgezeichnet, und pro Gerät kann nur ein Mandant erstellt werden.
Erforderliche Parameter
Parameter | Typ | Beschreibung |
---|---|---|
-n, --name | Schnur | Gibt einen Namen für den Mandanten an. Verwenden Sie beim Benennen Ihres Mandanten alphanumerische Zeichen. Sonderzeichen sind nicht zulässig. Der Name darf 50 Zeichen nicht überschreiten, und die Groß-/Kleinschreibung wird beachtet. |
Optionale Parameter
Parameter | Typ | Beschreibung |
---|---|---|
-d, --device | Schnur | Gibt das Gerät an, auf dem der Befehl ausgeführt werden soll, wenn mehrere Geräte angefügt sind. Dieser Parameter ist erforderlich, wenn mehrere Geräte angefügt sind. Das aktuell angeschlossene Gerät wird standardmäßig verwendet. Sie können die Geräte-ID, die IP-Adresse oder die lokale Verbindungs-ID des angefügten Geräts angeben. Die Azure Sphere CLI unterstützt mehrere MT3620-Geräte unter Windows, aber Sie können unter Linux immer nur ein Gerät gleichzeitig verbinden. Aus diesem Grund wird dieser Parameter für Windows, aber nicht für Linux unterstützt. Wenn Sie diesen Parameter mit dem Befehl unter Linux verwenden, wird ein Fehler zurückgegeben. |
--force-additional | Boolean | Erzwingt die Erstellung eines neuen Azure Sphere-Mandanten. Verwenden Sie diesen Befehl nur, wenn Sie sicher sind, dass Sie das aktuelle Konto verwenden möchten, um mithilfe des angefügten Geräts einen neuen Azure Sphere-Mandanten zu erstellen. |
--disable-confirm-prompt | Boolean | Deaktiviert die Benutzerbestätigungsaufforderung. |
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 tenant create --name MyTenant
Verwenden Sie die --force-additional
Parameter und --disable-confirm-prompt
, wenn Sie sicher sind, dass Sie dieses Konto verwenden möchten, um mithilfe des angefügten Geräts einen neuen Azure Sphere-Mandanten zu erstellen. Ein Gerät, das zuvor zum Erstellen eines Azure Sphere-Mandanten verwendet wurde, kann nicht zum Erstellen eines neuen Mandanten verwendet werden.
azsphere tenant create --name MyTenant --force-additional
You have logged in with the following account:
bob@contoso.com
Do you want to use this account to create a new Azure Sphere tenant using the attached device?
You cannot change the tenant name 'MyTenant1' once it has been created.
Enter 'yes' to continue. Enter anything else to exit.
yes
> verbose: TraceId: c761ba73-761e-4df2-94f5-3f87384d71b7
Created a new Azure Sphere tenant:
--> Tenant Name: MyTenant1
--> Tenant ID: 768c2cd6-059a-49ad-9f53-89f5271cea15
Please use 'azsphere tenant select --tenant MyTenant' to select the created tenant.
Tipp
Nachdem Sie einen Mandanten erstellt haben, stellen Sie sicher, dass Sie azsphere tenant ausführen, wählen Sie den Standardmandanten aus, der für den aktuellen Benutzer auf diesem PC verwendet werden soll.
download-error-report
Gibt Informationen zu Fehlern zurück, die von Geräten innerhalb des aktuellen Mandanten gemeldet werden.
Dieser Befehl ruft Ereignisdaten aus der Azure Sphere Security Service-Cloud ab und erfordert keine physische Verbindung mit einem bestimmten Gerät. Der Befehl azsphere tenant download-error-report funktioniert im Kontext des aktuellen Mandanten und gibt Fehlerberichte für alle Geräte innerhalb dieses Mandanten zurück.
Hinweis
Es kann bis zu 24 Stunden dauern, bis kürzlich gemeldete Ereignisse zum Download verfügbar sind. Weitere Informationen finden Sie unter Sammeln und Interpretieren von Fehlerdaten.
Optionale Parameter
Parameter | Typ | Beschreibung |
---|---|---|
--Ziel | Schnur | Gibt den Pfad und Dateinamen der Ausgabedatei an. |
-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 tenant download-error-report --destination c:\error-report.csv --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
Liste
Listet Azure Sphere-Mandanten auf.
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 tenant list
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
Auswählen
Wählt den Azure Sphere-Standardmandanten aus, der für den aktuellen Benutzer auf diesem PC verwendet werden soll.
Verwenden Sie azsphere tenant show-selected, um den aktuellen Standardmandanten anzuzeigen.
Erforderliche 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 tenant select --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
ausgewählt anzeigen
Zeigt die Details des Azure Sphere-Standardmandanten für den aktuellen Benutzer auf diesem PC an.
Dies ist der Mandant, der mit dem Befehl azsphere tenant select ausgewählt wurde.
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 tenant show-selected
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
143adbc9-1bf0-4be2-84a2-084a331d81cb MyTenant Administrator
Contributor
------------------------------------ --------------------- -------------
aktualisieren
Updates die Details eines Mandanten, z. B. den Namen des Mandanten.
Erforderliche Parameter
Parameter | Typ | Beschreibung |
---|---|---|
-n, --new-name | Schnur | Gibt einen neuen Namen für den Mandanten an. Verwenden Sie beim Benennen Ihres Mandanten alphanumerische Zeichen. Sonderzeichen sind nicht zulässig. Der Name darf 50 Zeichen nicht überschreiten, und die Groß-/Kleinschreibung wird beachtet. |
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 tenant update --tenant a323c263-2aa3-2559-aabb-a3fc32631900 --new-name Tenant2
------------------------------------ --------------------- -------------
Id Name Roles
========================================================================
a323c263-2aa3-2559-aabb-a3fc32631900 Tenant2 Administrator
Contributor
------------------------------------ --------------------- -------------
Tipp
Wenn Sie keinen Standardmandanten ausgewählt haben, wird eine Liste der verfügbaren Mandanten angezeigt. Legen Sie Ihren Standardmandanten fest, indem Sie eine der Optionen auswählen.