Compartir a través de

Configuración de la configuración global de Azure PowerShell

  • Artículo

Azure PowerShell ofrece varias configuraciones globales, como la opción de 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 ni detallado para configurar estas opciones globales.

Configuración centralizada

La Az módulo de PowerShell versión 9 y versiones posteriores incluye cmdlets para administrar la configuración de la configuración global para Azure PowerShell. Los cmdlets *-AzConfig son parte del módulo Az.Accounts PowerShell.

Configuración pormenorizadas

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 Az o solo a un solo módulo. Con el parámetro AppliesTo, puede especificar la amplitud con la 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 Az módulo de PowerShell versión 10.3.0. 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 de deshabilitar la detección de instancias 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 obtener los metadatos de autoridad desde 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 cambios importantes

Para deshabilitar los mensajes de advertencia de cambios que rompen compatibilidad 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 el mensaje de advertencia de cambio importante específicamente para los cmdlets del módulo Az.Compute de, 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 en todos los módulos de Az PowerShell, excepto en 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.

Mostrar 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 tienes acceso a varias suscripciones, se te conecta a la primera suscripción que Azure devuelve a menos que especifiques 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

Borrar 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