你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az communication user-identity token

注意

此参考是 Azure CLI（版本 2.59.0 或更高版本）的通信扩展的一部分。 该扩展将在首次运行 az communication user-identity token 命令时自动安装。 详细了解扩展。

命令组“通信用户标识”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

用于管理通信服务资源的用户令牌的命令。

命令

名称	说明	类型	Status
az communication user-identity token get-for-teams-user	将 Teams 用户的 Azure Active Directory （Azure AD） 访问令牌交换为具有匹配过期时间的新 ACS 标识访问令牌。	扩展	预览
az communication user-identity token issue	颁发具有给定用户标识的指定范围的新访问令牌。 如果未指定用户标识，则也会创建新的用户标识。	扩展	预览
az communication user-identity token revoke	撤销特定 ACS 标识的所有访问令牌。	扩展	预览

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

预览

命令组“通信用户标识令牌”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

将 Teams 用户的 Azure Active Directory （Azure AD） 访问令牌交换为具有匹配过期时间的新 ACS 标识访问令牌。

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

示例

获取 Teams 用户的令牌

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

必需参数

--aad-token

Teams 用户的 Azure AD 访问令牌。

--aad-user

要根据 Azure AD 访问令牌中的 OID 声明验证的 Azure AD 用户（Teams 用户）的对象 ID。

--client

针对 Azure AD 访问令牌中的 appId 声明验证 Azure AD 应用程序的客户端 ID。

可选参数

--connection-string

通信连接字符串。 环境变量：AZURE_COMMUNICATION_CONNECTION_STRING。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az communication user-identity token issue

预览

命令组“通信用户标识令牌”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

颁发具有给定用户标识的指定范围的新访问令牌。 如果未指定用户标识，则也会创建新的用户标识。

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

示例

颁发访问令牌

az communication user-identity token issue --scope chat

使用多个范围和用户颁发访问令牌

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

必需参数

--scope

访问令牌的范围列表，例如聊天/voip。

可选参数

--connection-string

通信连接字符串。 环境变量：AZURE_COMMUNICATION_CONNECTION_STRING。

--user

ACS 标识符。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az communication user-identity token revoke

预览

命令组“通信用户标识令牌”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

撤销特定 ACS 标识的所有访问令牌。

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

示例

撤销访问令牌

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

必需参数

--user

ACS 标识符。

可选参数

--connection-string

通信连接字符串。 环境变量：AZURE_COMMUNICATION_CONNECTION_STRING。

--yes -y

不提示确认。

默认值: False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。