Configuración de los valores globales de Azure PowerShell
Azure PowerShell ofrece varias configuraciones globales, como la opción para deshabilitar los mensajes de advertencia de cambios importantes. Antes de la versión 9 del módulo Az PowerShell, no había ningún método centralizado o 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 sea efectiva dentro de un ámbito determinado. Los valores válidos del 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 se configura 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.
Con el parámetro AppliesTo, puede especificar el ancho 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
Actualizar notificaciones
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 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
Suscripción predeterminada
De forma predeterminada, a partir de la versión 12.0.0 del módulo Az PowerShell, si tiene acceso a varias suscripciones de Azure, se le pedirá que seleccione aquella con la que desea 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 DefaultSubscriptionForLogin solo surte efecto al autenticarse en Azure.
Detección de instancias
La configuración de detección de instancias de deshabilitación está diseñada para situaciones en las que 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 implementar recursos en diversas regiones. En algunos casos, los clientes pueden reducir los costes 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.
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 Elección de la región de Azure adecuada para el usuario.
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
Si usa Azure PowerShell, puede que se le invite a participar en una encuesta para informarnos sobre su experiencia. Aunque la información que ofrecen estos datos es muy útil, sabemos que no a todos los usuarios les gusta que le pidan que respondan a una encuesta.
Puede deshabilitar la invitación a encuestas con el cmdlet Update-AzConfig, como se muestra en el ejemplo siguiente.
Update-AzConfig -DisplaySurveyMessage $false
datos, recopilación
De manera 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 Az PowerShell, los sistemas Windows usan el Administrador de cuentas web (WAM), mientras que los sistemas Linux y macOS usan el inicio de sesión basado en explorador de manera 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 explorador, el valor predeterminado antes de Az 12.0.0.
Update-AzConfig -EnableLoginByWam $false
Nuevo inicio de sesión
A partir de la versión 12.0.0 del módulo Az PowerShell, si tiene acceso a varias suscripciones de Azure, se le pedirá que seleccione aquella con la que desea 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 siguiente ejemplo.
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
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
