Partager via

az communication user-identity token

  • Préversion

Note

Cette référence fait partie de l’extension de communication pour Azure CLI (version 2.67.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une az communication user-identity token commande. Apprenez-en davantage sur les extensions.

Le groupe de commandes « communication user-identity » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Commandes permettant de gérer les jetons utilisateur pour une ressource Communication Service.

Commandes

Nom Description Type État
az communication user-identity token get-for-teams-user

Échange un jeton d’accès Azure Active Directory (Azure AD) d’un utilisateur Teams pour un nouveau jeton d’accès d’identité ACS avec un délai d’expiration correspondant.

 Extension Preview
az communication user-identity token issue

Émet un nouveau jeton d’accès avec les étendues spécifiées pour une identité utilisateur donnée. Si aucune identité utilisateur n’est spécifiée, crée également une identité utilisateur.

 Extension Preview
az communication user-identity token revoke

Révoque tous les jetons d’accès pour l’identité ACS spécifique.

 Extension Preview

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

Préversion

Le groupe de commandes « jeton d’identité utilisateur de communication » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Échange un jeton d’accès Azure Active Directory (Azure AD) d’un utilisateur Teams pour un nouveau jeton d’accès d’identité ACS avec un délai d’expiration correspondant.

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

Exemples

Obtenir un jeton pour l’utilisateur teams

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

Paramètres obligatoires

--aad-token

Jeton d’accès Azure AD d’un utilisateur Teams.

--aad-user

ID d’objet d’un utilisateur Azure AD (utilisateur Teams) à vérifier par rapport à la revendication OID dans le jeton d’accès Azure AD.

--client

L’ID client d’une application Azure AD doit être vérifié par rapport à la revendication appId dans le jeton d’accès Azure AD.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--connection-string

Chaîne de connexion de communication. Variable d’environnement : AZURE_COMMUNICATION_CONNECTION_STRING.

Propriété Valeur
Groupe de paramètres: Communication Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az communication user-identity token issue

Préversion

Le groupe de commandes « jeton d’identité utilisateur de communication » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Émet un nouveau jeton d’accès avec les étendues spécifiées pour une identité utilisateur donnée. Si aucune identité utilisateur n’est spécifiée, crée également une identité utilisateur.

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

Exemples

Émettre des jetons d’accès

az communication user-identity token issue --scope chat

Émettre un jeton d’accès avec plusieurs étendues et utilisateurs

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

Paramètres obligatoires

--scope

Liste des étendues d’un jeton d’accès, par exemple : conversation/voip.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--connection-string

Chaîne de connexion de communication. Variable d’environnement : AZURE_COMMUNICATION_CONNECTION_STRING.

Propriété Valeur
Groupe de paramètres: Communication Arguments
--user

Identificateur ACS.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az communication user-identity token revoke

Préversion

Le groupe de commandes « jeton d’identité utilisateur de communication » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Révoque tous les jetons d’accès pour l’identité ACS spécifique.

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

Exemples

Révoquer des jetons d’accès

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

Paramètres obligatoires

--user

Identificateur ACS.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--connection-string

Chaîne de connexion de communication. Variable d’environnement : AZURE_COMMUNICATION_CONNECTION_STRING.

Propriété Valeur
Groupe de paramètres: Communication Arguments
--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False