Compartir a través de


Update-AzConfig

Actualiza las configuraciones de Azure PowerShell.

Sintaxis

Default (valor predeterminado)

Update-AzConfig
    [-AppliesTo <String>]
    [-Scope <ConfigScope>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-CheckForUpgrade <Boolean>]
    [-DefaultSubscriptionForLogin <String>]
    [-DisableInstanceDiscovery <Boolean>]
    [-DisplayBreakingChangeWarning <Boolean>]
    [-DisplayRegionIdentified <Boolean>]
    [-DisplaySecretsWarning <Boolean>]
    [-DisplaySurveyMessage <Boolean>]
    [-EnableDataCollection <Boolean>]
    [-EnableErrorRecordsPersistence <Boolean>]
    [-EnableLoginByWam <Boolean>]
    [<CommonParameters>]

Description

Actualiza las configuraciones de Azure PowerShell. Dependiendo de la configuración que se va a actualizar, puede especificar el ámbito en el que se conserva la configuración y a qué módulo o cmdlet se aplica.

Nota:

No se recomienda actualizar las configuraciones en varios procesos de PowerShell. Puede hacerlo en un proceso o asegurarse de que las actualizaciones están en el ámbito de proceso (-Scope Process) para evitar efectos secundarios inesperados.

Ejemplos

Ejemplo 1

Update-AzConfig -DefaultSubscriptionForLogin "Name of subscription"
Key                         Value                Applies To Scope       Help Message
---                         -----                ---------- -----       ------------
DefaultSubscriptionForLogin Name of subscription Az         CurrentUser Subscription name or GUID. Sets the default context for Azure PowerShell when lo…

Establece la configuración "DefaultSubscriptionForLogin" como "Nombre de suscripción". Cuando Connect-AzAccount se seleccione la suscripción especificada como suscripción predeterminada.

Ejemplo 2

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo "Az.KeyVault"
Key                          Value Applies To  Scope       Help Message
---                          ----- ----------  -----       ------------
DisplayBreakingChangeWarning False Az.KeyVault CurrentUser Controls if warning messages for breaking changes are displayed or suppressed. When enabled,…

Establece la configuración "DisplayBreakingChangeWarnings" como "$false" para el módulo "Az.KeyVault". Esto evita que se pidan todos los mensajes de advertencia para los próximos cambios importantes en el módulo Az.KeyVault.

Ejemplo 3

Update-AzConfig -EnableDataCollection $true
Key                  Value Applies To Scope       Help Message
---                  ----- ---------- -----       ------------
EnableDataCollection True  Az         CurrentUser When enabled, Azure PowerShell cmdlets send telemetry data to Microsoft to improve the customer experi…

Establece la configuración "EnableDataCollection" como "$true". Esto permite enviar los datos de telemetría. Establecer esta configuración es equivalente a Enable-AzDataCollection y Disable-AzDataCollection.

Ejemplo 4

Update-AzConfig -DisplaySecretsWarning $true
Key                   Value Applies To Scope       Help Message
---                   ----- ---------- -----       ------------
DisplaySecretsWarning True  Az         CurrentUser When enabled, a warning message for secrets redaction will be displ…

Establece la configuración "DisplaySecretsWarning" como "$true". Esto habilita la detección de secretos durante la ejecución del cmdlet y muestra un mensaje de advertencia si se encuentran secretos en la salida.

Parámetros

-AppliesTo

Especifica a qué parte de Azure PowerShell se aplica la configuración. Los valores posibles son:

  • "Az": la configuración se aplica a todos los módulos y cmdlets de Azure PowerShell.
  • Nombre del módulo: la configuración se aplica a un determinado módulo de Azure PowerShell. Por ejemplo, "Az.Storage".
  • Nombre del cmdlet: la configuración se aplica a un determinado cmdlet de Azure PowerShell. Por ejemplo, "Get-AzKeyVault". Si no se especifica, al obtener o borrar configuraciones, el valor predeterminado es todo lo anterior; al actualizar, el valor predeterminado es "Az".

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CheckForUpgrade

Cuando se habilita, Azure PowerShell comprobará las actualizaciones automáticamente y mostrará un mensaje de sugerencia cuando haya una actualización disponible. El valor predeterminado es true.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultSubscriptionForLogin

Nombre de la suscripción o GUID. Establece el contexto predeterminado de Azure PowerShell al iniciar sesión sin especificar una suscripción.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DisableInstanceDiscovery

Establézcalo en true para deshabilitar la detección de instancias y la validación de autoridad. Esta funcionalidad está pensada para su uso en escenarios en los que no se puede acceder al punto de conexión de metadatos, como en nubes privadas o Azure Stack. El proceso de detección de instancias implica recuperar metadatos de autoridad de https://login.microsoft.com/ para validar la autoridad. Al establecer esto en true, la validación de la autoridad está deshabilitada. Como resultado, es fundamental asegurarse de que el host de autoridad configurado sea válido y de confianza.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DisplayBreakingChangeWarning

Controla si se muestran o suprimen los mensajes de advertencia para los cambios importantes. Cuando se habilita, se muestra una advertencia de cambio importante al ejecutar cmdlets con cambios importantes en una versión futura.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DisplayRegionIdentified

Cuando está habilitada, Azure PowerShell muestra recomendaciones sobre las regiones que pueden reducir los costos.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DisplaySecretsWarning

Cuando se habilita, se mostrará un mensaje de advertencia cuando la salida del cmdlet contenga secretos. Más información en https://go.microsoft.com/fwlink/?linkid=2258844

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-DisplaySurveyMessage

Cuando se habilita, se le pedirá que participe con poca frecuencia en encuestas de experiencia del usuario para Azure PowerShell.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-EnableDataCollection

Cuando se habilita, 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: https://aka.ms/privacy

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-EnableErrorRecordsPersistence

Cuando se habilita, los registros de error se escribirán en ~/. Azure/ErrorRecords.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-EnableLoginByWam

[Versión preliminar] Cuando se habilita, el Administrador de cuentas web (WAM) será la experiencia de inicio de sesión interactiva predeterminada. Se revertirá al uso del explorador si la plataforma no admite WAM. Tenga en cuenta que esta característica está en versión preliminar. La cuenta Microsoft (MSA) no se admite actualmente. No dude en ponerse en contacto con el equipo de Azure PowerShell si tiene comentarios: https://aka.ms/azpsissue

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-LoginExperienceV2

Solo activo al autenticarse de forma interactiva, permite al usuario elegir la suscripción y el inquilino usados en comandos posteriores. Los valores posibles ad 'On' (Predeterminado) y 'Off'. "Activado" requiere la entrada del usuario. "Off" usará el primer inquilino y la suscripción devueltos por Azure, puede cambiar sin previo aviso y provocar la ejecución de comandos en un contexto no deseado (no recomendado).

Propiedades de parámetro

Tipo:LoginExperienceConfig
Valor predeterminado:None
Valores aceptados:On, Off
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Scope

Determina el ámbito de los cambios de configuración, por ejemplo, si los cambios solo se aplican al proceso actual o a todas las sesiones iniciadas por este usuario. De forma predeterminada, es CurrentUser.

Propiedades de parámetro

Tipo:ConfigScope
Valor predeterminado:None
Valores aceptados:CurrentUser, Process, Default, Environment
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

Boolean

String

Salidas

PSConfig