Get-AzContext
Obtém os metadados usados para autenticar solicitações do Azure Resource Manager.
Sintaxe
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 Azure Resource Manager.
Este cmdlet obtém a conta do Ative Directory, o locatário do Ative Directory, a assinatura do Azure e o ambiente do Azure de destino.
Os cmdlets do Azure Resource Manager usam essas configurações por padrão ao fazer solicitações do Azure Resource Manager. 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: Obter 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 entrando 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: Listar 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 atualmente disponíveis 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
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-ListAvailable
Liste todos os contextos disponíveis na sessão atual.
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Name
O nome do contexto
Tipo: | String |
Position: | 0 |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-RefreshContextFromTokenCache
Atualizar contextos do cache de token
Tipo: | SwitchParameter |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Entradas
None