Compartir a través de


Clear-AzConfig

Borra los valores de las configuraciones establecidas por el usuario.

Sintaxis

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

Description

Borra los valores de las configuraciones establecidas por el usuario. De forma predeterminada, se borrarán todas las configuraciones. También puede especificar las claves de las configuraciones que se van a borrar.

Ejemplos

Ejemplo 1

Clear-AzConfig -Force

Borre todas las configuraciones. -Force suprime el mensaje de confirmación.

Ejemplo 2

Clear-AzConfig -EnableDataCollection

Desactive la configuración "EnableDataCollection".

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".
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultSubscriptionForLogin

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisplayRegionIdentified

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisplaySurveyMessage

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableErrorRecordsPersistence

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

No pida confirmación al borrar todas las configuraciones.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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).

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Devuelve true si el cmdlet se ejecuta correctamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:ConfigScope
Valores aceptados:CurrentUser, Process, Default, Environment
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

Boolean