Get-AzContext

  • Referencia
Módulo:
Az.Accounts

Obtiene los metadatos usados para autenticar las solicitudes de Azure Resource Manager.

Sintaxis

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

Description

El cmdlet Get-AzContext obtiene los metadatos actuales que se usan para autenticar solicitudes de Azure Resource Manager. Este cmdlet obtiene la cuenta de Active Directory, el inquilino de Active Directory, la suscripción de Azure y el entorno de Azure de destino. Los cmdlets de Azure Resource Manager usan esta configuración de forma predeterminada al realizar solicitudes de Azure Resource Manager. Cuando la cantidad disponible de suscripción supera el límite predeterminado de 25, es posible que algunas suscripciones no aparezcan en los resultados de Get-AzContext -ListAvailable. Connect-AzAccount -MaxContextPopulation <int> Ejecute para obtener más contextos.

Ejemplos

Ejemplo 1: Obtención del contexto actual

Connect-AzAccount
Get-AzContext

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

En este ejemplo, estamos iniciando sesión en nuestra cuenta con una suscripción de Azure mediante Connect-AzAccount y, a continuación, obtenemos el contexto de la sesión actual llamando a Get-AzContext.

Ejemplo 2: Enumerar todos los contextos disponibles

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...

En este ejemplo, se muestran todos los contextos disponibles actualmente. El usuario puede seleccionar uno de estos contextos mediante Select-AzContext.

Parámetros

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ListAvailable

Enumere todos los contextos disponibles en la sesión actual.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Nombre del contexto

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RefreshContextFromTokenCache

Actualizar contextos desde la caché de tokens

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

PSAzureContext