az iot central user

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.46.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az iot zentralen Benutzerbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten und Konfigurieren von IoT Central-Benutzern.

Befehle

Name	Beschreibung	Typ	Status
az iot central user create	Fügen Sie der Anwendung einen Benutzer hinzu.	Erweiterung	Allgemein verfügbar
az iot central user delete	Löschen Sie einen Benutzer aus der Anwendung.	Erweiterung	Allgemein verfügbar
az iot central user list	Liste der Benutzer für eine IoT Central-Anwendung abrufen.	Erweiterung	Allgemein verfügbar
az iot central user show	Rufen Sie die Details eines Benutzers anhand der ID ab.	Erweiterung	Allgemein verfügbar
az iot central user update	Aktualisieren Sie Rollen für einen Benutzer in der Anwendung.	Erweiterung	Allgemein verfügbar

az iot central user create

Fügen Sie der Anwendung einen Benutzer hinzu.

az iot central user create --app-id
                           --assignee
                           --role
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--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 "Info" für Ihre Anwendung im Hilfemenü.

--assignee --user-id

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

Als veraltet markiert

Das Argument "api_version" ist veraltet und wird in einer zukünftigen Version entfernt.

Dieser Befehlsparameter ist veraltet und wird ignoriert. In der zukünftigen Version werden wir nur IoT Central APIs von der neuesten GA-Version unterstützen. Wenn eine API noch nicht GA ist, rufen wir die neueste Vorschauversion auf.

Zulässige Werte: 2022-06-30-preview, 2022-07-31

Standardwert: 2022-07-31

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

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

Standardwert: azureiotcentral.com

--email

E-Mail-Adresse des Benutzers, der der App hinzugefügt werden soll. Wenn dies angegeben ist, werden Dienstprinzipalparameter (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 ebenfalls angegeben werden. Wenn E-Mails angegeben werden, wird dies ignoriert, und der Benutzer ist kein Dienstprinzipalbenutzer, sondern ein standardmäßiger "E-Mail"-Benutzer.

--org-id --organization-id

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

--tenant-id --tnid

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

--token

Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich für die Azure CLI zu authentifizieren, 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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc

Standardwert: json

--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 {2022-06-30-preview, 2022-07-31}]
                           [--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 "Info" für Ihre Anwendung im Hilfemenü.

--assignee --user-id

Id, die dem Benutzer zugeordnet ist.

Optionale Parameter

--api-version --av

Als veraltet markiert

Das Argument "api_version" ist veraltet und wird in einer zukünftigen Version entfernt.

Dieser Befehlsparameter ist veraltet und wird ignoriert. In der zukünftigen Version werden wir nur IoT Central APIs von der neuesten GA-Version unterstützen. Wenn eine API noch nicht GA ist, rufen wir die neueste Vorschauversion auf.

Zulässige Werte: 2022-06-30-preview, 2022-07-31

Standardwert: 2022-07-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 lieber übermitteln möchten, ohne sich für die Azure CLI zu authentifizieren, 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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc

Standardwert: json

--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

Liste der Benutzer für eine IoT Central-Anwendung abrufen.

az iot central user list --app-id
                         [--api-version {2022-06-30-preview, 2022-07-31}]
                         [--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 "Info" für Ihre Anwendung im Hilfemenü.

Optionale Parameter

--api-version --av

Als veraltet markiert

Das Argument "api_version" ist veraltet und wird in einer zukünftigen Version entfernt.

Dieser Befehlsparameter ist veraltet und wird ignoriert. In der zukünftigen Version werden wir nur IoT Central APIs von der neuesten GA-Version unterstützen. Wenn eine API noch nicht GA ist, rufen wir die neueste Vorschauversion auf.

Zulässige Werte: 2022-06-30-preview, 2022-07-31

Standardwert: 2022-07-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 lieber übermitteln möchten, ohne sich für die Azure CLI zu authentifizieren, 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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc

Standardwert: json

--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 anhand der ID ab.

az iot central user show --app-id
                         --assignee
                         [--api-version {2022-06-30-preview, 2022-07-31}]
                         [--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 "Info" für Ihre Anwendung im Hilfemenü.

--assignee --user-id

Id, die dem Benutzer zugeordnet ist.

Optionale Parameter

--api-version --av

Als veraltet markiert

Das Argument "api_version" ist veraltet und wird in einer zukünftigen Version entfernt.

Dieser Befehlsparameter ist veraltet und wird ignoriert. In der zukünftigen Version werden wir nur IoT Central APIs von der neuesten GA-Version unterstützen. Wenn eine API noch nicht GA ist, rufen wir die neueste Vorschauversion auf.

Zulässige Werte: 2022-06-30-preview, 2022-07-31

Standardwert: 2022-07-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 lieber übermitteln möchten, ohne sich für die Azure CLI zu authentifizieren, 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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc

Standardwert: json

--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 Sie Rollen für einen Benutzer in der Anwendung.

Aktualisieren eines Benutzers mit einer anderen Rolle. Das Aktualisieren der tenantId 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 {2022-06-30-preview, 2022-07-31}]
                           [--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 "Info" für Ihre Anwendung im Hilfemenü.

--assignee --user-id

Id, die dem Benutzer zugeordnet ist.

Optionale Parameter

--api-version --av

Als veraltet markiert

Das Argument "api_version" ist veraltet und wird in einer zukünftigen Version entfernt.

Dieser Befehlsparameter ist veraltet und wird ignoriert. In der zukünftigen Version werden wir nur IoT Central APIs von der neuesten GA-Version unterstützen. Wenn eine API noch nicht GA ist, rufen wir die neueste Vorschauversion auf.

Zulässige Werte: 2022-06-30-preview, 2022-07-31

Standardwert: 2022-07-31

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

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

Standardwert: azureiotcentral.com

--email

E-Mail-Adresse des Benutzers, der der App hinzugefügt werden soll. Wenn dies angegeben ist, werden Dienstprinzipalparameter (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 ebenfalls angegeben werden. Wenn E-Mails angegeben werden, wird dies ignoriert, und der Benutzer ist kein Dienstprinzipalbenutzer, sondern ein standardmäßiger "E-Mail"-Benutzer.

--roles

Durch Trennzeichen getrennte 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 angegeben werden, wenn sie mit API-Version ausgeführt werden == 1.1-Preview. Z. B. "organization_id\role".

--tenant-id --tnid

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

--token

Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich für die Azure CLI zu authentifizieren, 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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc

Standardwert: json

--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.