Configuración de los valores globales de Azure PowerShell

  • Artículo

Azure PowerShell admite varios valores globales, como deshabilitar los mensajes de advertencia de cambios importantes. Antes de la versión 9 del módulo Az PowerShell, no había una forma centralizada o pormenorizada de configurar los valores globales para Azure PowerShell.

Configuración centralizada

Tanto la versión 9 del módulo Az PowerShell como las versiones posteriores incluyen cmdlets para administrar la configuración global para Azure PowerShell. Estos cmdlets de *-AzConfig forman parte del módulo Az.Accounts de PowerShell:

Configuración pormenorizada

Puede aplicar una configuración que solo sea efectiva en un ámbito determinado. Los valores válidos del parámetro Scope son:

  • Current User. El valor predeterminado cuando se aplica una configuración.
  • Process. La configuración solo se aplica a la sesión actual de PowerShell.
  • Default. Ámbito de solo lectura donde no se ha cambiado el valor predeterminado.
  • Environment. Ámbito de solo lectura en el que el valor se ha configurado a través de una variable de entorno.

Además de los ámbitos, la configuración se puede aplicar a todos los módulos de Az PowerShell o a un único módulo. Con el parámetro AppliesTo se puede especificar el alcance de la configuración. El valor Az indica que la configuración se aplica a todos los módulos disponibles que forman parte de Azure PowerShell.

Para deshabilitar el mensaje de advertencia de cambio importante en los cmdlets en el módulo Az.Compute, use el cmdlet Update-AzConfig con los parámetros DisplayBreakingChangeWarning y AppliesTo, como se muestra en el ejemplo siguiente.

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute

En este escenario, el mensaje de advertencia de cambio importante permanece activo para los cmdlets de todos los módulos de Az PowerShell, excepto Az.Compute.

Suscripción predeterminada

De forma predeterminada, al autenticarse en Azure, se recuperan todas las suscripciones a las que se pueda acceder. Se utiliza la primera suscripción que devuelve Azure, a menos que especifique una suscripción con Connect-AzAccount. Este comportamiento puede ser peligroso, por ejemplo, si la primera suscripción devuelta es un entorno de producción.

Para configurar la suscripción predeterminada, use el cmdlet Update-AzConfig con el parámetro DefaultSubscriptionForLogin, como se muestra en el ejemplo siguiente.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Nota

No debe confundirse con la suscripción del contexto predeterminado, la configuración DefaultSubscriptionForLogin solo surte efecto al autenticarse en Azure.

Actualizar notificaciones

Las notificaciones en la herramienta para las actualizaciones de versiones de Azure PowerShell son una característica publicada en la versión 10.3.0 del módulo de Az PowerShell. Cuando hay disponible una nueva versión de Azure PowerShell, se muestra una notificación de actualización en la sesión interactiva de PowerShell.

Para determinar si las notificaciones de actualización están habilitadas, use el cmdlet Get-AzConfig con el parámetro CheckForUpgrade, como se muestra en el ejemplo siguiente.

Get-AzConfig -CheckForUpgrade

Para habilitar las notificaciones de actualización de Azure PowerShell, use el cmdlet Update-AzConfig con el parámetro CheckForUpgrade y $true para su valor, como se muestra en el ejemplo siguiente.

Update-AzConfig -CheckForUpgrade $true

Para desactivar las notificaciones de actualización, use el cmdlet Update-AzConfig con el parámetro CheckForUpgrade y $false para su valor, como se muestra en el ejemplo siguiente.

Update-AzConfig -CheckForUpgrade $false

Identificación de la región de Azure

Los clientes de Azure pueden implementar recursos en diversas regiones. En algunos casos, es posible que los clientes puedan reducir los costos si seleccionan regiones cercanas que ofrecen los mismos servicios. Si se identifica una región cercana, un mensaje indicará la región que se va a seleccionar para futuras implementaciones.

Deshabilitar el mensaje de recomendación de región

En el ejemplo siguiente, el cmdlet Update-AzConfig se usa para deshabilitar el mensaje de recomendación de región:

Update-AzConfig -DisplayRegionIdentified $false

Para más información sobre las regiones de Azure, consulte Elección de la región de Azure adecuada para el usuario.

Replicación de la configuración

Para replicar la configuración de un entorno a otro, use el cmdlet Export-AzConfig para exportar la configuración a un archivo JSON.

Export-AzConfig -Path $HOME\AzConfig.json

Para importar la configuración, use el cmdlet Import-AzConfig y haga referencia al archivo JSON exportado anteriormente.

Import-AzConfig -Path $HOME\AzConfig.json

Eliminación de la configuración

Para restablecer la configuración de uno o varios valores globales de Azure PowerShell a su valor predeterminado, use el cmdlet Clear-AzConfig. En el ejemplo siguiente, se borra el valor DefaultSubscriptionForLogin.

Clear-AzConfig -DefaultSubscriptionForLogin