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 |
