Get-AzContext

  • Referência
Módulo:
Az.Accounts

Obtém os metadados usados para autenticar solicitações do Gerenciador de Recursos do Azure.

Syntax

Get-AzContext
   [-DefaultProfile <IAzureContextContainer>]
   [[-Name] <String>]
   [<CommonParameters>]
Get-AzContext
   [-ListAvailable]
   [-RefreshContextFromTokenCache]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Get-AzContext obtém os metadados atuais usados para autenticar solicitações do Gerenciador de Recursos do Azure. Esse cmdlet obtém a conta do Active Directory, o locatário do Active Directory, a assinatura do Azure e o ambiente do Azure de destino. Os cmdlets do Gerenciador de Recursos do Azure usam essas configurações por padrão ao fazer solicitações do Gerenciador de Recursos do Azure. Quando a quantidade disponível de assinatura excede o limite padrão de 25, algumas assinaturas podem não aparecer nos resultados do Get-AzContext -ListAvailable. Por favor, corra Connect-AzAccount -MaxContextPopulation <int> para obter mais contextos.

Exemplos

Exemplo 1: Obtendo o contexto atual

Connect-AzAccount
Get-AzContext

Name                                     Account             SubscriptionName    Environment         TenantId
----                                     -------             ----------------    -----------         --------
Subscription1 (xxxxxxxx-xxxx-xxxx-xxx... test@outlook.com    Subscription1       AzureCloud          xxxxxxxx-x...

Neste exemplo, estamos fazendo logon em nossa conta com uma assinatura do Azure usando Connect-AzAccount e, em seguida, estamos obtendo o contexto da sessão atual chamando Get-AzContext.

Exemplo 2: Listando todos os contextos disponíveis

Get-AzContext -ListAvailable

Name                                     Account             SubscriptionName    Environment         TenantId
----                                     -------             ----------------    -----------         --------
Subscription1 (xxxxxxxx-xxxx-xxxx-xxx... test@outlook.com    Subscription1       AzureCloud          xxxxxxxx-x...
Subscription2 (xxxxxxxx-xxxx-xxxx-xxx... test@outlook.com    Subscription2       AzureCloud          xxxxxxxx-x...
Subscription3 (xxxxxxxx-xxxx-xxxx-xxx... test@outlook.com    Subscription3       AzureCloud          xxxxxxxx-x...

Neste exemplo, todos os contextos disponíveis atualmente são exibidos. O usuário pode selecionar um desses contextos usando Select-AzContext.

Parâmetros

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ListAvailable

Liste todos os contextos disponíveis na sessão atual.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

O nome do contexto

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RefreshContextFromTokenCache

Atualizar contextos do cache de token

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

PSAzureContext