Partager via


Update-AzConfig

Met à jour les configurations d’Azure PowerShell.

Syntaxe

Default (Par défaut)

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.

Note

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 ».

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

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

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultSubscriptionForLogin

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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é à partir de https://login.microsoft.com/ pour 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.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DisplayRegionIdentified

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

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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, https://go.microsoft.com/fwlink/?linkid=2258844

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DisplaySurveyMessage

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

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-EnableErrorRecordsPersistence

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

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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é).

Propriétés du paramètre

Type:LoginExperienceConfig
Valeur par défaut:None
Valeurs acceptées:On, Off
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:ConfigScope
Valeur par défaut:None
Valeurs acceptées:CurrentUser, Process, Default, Environment
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

Boolean

String

Sorties

PSConfig