az iot central user

Hinweis

Dieser Verweis ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.30.0 oder höher). Die Erweiterung wird automatisch beim ersten Ausführen eines az iot-zentralen Benutzerbefehls installiert. Weitere Informationen zu Erweiterungen

Verwalten und Konfigurieren von IoT Central-Benutzern.

Befehle

az iot central user create	Fügen Sie der Anwendung einen Benutzer hinzu.
az iot central user delete	Löschen Sie einen Benutzer aus der Anwendung.
az iot central user list	Rufen Sie eine Liste der Benutzer für eine IoT Central-Anwendung ab.
az iot central user show	Rufen Sie die Details eines Benutzers nach ID ab.
az iot central user update	Aktualisieren von Rollen für einen Benutzer in der Anwendung.

az iot central user create

Fügen Sie der Anwendung einen Benutzer hinzu.

az iot central user create --app-id
                           --assignee
                           --role
                           [--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
                           [--central-api-uri]
                           [--email]
                           [--object-id]
                           [--org-id]
                           [--tenant-id]
                           [--token]

Beispiele

Hinzufügen eines Benutzers per E-Mail zur Anwendung

az iot central user create --user-id {userId} --app-id {appId} --email {emailAddress} --role admin

Hinzufügen eines Dienstprinzipals zur Anwendung

az iot central user create --user-id {userId} --app-id {appId} --tenant-id {tenantId} --object-id {objectId} --role operator

Erforderliche Parameter

--app-id -n

Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Informationen" für Ihre Anwendung im Hilfemenü.

--assignee --user-id

DIE ID, die dem Benutzer zugeordnet ist.

--role -r

Die Rolle, die diesem Token oder Benutzer zugeordnet wird. Sie können eine der integrierten Rollen angeben oder die Rollen-ID einer benutzerdefinierten Rolle angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentral-customrolesdocs.

Optionale Parameter

--api-version --av

Die API-Version für den angeforderten Vorgang.

Zulässige Werte: 1.0, 1.1-preview, 2022-05-31, preview

Standardwert: 2022-05-31

--central-api-uri --central-dns-suffix

Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.

Standardwert: azureiotcentral.com

--email

Email Adresse des Benutzers, der der App hinzugefügt werden soll. Wenn dies angegeben ist, werden dienstprinzipale Parameter (tenant_id und object_id) ignoriert.

--object-id --oid

Objekt-ID für den Dienstprinzipal, der der App hinzugefügt werden soll. Die Mandanten-ID muss auch angegeben werden. Wenn E-Mail angegeben wird, wird dies ignoriert, und der Benutzer ist kein Dienstprinzipalbenutzer, sondern ein Standardbenutzer "E-Mail".

--org-id --organization-id

Die ID der Organisation für die Benutzerrollenzuweisung. Nur für api-Version verfügbar == 1.1-Vorschau.

--tenant-id --tnid

Mandanten-ID für den Dienstprinzipal, der der App hinzugefügt werden soll. Die Objekt-ID muss auch angegeben werden. Wenn E-Mail angegeben wird, wird dies ignoriert, und der Benutzer ist kein Dienstprinzipalbenutzer, sondern ein Standardbenutzer "E-Mail".

--token

Wenn Sie Ihre Anforderung ohne Authentifizierung für die Azure CLI übermitteln möchten, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot central user delete

Löschen Sie einen Benutzer aus der Anwendung.

az iot central user delete --app-id
                           --assignee
                           [--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
                           [--central-api-uri]
                           [--token]

Beispiele

Löschen eines Benutzers

az iot central user delete --app-id {appid} --user-id {userId}

Erforderliche Parameter

--app-id -n

Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Informationen" für Ihre Anwendung im Hilfemenü.

--assignee --user-id

DIE ID, die dem Benutzer zugeordnet ist.

Optionale Parameter

--api-version --av

Die API-Version für den angeforderten Vorgang.

Zulässige Werte: 1.0, 1.1-preview, 2022-05-31, preview

Standardwert: 2022-05-31

--central-api-uri --central-dns-suffix

Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.

Standardwert: azureiotcentral.com

--token

Wenn Sie Ihre Anforderung ohne Authentifizierung für die Azure CLI übermitteln möchten, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot central user list

Rufen Sie eine Liste der Benutzer für eine IoT Central-Anwendung ab.

az iot central user list --app-id
                         [--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
                         [--central-api-uri]
                         [--token]

Beispiele

Liste der Benutzer

az iot central user list --app-id {appid}

Erforderliche Parameter

--app-id -n

Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Informationen" für Ihre Anwendung im Hilfemenü.

Optionale Parameter

--api-version --av

Die API-Version für den angeforderten Vorgang.

Zulässige Werte: 1.0, 1.1-preview, 2022-05-31, preview

Standardwert: 2022-05-31

--central-api-uri --central-dns-suffix

Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.

Standardwert: azureiotcentral.com

--token

Wenn Sie Ihre Anforderung ohne Authentifizierung für die Azure CLI übermitteln möchten, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot central user show

Rufen Sie die Details eines Benutzers nach ID ab.

az iot central user show --app-id
                         --assignee
                         [--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
                         [--central-api-uri]
                         [--token]

Beispiele

Abrufen von Details des Benutzers

az iot central user show --app-id {appid} --user-id {userId}

Erforderliche Parameter

--app-id -n

Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Informationen" für Ihre Anwendung im Hilfemenü.

--assignee --user-id

DIE ID, die dem Benutzer zugeordnet ist.

Optionale Parameter

--api-version --av

Die API-Version für den angeforderten Vorgang.

Zulässige Werte: 1.0, 1.1-preview, 2022-05-31, preview

Standardwert: 2022-05-31

--central-api-uri --central-dns-suffix

Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.

Standardwert: azureiotcentral.com

--token

Wenn Sie Ihre Anforderung ohne Authentifizierung für die Azure CLI übermitteln möchten, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az iot central user update

Aktualisieren von Rollen für einen Benutzer in der Anwendung.

Aktualisieren Sie einen Benutzer mit einer anderen Rolle. Das Aktualisieren der MandantenId oder objectId für einen Dienstprinzipalbenutzer ist nicht zulässig. Das Aktualisieren der E-Mail-Adresse für einen E-Mail-Benutzer ist nicht zulässig.

az iot central user update --app-id
                           --assignee
                           [--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
                           [--central-api-uri]
                           [--email]
                           [--object-id]
                           [--roles]
                           [--tenant-id]
                           [--token]

Beispiele

Aktualisieren Sie Rollen für einen Benutzer per E-Mail oder Dienstprinzipal in der Anwendung.

az iot central user update --user-id {userId} --app-id {appId} --roles "org1\admin"

Erforderliche Parameter

--app-id -n

Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Informationen" für Ihre Anwendung im Hilfemenü.

--assignee --user-id

DIE ID, die dem Benutzer zugeordnet ist.

Optionale Parameter

--api-version --av

Die API-Version für den angeforderten Vorgang.

Zulässige Werte: 1.0, 1.1-preview, 2022-05-31, preview

Standardwert: 2022-05-31

--central-api-uri --central-dns-suffix

Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.

Standardwert: azureiotcentral.com

--email

Email Adresse des Benutzers, der der App hinzugefügt werden soll. Wenn dies angegeben ist, werden dienstprinzipale Parameter (tenant_id und object_id) ignoriert.

--object-id --oid

Objekt-ID für den Dienstprinzipal, der der App hinzugefügt werden soll. Die Mandanten-ID muss auch angegeben werden. Wenn E-Mail angegeben wird, wird dies ignoriert, und der Benutzer ist kein Dienstprinzipalbenutzer, sondern ein Standardbenutzer "E-Mail".

--roles

Kommatrennte Liste der Rollen, die diesem Benutzer zugeordnet werden. Sie können eine der integrierten Rollen angeben oder die Rollen-ID einer benutzerdefinierten Rolle angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentral-customrolesdocs. Organisationen können zusammen mit Rollen bei der Ausführung mit API-Version == 1.1-Vorschau angegeben werden. Z. B. "organization_idrole".

--tenant-id --tnid

Mandanten-ID für den Dienstprinzipal, der der App hinzugefügt werden soll. Die Objekt-ID muss auch angegeben werden. Wenn E-Mail angegeben wird, wird dies ignoriert, und der Benutzer ist kein Dienstprinzipalbenutzer, sondern ein Standardbenutzer "E-Mail".

--token

Wenn Sie Ihre Anforderung ohne Authentifizierung für die Azure CLI übermitteln möchten, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.