Freigeben über

az communication user-identity token

  • Vorschau

Note

Diese Referenz ist Teil der Kommunikationserweiterung für die Azure CLI (Version 2.67.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie ein az Kommunikationsbenutzeridentitätstoken Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Die Befehlsgruppe "Kommunikationsbenutzeridentität" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Befehle zum Verwalten von Benutzertoken für eine Kommunikationsdienstressource.

Befehle

Name Beschreibung Typ Status
az communication user-identity token get-for-teams-user

Austauscht ein Azure Active Directory (Azure AD)-Zugriffstoken eines Teams-Benutzers für ein neues ACS Identity-Zugriffstoken mit einer übereinstimmenden Ablaufzeit.

 Extension Preview
az communication user-identity token issue

Gibt ein neues Zugriffstoken mit den angegebenen Bereichen für eine bestimmte Benutzeridentität aus. Wenn keine Benutzeridentität angegeben ist, wird auch eine neue Benutzeridentität erstellt.

 Extension Preview
az communication user-identity token revoke

Widerruft alle Zugriffstoken für die spezifische ACS-Identität.

 Extension Preview

az communication user-identity token get-for-teams-user

Vorschau

Befehlsgruppe "Kommunikationsbenutzeridentitätstoken" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Austauscht ein Azure Active Directory (Azure AD)-Zugriffstoken eines Teams-Benutzers für ein neues ACS Identity-Zugriffstoken mit einer übereinstimmenden Ablaufzeit.

az communication user-identity token get-for-teams-user --aad-token
                                                        --aad-user
                                                        --client
                                                        [--connection-string]

Beispiele

Abrufen von Token für Teams-Benutzer

az communication user-identity token get-for-teams-user --aad-token "aad-123-xyz" --client "app-id-123-xyz" --aad-user "uid"

Erforderliche Parameter

--aad-token

Azure AD-Zugriffstoken eines Teams-Benutzers.

--aad-user

Objekt-ID eines Azure AD-Benutzers (Teams-Benutzer), der anhand des OID-Anspruchs im Azure AD-Zugriffstoken überprüft werden soll.

--client

Client-ID einer Azure AD-Anwendung, die anhand des AppId-Anspruchs im Azure AD-Zugriffstoken überprüft werden soll.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--connection-string

Kommunikationsverbindungszeichenfolge. Umgebungsvariable: AZURE_COMMUNICATION_CONNECTION_STRING.

Eigenschaft Wert
Parametergruppe: Communication Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az communication user-identity token issue

Vorschau

Befehlsgruppe "Kommunikationsbenutzeridentitätstoken" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Gibt ein neues Zugriffstoken mit den angegebenen Bereichen für eine bestimmte Benutzeridentität aus. Wenn keine Benutzeridentität angegeben ist, wird auch eine neue Benutzeridentität erstellt.

az communication user-identity token issue --scope
                                           [--connection-string]
                                           [--user]

Beispiele

Ausstellen von Zugriffstoken

az communication user-identity token issue --scope chat

Problem des Zugriffstokens mit mehreren Bereichen und Benutzern

az communication user-identity token issue --scope chat voip --user "8:acs:xxxxxx"

Erforderliche Parameter

--scope

Liste der Bereiche für ein Zugriffstoken z. B.: Chat/Voip.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--connection-string

Kommunikationsverbindungszeichenfolge. Umgebungsvariable: AZURE_COMMUNICATION_CONNECTION_STRING.

Eigenschaft Wert
Parametergruppe: Communication Arguments
--user

ACS-ID.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az communication user-identity token revoke

Vorschau

Befehlsgruppe "Kommunikationsbenutzeridentitätstoken" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Widerruft alle Zugriffstoken für die spezifische ACS-Identität.

az communication user-identity token revoke --user
                                            [--connection-string]
                                            [--yes]

Beispiele

Widerrufen von Zugriffstoken

az communication user-identity token revoke --user "8:acs:xxxxxx"

Erforderliche Parameter

--user

ACS-ID.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--connection-string

Kommunikationsverbindungszeichenfolge. Umgebungsvariable: AZURE_COMMUNICATION_CONNECTION_STRING.

Eigenschaft Wert
Parametergruppe: Communication Arguments
--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False