Partilhar via


az communication user-identity token

Note

Essa referência faz parte da extensão de comunicação para a CLI do Azure (versão 2.67.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az communication user-identity token . Saiba mais sobre extensões.

O grupo de comandos 'communication user-identity' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Comandos para gerenciar tokens de usuário para um recurso do Serviço de Comunicação.

Comandos

Name Description Tipo Status
az communication user-identity token get-for-teams-user

Troca um token de acesso do Azure Ative Directory (Azure AD) de um usuário do Teams por um novo token de acesso do ACS Identity com um tempo de expiração correspondente.

Extension Preview
az communication user-identity token issue

Emite um novo token de acesso com os escopos especificados para uma determinada Identidade de Usuário. Se nenhuma Identidade de Usuário for especificada, criará uma nova Identidade de Usuário também.

Extension Preview
az communication user-identity token revoke

Revoga todos os tokens de acesso para a identidade ACS específica.

Extension Preview

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

Pré-visualizar

O grupo de comandos 'communication user-identity token' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Troca um token de acesso do Azure Ative Directory (Azure AD) de um usuário do Teams por um novo token de acesso do ACS Identity com um tempo de expiração correspondente.

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

Exemplos

Obter token para o usuário do teams

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

Parâmetros Obrigatórios

--aad-token

Token de acesso do Azure AD de um usuário do Teams.

--aad-user

ID de objeto de um usuário do Azure AD (Usuário do Teams) a ser verificado em relação à declaração OID no token de acesso do Azure AD.

--client

ID do cliente de um aplicativo do Azure AD a ser verificado em relação à declaração appId no token de acesso do Azure AD.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--connection-string

Cadeia de conexão de comunicação. Variável de ambiente: AZURE_COMMUNICATION_CONNECTION_STRING.

Propriedade Valor
Grupo de parâmetros: Communication Arguments
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az communication user-identity token issue

Pré-visualizar

O grupo de comandos 'communication user-identity token' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Emite um novo token de acesso com os escopos especificados para uma determinada Identidade de Usuário. Se nenhuma Identidade de Usuário for especificada, criará uma nova Identidade de Usuário também.

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

Exemplos

Emitir token de acesso

az communication user-identity token issue --scope chat

Emitir token de acesso com vários escopos e usuário

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

Parâmetros Obrigatórios

--scope

Lista de escopos para um token de acesso ex: chat/voip.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--connection-string

Cadeia de conexão de comunicação. Variável de ambiente: AZURE_COMMUNICATION_CONNECTION_STRING.

Propriedade Valor
Grupo de parâmetros: Communication Arguments
--user

Identificador ACS.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az communication user-identity token revoke

Pré-visualizar

O grupo de comandos 'communication user-identity token' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Revoga todos os tokens de acesso para a identidade ACS específica.

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

Exemplos

Revogar tokens de acesso

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

Parâmetros Obrigatórios

--user

Identificador ACS.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--connection-string

Cadeia de conexão de comunicação. Variável de ambiente: AZURE_COMMUNICATION_CONNECTION_STRING.

Propriedade Valor
Grupo de parâmetros: Communication Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False