Partager via


Update-AzConfig

Met à jour les configurations d’Azure PowerShell.

Syntaxe

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

Met à jour les configurations d’Azure PowerShell. Selon la configuration à mettre à jour, vous pouvez spécifier l’étendue à laquelle la configuration est conservée et à quel module ou applet de commande il s’applique.

Remarque

Il est déconseillé de mettre à jour les configurations dans plusieurs processus PowerShell. Effectuez-le dans un processus ou assurez-vous que les mises à jour se trouvent dans l’étendue du processus (-Scope Process) pour éviter les effets secondaires inattendus.

Exemples

Exemple 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…

Définit la configuration « DefaultSubscriptionForLogin » comme « Nom de l’abonnement ». Lorsque Connect-AzAccount l’abonnement spécifié est sélectionné comme abonnement par défaut.

Exemple 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,…

Définit la configuration « DisplayBreakingChangeWarnings » comme « $false » pour le module « Az.KeyVault ». Cela empêche tous les messages d’avertissement pour les modifications cassantes à venir dans le module Az.KeyVault d’inviter.

Exemple 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…

Définit la configuration « EnableDataCollection » comme « $true ». Cela permet d’envoyer les données de télémétrie. La définition de cette configuration est équivalente à Enable-AzDataCollection et Disable-AzDataCollection.

Exemple 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…

Définit la configuration « DisplaySecretsWarning » comme « $true ». Cela permet la détection des secrets pendant l’exécution de l’applet de commande et affiche un message d’avertissement si des secrets sont trouvés dans la sortie.

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:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-EnableErrorRecordsPersistence

Lorsque cette option est activée, les enregistrements d’erreur sont écrits dans ~/. Azure/ErrorRecords.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LoginExperienceV2

Actif uniquement lors de l’authentification interactive, permet à l’utilisateur de choisir l’abonnement et le locataire utilisés dans les commandes suivantes. Valeurs possibles « On » (Valeur par défaut) et « Off ». « Activé » nécessite l’entrée de l’utilisateur. « Désactivé » utilise le premier locataire et l’abonnement retournés par Azure, peut changer sans préavis et entraîner l’exécution de commandes dans un contexte indésirable (non recommandé).

Type:LoginExperienceConfig
Valeurs acceptées:On, Off
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
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

Boolean

String

Sorties

PSConfig