Configuración de la configuración global de Azure PowerShell
Azure PowerShell ofrece varias configuraciones globales, como la opción para deshabilitar los mensajes de advertencia sobre cambios disruptivos. Antes de la versión 9 del módulo Az PowerShell, no había ningún método centralizado ni detallado para configurar estas opciones globales.
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 la configuración que es efectiva dentro de un ámbito determinado. Los valores válidos para el parámetro Scope son:
Current User: ámbito predeterminado al aplicar una configuración.Process: la configuración solo se aplica a la sesión actual de PowerShell.Default: un ámbito de solo lectura en el que el valor predeterminado no ha cambiado.Environment: un ámbito de solo lectura en el que el valor está configurado a través de una variable de entorno.
Además de los ámbitos, puede aplicar la configuración a todos los módulos de Az o solo a un solo módulo.
Usando el parámetro AppliesTo, puede especificar el alcance con el que desea que se aplique la configuración. El valor Az indica que la configuración se aplica a todos los módulos que forman parte de Azure PowerShell.
Opciones de configuración
Hay numerosas opciones de configuración que puede establecer con los cmdlets de *-AzConfig. Muchas de estas opciones de configuración se muestran en esta sección. Ejecute el comando siguiente para ver una lista completa de las opciones de configuración de Azure PowerShell que puede establecer con los cmdlets de *-AzConfig.
Get-AzConfig | Format-List
Notificaciones de actualización
Las notificaciones en herramientas para las actualizaciones de la versión de Azure PowerShell son una característica publicada en el módulo de PowerShell versión 10.3.0 Az. 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 para 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
Suscripción predeterminada
De forma predeterminada, a partir de Az módulo de PowerShell versión 12.0.0, si tiene acceso a varias suscripciones, se le pedirá que seleccione una suscripción de Azure con la que iniciar sesión.
Para evitar que se le pida que seleccione una suscripción cada vez que inicie sesión de forma interactiva, use el cmdlet Update-AzConfig con el parámetro DefaultSubscriptionForLogin para establecer la suscripción predeterminada, 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 de DefaultSubscriptionForLogin surte efecto solo al autenticarse en Azure.
Detección de instancias
La configuración para deshabilitar el descubrimiento de instancias está diseñada para situaciones donde el punto de conexión de metadatos no es accesible, como en nubes privadas o entornos de Azure Stack. La detección de instancias implica recuperar metadatos de autoridad de https://login.microsoft.com/ para validar la autoridad. Al habilitar esta configuración (esta opción se establece en true), se deshabilita la detección de instancias y la validación de autoridad. Por lo tanto, es esencial asegurarse de que el host de autoridad configurado sea válido y de confianza.
Para deshabilitar la detección de instancias y la validación de autoridad, habilite esta configuración (establézcala en true).
Update-AzConfig -DisableInstanceDiscovery $true
Mensajes de advertencia de cambio importante
Para deshabilitar los mensajes de advertencia de cambios importantes para los cmdlets de todos los módulos de Az, use el cmdlet Update-AzConfig con el parámetro DisplayBreakingChangeWarning como se muestra en el ejemplo siguiente:
Update-AzConfig -DisplayBreakingChangeWarning $false
Para deshabilitar específicamente 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.
Identificación de la región de Azure
Los clientes de Azure pueden optar por implementar recursos en varias regiones diferentes. A veces, los clientes pueden reducir los costos seleccionando regiones cercanas que ofrecen los mismos servicios. Si se identifica una región cercana, un mensaje muestra la región que se va a elegir para futuras implementaciones.
Para deshabilitar los mensajes de recomendación de región, use el cmdlet Update-AzConfig con el parámetro DisplayRegionIdentified, como se muestra en el ejemplo siguiente.
Update-AzConfig -DisplayRegionIdentified $false
Para más información sobre las regiones de Azure, consulte Elija la región de Azure adecuada para.
Visualización de la advertencia de secretos
Azure PowerShell muestra un mensaje de advertencia de forma predeterminada a partir de la versión 12.0.0 para ayudarle a proteger la información confidencial cuando identifica un posible secreto en la salida de un comando.
En el ejemplo siguiente, el cmdlet Update-AzConfig se usa para deshabilitar el mensaje de advertencia.
Update-AzConfig -DisplaySecretsWarning $false
Encuestas
Al usar Azure PowerShell, es posible que se le invite a participar en una encuesta para informarnos sobre su experiencia. Aunque apreciamos la información que proporcionan estos datos, entendemos que no todos los usuarios quieren que completen una encuesta.
Puede deshabilitar que se le pida que participe en encuestas con el cmdlet Update-AzConfig, como se muestra en el ejemplo siguiente.
Update-AzConfig -DisplaySurveyMessage $false
Recogida de datos
De forma predeterminada, los cmdlets de Azure PowerShell envían datos de telemetría a Microsoft para mejorar la experiencia del cliente. Para obtener más información, consulte nuestra declaración de privacidad: aka.ms/privacy.
Update-AzConfig -EnableDataCollection $false
Registros de errores
De forma predeterminada, los registros de errores de Azure PowerShell se escriben en $HOME/.Azure/ErrorRecords.
Para deshabilitar los registros de errores persistentes, use el cmdlet Update-AzConfig con el parámetro EnableErrorRecordsPersistence, como se muestra en el ejemplo siguiente.
Update-AzConfig -EnableErrorRecordsPersistence $false
Administrador de cuentas web (WAM)
A partir de la versión 12.0.0 del módulo de PowerShell Az, los sistemas Windows usan el Administrador de Cuentas Web (WAM) y los sistemas Linux y macOS usan el inicio de sesión basado en navegador de forma predeterminada.
Para usar el inicio de sesión basado en explorador en Windows 10 y versiones posteriores o en Windows Server 2019 y versiones posteriores con Az 12.0.0 y versiones posteriores, debe deshabilitar WAM para su uso con Azure PowerShell. Use el siguiente comando para deshabilitar WAM y volver al inicio de sesión basado en el explorador, el valor predeterminado antes de Az 12.0.0.
Update-AzConfig -EnableLoginByWam $false
Nueva experiencia de inicio de sesión
A partir de Az módulo de PowerShell versión 12.0.0, si tiene acceso a varias suscripciones, se le pedirá que seleccione una suscripción de Azure con la que iniciar sesión.
Cuando se deshabilita la nueva experiencia de inicio de sesión y tiene acceso a varias suscripciones, se inicia sesión en la primera suscripción de Azure a menos que especifique una suscripción con Connect-AzAccount. Los comandos se ejecutan en esta suscripción de forma predeterminada. Este comportamiento puede ser peligroso, por ejemplo, si la primera suscripción devuelta es un entorno de producción.
Para deshabilitar la nueva experiencia de inicio de sesión, use el cmdlet Update-AzConfig, como se muestra en el ejemplo siguiente.
Update-AzConfig -LoginExperienceV2 Off
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
Limpiar la configuración
Para restablecer la configuración de uno o varios valores globales de Azure PowerShell al valor predeterminado, use el cmdlet Clear-AzConfig. En el ejemplo siguiente, se borra la configuración DefaultSubscriptionForLogin.
Clear-AzConfig -DefaultSubscriptionForLogin
