Get-AzContext
Obtém os metadados usados para autenticar solicitações do Azure Resource Manager.
Sintaxe
GetSingleContext (Predefinição)
Get-AzContext
[[-Name] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
ListAllContexts
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
Propriedades dos parâmetros
| Tipo: | IAzureContextContainer |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-ListAvailable
Liste todos os contextos disponíveis na sessão atual.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ListAllContexts
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
O nome do contexto
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
GetSingleContext
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-RefreshContextFromTokenCache
Atualizar contextos do cache de token
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ListAllContexts
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
