Compartilhar via


Get-AzAccessToken

Obtenha um token de acesso bruto seguro. Ao usar -ResourceUrl, verifique se o valor corresponde ao ambiente atual do Azure. Você pode se referir ao valor de (Get-AzContext).Environment.

OBSERVAÇÃO: O tipo de token de saída padrão atual será alterado de String de texto sem formatação para SecureString para segurança. Use -AsSecureString para migrar para o comportamento seguro antes que a alteração significativa tenha efeitos.

Sintaxe

Get-AzAccessToken
   [-ResourceTypeName <String>]
   [-TenantId <String>]
   [-AsSecureString]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzAccessToken
   -ResourceUrl <String>
   [-TenantId <String>]
   [-AsSecureString]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Obter token de acesso

Exemplos

Exemplo 1 Obter o token de acesso para o ponto de extremidade do ARM

Get-AzAccessToken -AsSecureString

Obter o token de acesso da conta atual para o ponto de extremidade ResourceManager

Exemplo 2 Obter o token de acesso para o ponto de extremidade do Microsoft Graph

Get-AzAccessToken -AsSecureString -ResourceTypeName MSGraph

Obter o token de acesso do ponto de extremidade do Microsoft Graph para conta atual

Exemplo 3 Obter o token de acesso para o ponto de extremidade do Microsoft Graph

Get-AzAccessToken -AsSecureString -ResourceUrl "https://graph.microsoft.com/"

Obter o token de acesso do ponto de extremidade do Microsoft Graph para conta atual

Parâmetros

-AsSecureString

Especificar para converter o token de saída como uma cadeia de caracteres segura. Use sempre o parâmetro para fins de segurança e para evitar a quebra futura de chang e consulte perguntas frequentes sobre o Azure PowerShell de como converter de SecureString em texto sem formatação.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceTypeName

Nome do tipo de recurso opcional, valores compatíveis: AadGraph, AnalysisServices, AppConfiguration, Arm, Atestado, Lote, CommunicationEmail, DataLake, KeyVault, MSGraph, OperationalInsights, ResourceManager, Storage, Synapse. O valor padrão é Arm, se não especificado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceUrl

Url de recurso para a qual você está solicitando token, por exemplo, 'https://graph.microsoft.com/'.

Tipo:String
Aliases:Resource, ResourceUri
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TenantId

ID do locatário opcional. Use a ID do locatário do contexto padrão, se não for especificado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

PSAccessToken

O tipo de saída será preterido.

PSSecureAccessToken

Use -AsSecureString para obter o token como SecureString.