Azure PowerShell objetos de contexto

Azure PowerShell usa Azure PowerShell objetos de contexto (contextos de Azure) para contener información de suscripción y autenticación. Si tiene acceso a varias suscripciones, los contextos de Azure le permiten seleccionar la suscripción sobre la que ejecutar los cmdlets de Azure PowerShell. Los contextos de Azure también se utilizan para almacenar información de inicio de sesión, en varias sesiones de PowerShell, y ejecutar tareas en segundo plano.

En este artículo se describe la administración de contextos de Azure, no la administración de suscripciones o cuentas. Si desea administrar usuarios, suscripciones, inquilinos u otra información de cuenta, consulte la documentación de Microsoft Entra ID. Para obtener información sobre el uso de contextos para ejecutar tareas en segundo plano o paralelas, consulte Run Azure PowerShell cmdlets en trabajos de PowerShell después de familiarizarse con los contextos de Azure.

Introducción a los objetos de contexto de Azure

Azure contextos son objetos de PowerShell que representan la suscripción activa para ejecutar comandos y la información de autenticación necesaria para conectarse a una nube de Azure. Con los contextos de Azure, Azure PowerShell no necesita volver a autenticar su cuenta cada vez que cambie de suscripción. Un contexto de Azure consta de:

• El account que se usó para iniciar sesión en Azure con Connect-AzAccount. Azure contexto trata a los usuarios, los identificadores de aplicación y las entidades de servicio de la misma manera desde la perspectiva de una cuenta.
• El suscripción activa, un contrato de servicio con Microsoft para crear y ejecutar recursos de Azure, que están asociados con un tenant. A menudo, los inquilinos se conocen como organizaciones en la documentación o al trabajar con Microsoft Entra.
• Referencia a una caché token, un token de autenticación almacenado para acceder a una nube de Azure. La configuración de guardado automático del contexto determina dónde se almacena el token y cuánto tiempo persiste.

Para obtener más información sobre estos términos, vea Microsoft Entra Terminología. Los tokens de autenticación usados por Azure contextos son los mismos que otros tokens almacenados que forman parte de una sesión persistente.

Al iniciar sesión con Connect-AzAccount, se crea al menos un contexto de Azure para la suscripción predeterminada. El objeto devuelto por Connect-AzAccount es el contexto de Azure predeterminado usado para el resto de la sesión de PowerShell.

Obtener contextos de Azure

Los contextos de Azure disponibles se recuperan con el cmdlet Get-AzContext. Enumere los contextos disponibles con el parámetro ListAvailable :

Get-AzContext -ListAvailable

O bien, obtenga un contexto por nombre:

Get-AzContext -Name MyContextName

Los nombres de contexto pueden ser diferentes del nombre de la suscripción asociada. Para determinar el nombre de contexto, use el valor de la propiedad Name , que no se muestra de forma predeterminada.

Get-AzContext -ListAvailable | Select-Object -Property *

Crear un nuevo contexto de Azure a partir de la información de la suscripción

El cmdlet Set-AzContext se usa para crear y establecer nuevos contextos de Azure como contexto activo. La manera más fácil de crear un nuevo contexto de Azure es usar la información de suscripción existente. El cmdlet Set-AzContext está diseñado para tomar el resultado de objeto de Get-AzSubscription como un valor canalizado y configurar un nuevo contexto de Azure.

Get-AzSubscription -SubscriptionName MySubscriptionName |
  Set-AzContext -Name MyContextName

Indique el nombre o el identificador de la suscripción y el ID del inquilino si es necesario:

Set-AzContext -Name MyContextName -Subscription MySubscriptionName -Tenant 00000000-0000-0000-0000-000000000000

Si se omite el parámetro Name , el nombre y el identificador de la suscripción se usan como nombre de contexto en el formato Subscription Name (subscription-id).

Cambiar el contexto de Azure activo

Tanto Set-AzContext como Select-AzContext se pueden usar para cambiar el contexto de Azure activo. Como se describe en Crear un nuevo contexto de Azure, Set-AzContext crea un nuevo contexto de Azure para una suscripción si no existe y, a continuación, cambia el contexto activo a ese.

Select-AzContext está diseñado para usarse solo con contextos de Azure existentes y funciona de forma similar al uso de Set-AzContext -Context, pero está diseñado para su uso con tuberías:

Set-AzContext -Context (Get-AzContext -Name MyContextName) # Set a context with an inline Azure context object
Get-AzContext -Name MyContextName | Select-AzContext # Set a context with a piped Azure context object

Al igual que muchos otros comandos de administración de cuentas y contextos en Azure PowerShell, Set-AzContext y Select-AzContext admiten el parámetro Scope para que pueda controlar cuánto tiempo está activo el contexto. El ámbito le permite cambiar el contexto activo de una sola sesión sin cambiar el valor predeterminado:

Get-AzContext -Name MyContextName | Select-AzContext -Scope Process

Para evitar cambiar contextos para toda una sesión de PowerShell, se pueden ejecutar comandos Azure PowerShell con un parámetro AzContext en un contexto determinado:

$context = Get-AzContext -Name MyContextName
New-AzVM -Name ExampleVM -AzContext $context

El otro uso principal de contextos con cmdlets de Azure PowerShell es ejecutar comandos en segundo plano. Para más información sobre cómo ejecutar trabajos de PowerShell mediante Azure PowerShell, consulte Run Azure PowerShell cmdlets en trabajos de PowerShell.

Guardar contextos de Azure en sesiones de PowerShell

De forma predeterminada, los contextos de Azure se guardan para su uso entre sesiones de PowerShell. Puede cambiar este comportamiento de las maneras siguientes:

• Inicie sesión usando -Scope Process con Connect-AzAccount.

  Connect-AzAccount -Scope Process
  

  El contexto de Azure devuelto como parte de este inicio de sesión es válido únicamente para la sesión actual y no se guarda automáticamente, independientemente de la configuración de autoguardado del contexto de Azure PowerShell.

• Deshabilite el guardado automático del contexto en Azure PowerShell con el cmdlet Disable-AzContextAutosave. Deshabilitar el autoguardado de contexto no borra ningún token almacenado. Para obtener información sobre cómo borrar la información de contexto de Azure almacenada, consulte Remove Azure contextos y credenciales almacenadas.

• Para habilitar explícitamente el autoguardado del contexto de Azure, se puede utilizar el cmdlet Enable-AzContextAutosave. Con el guardado automático habilitado, los contextos de un usuario se almacenan localmente para sesiones posteriores de PowerShell.

• Guarde manualmente contextos con Save-AzContext para usarlos en futuras sesiones de PowerShell, donde se pueden cargar con Import-AzContext:

  Save-AzContext -Path current-context.json # Save the current context
  Import-AzContext -Path other-context.json # Load the context from a file and set it to the current context
  

Cada uno de estos comandos admite el parámetro Scope , que puede tomar un valor de Process para aplicar solo al proceso en ejecución actual. Por ejemplo, para asegurarse de que los contextos recién creados no se guardan después de salir de una sesión de PowerShell:

Disable-AzContextAutosave -Scope Process
Set-AzContext -Subscription 'Subscription ID or Name' -Tenant 00000000-0000-0000-0000-000000000000

La información de contexto y los tokens se almacenan en el directorio $env:USERPROFILE\.Azure en Windows y $HOME/.Azure en otras plataformas. Es posible que la información confidencial, como los identificadores de suscripción y los identificadores de inquilino, se exponga en información almacenada, a través de registros o contextos guardados. Para obtener información sobre cómo borrar la información almacenada, consulte Remove Azure contextos y credenciales almacenadas.

Eliminación de contextos de Azure y credenciales almacenadas

Para borrar contextos de Azure y credenciales:

• Cierre la sesión de una cuenta con Disconnect-AzAccount. Puede cerrar la sesión de cualquier cuenta por cuenta o contexto:

  Disconnect-AzAccount # Disconnect active account
  Disconnect-AzAccount -Username 'user@contoso.com' # Disconnect by account name
  Disconnect-AzAccount -ContextName MyContextName # Disconnect by context name
  
  $context = Get-AzContext
  Disconnect-AzAccount -AzureContext $context # Disconnect using context object information
  

  La desconexión siempre quita los tokens de autenticación almacenados y borra los contextos guardados asociados con el usuario o el contexto desconectados.

• Utilice Clear-AzContext. Este cmdlet siempre quita los contextos almacenados y los tokens de autenticación y cierra la sesión.

• Elimina un contexto con Remove-AzContext:

  Remove-AzContext -Name MyContextName # Remove by name
  Get-AzContext -Name MyContextName | Remove-AzContext # Remove by piping an Azure context object
  

  Si quita el contexto activo, se desconecta de Azure y necesita volver a autenticarse con Connect-AzAccount.

Consulte también

• Connect-AzAccount
• Disconnect-AzAccount
• Get-AzContext
• Set-AzContext
• Save-AzContext
• Select-AzContext
• Import-AzContext
• Clear-AzContext
• Remove-AzContext
• Enable-AzContextAutosave
• Disable-AzContextAutosave
• Get-AzSubscription