register-user

Registriert einen Benutzer beim Azure Sphere-Sicherheitsdienst.

Dieser Befehl registriert einen Benutzer beim Azure Sphere-Sicherheitsdienst, damit er sich anmelden und einer Rolle in einem oder mehreren Azure Sphere-Mandanten zugewiesen werden kann. Geben Sie beim Registrieren eines Benutzers ein Microsoft-Konto an, wie unter Ein Konto für alle Dinge von Microsoft beschrieben. Dieses Konto kann auch Ihrer vorhandenen E-Mail-Adresse aus einem E-Mail-Konto eines Drittanbieters zugeordnet werden.

Zu diesen Konten gehören die Geschäfts-, Schul- oder Unikonten, die Sie möglicherweise mit früheren Versionen von Azure Sphere verwendet haben, sowie andere Arten von Konten. Dieser Befehl authentifiziert die von Ihnen angegebene E-Mail-Adresse nicht, sodass er jede E-Mail-Adresse akzeptiert, aber ein Benutzer kann sich nur mit einem Microsoft-Konto anmelden.

Nach der Registrierung muss der neue Benutzer azsphere login verwenden, um auf den Mandanten zuzugreifen. Darüber hinaus muss ein Azure Sphere-Mandantenadministrator dem Benutzer mit dem Befehl azsphere role add eine Rolle zuweisen. Ohne zugewiesene Rolle können Benutzer keine Aktionen im Azure Sphere-Mandanten ausführen.

Tipp

Es kann einige Zeit dauern, einen Benutzer zu registrieren, auch wenn der Befehl erfolgreich ist. Es wird empfohlen, einige Sekunden zu warten, bis die Änderungen wirksam werden.

Erforderliche Parameter

Parameter	Typ	Beschreibung
-u, --new-user	Schnur	Zu registrierende Benutzername (E-Mail-Adresse)

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 register-user --new-user <email>
Registration successful.