Freigeben über


az communication identity token

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 Kommunikationsidentitätstoken Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Diese Befehlsgruppe ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "Kommunikationsbenutzeridentitätstoken".

Befehle zum Verwalten von Benutzertoken für eine Kommunikationsdienstressource.

Befehle

Name Beschreibung Typ Status
az communication 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 Deprecated
az communication 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 Deprecated
az communication identity token revoke

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

Extension Deprecated

az communication identity token get-for-teams-user

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "Kommunikationsidentitätstoken" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen "Kommunikationsbenutzeridentitätstoken".

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

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

Beispiele

Abrufen von Token für Teams-Benutzer

az communication 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 identity token issue

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "Kommunikationsidentitätstoken" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen "Kommunikationsbenutzeridentitätstoken".

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 identity token issue --scope
                                      [--connection-string]
                                      [--user]

Beispiele

Ausstellen von Zugriffstoken

az communication identity token issue --scope chat

Problem des Zugriffstokens mit mehreren Bereichen und Benutzern

az communication 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 identity token revoke

Als veraltet markiert

Dieser Befehl ist implizit veraltet, da die Befehlsgruppe "Kommunikationsidentitätstoken" veraltet ist und in einer zukünftigen Version entfernt wird. Verwenden Sie stattdessen "Kommunikationsbenutzeridentitätstoken".

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

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

Beispiele

Widerrufen von Zugriffstoken

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