Partager via


Clear-AzConfig

Efface les valeurs des configurations définies par l’utilisateur.

Syntaxe

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]
     [-DisableErrorRecordsPersistence]
     [-DisableInstanceDiscovery]
     [-DisplayBreakingChangeWarning]
     [-DisplayRegionIdentified]
     [-DisplaySurveyMessage]
     [-EnableDataCollection]
     [-EnableLoginByWam]
     [<CommonParameters>]

Description

Efface les valeurs des configurations définies par l’utilisateur. Par défaut, toutes les configurations sont effacées. Vous pouvez également spécifier des clés de configuration à effacer.

Exemples

Exemple 1

Clear-AzConfig -Force

Effacez toutes les configurations. -Force supprime l’invite de confirmation.

Exemple 2

Clear-AzConfig -EnableDataCollection

Désactivez la configuration « EnableDataCollection ».

Paramètres

-AppliesTo

Spécifie la partie d’Azure PowerShell à qui la configuration s’applique. Les valeurs possibles sont les suivantes :

  • « Az » : la configuration s’applique à tous les modules et applets de commande d’Azure PowerShell.
  • Nom du module : la configuration s’applique à un certain module d’Azure PowerShell. Par exemple, « Az.Storage ».
  • Nom de l’applet de commande : la configuration s’applique à une certaine applet de commande d’Azure PowerShell. Par exemple, « Get-AzKeyVault ». S’il n’est pas spécifié, lors de l’obtention ou de l’effacement des configurations, il est défini par défaut sur tous les paramètres ci-dessus ; lors de la mise à jour, la valeur par défaut est « Az ».
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CheckForUpgrade

Lorsque cette option est activée, Azure PowerShell vérifie automatiquement les mises à jour et affiche un message d’indicateur lorsqu’une mise à jour est disponible. La valeur par défaut est true.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultSubscriptionForLogin

Nom ou GUID de l’abonnement. Définit le contexte par défaut pour Azure PowerShell lors de la connexion sans spécifier d’abonnement.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableErrorRecordsPersistence

En cas de désactivation, les enregistrements d’erreur ne sont pas écrits dans ~/. Azure/ErrorRecords. Cette configuration sera remplacée par « EnableErrorRecordsPersistence » comme opt-in dans la prochaine version majeure d’Az vers novembre 2023.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableInstanceDiscovery

Définissez-le sur true pour désactiver la découverte d’instances et la validation de l’autorité. Cette fonctionnalité est destinée à être utilisée dans les scénarios où le point de terminaison de métadonnées ne peut pas être atteint, comme dans des clouds privés ou Azure Stack. Le processus de découverte d’instance implique la récupération des métadonnées d’autorité pour https://login.microsoft.com/ valider l’autorité. En définissant cette valeur sur true, la validation de l’autorité est désactivée. Par conséquent, il est essentiel de s’assurer que l’hôte d’autorité configuré est valide et fiable.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayBreakingChangeWarning

Contrôle si les messages d’avertissement pour les modifications cassants sont affichés ou supprimés. Lorsque cette option est activée, un avertissement de changement cassant s’affiche lors de l’exécution d’applets de commande avec des modifications cassants dans une prochaine version.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayRegionIdentified

Lorsque cette option est activée, Azure PowerShell affiche des recommandations sur les régions qui peuvent réduire vos coûts.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplaySecretsWarning

Lorsque cette option est activée, un message d’avertissement s’affiche lorsque la sortie de l’applet de commande contient des secrets. Pour en savoir plus, voir https://go.microsoft.com/fwlink/?linkid=2258844

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplaySurveyMessage

Lorsque vous êtes activé, vous êtes invité à participer rarement à des enquêtes sur l’expérience utilisateur pour Azure PowerShell.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableDataCollection

Lorsque cette option est activée, les applets de commande Azure PowerShell envoient des données de télémétrie à Microsoft pour améliorer l’expérience client. Pour plus d’informations, consultez notre déclaration de confidentialité : https://aka.ms/privacy

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableLoginByWam

[Préversion] Lorsqu’il est activé, le Gestionnaire de comptes web (WAM) est l’expérience de connexion interactive par défaut. Il revient à utiliser le navigateur si la plateforme ne prend pas en charge WAM. Notez que cette fonctionnalité est en préversion. Le compte Microsoft (MSA) n’est actuellement pas pris en charge. N’hésitez pas à contacter l’équipe Azure PowerShell si vous avez des commentaires : https://aka.ms/azpsissue

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Ne demandez pas de confirmation lors de l’effacement de toutes les configurations.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PassThru

Retourne true si l’applet de commande s’exécute correctement.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Scope

Détermine l’étendue des modifications de configuration, par exemple, si les modifications s’appliquent uniquement au processus actuel ou à toutes les sessions démarrées par cet utilisateur. Par défaut, il s’agit de CurrentUser.

Type:ConfigScope
Valeurs acceptées:CurrentUser, Process, Default, Environment
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

Boolean