Compartir a través de


Get-AzContext

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

Sintaxis

GetSingleContext (Es el valor predeterminado).

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

ListAllContexts

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

Propiedades del parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ListAvailable

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ListAllContexts
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Nombre del contexto

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetSingleContext
Posición:0
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RefreshContextFromTokenCache

Actualizar contextos desde la caché de tokens

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ListAllContexts
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

None

Salidas

PSAzureContext