Get-AzContext

  • Referencia
Módulo:
Az.Accounts

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

Syntax

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

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

-ListAvailable

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

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

-Name

Nombre del contexto

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

-RefreshContextFromTokenCache

Actualizar contextos desde la caché de tokens

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

Entradas

None

Salidas

PSAzureContext