Update-AzConfig
Mises à jour les configurations d’Azure PowerShell.
Syntax
Update-AzConfig
[-AppliesTo <String>]
[-Scope <ConfigScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-CheckForUpgrade <Boolean>]
[-DefaultSubscriptionForLogin <String>]
[-DisableErrorRecordsPersistence <Boolean>]
[-DisableInstanceDiscovery <Boolean>]
[-DisplayBreakingChangeWarning <Boolean>]
[-DisplayRegionIdentified <Boolean>]
[-DisplaySurveyMessage <Boolean>]
[-EnableDataCollection <Boolean>]
[-EnableLoginByWam <Boolean>]
[<CommonParameters>]
Description
Mises à 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.Stockage ».
- 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CheckForUpgrade
Lorsqu’il est activé, Azure PowerShell case activée pour les mises à jour automatiquement et affiche un message d’indicateur lorsqu’une mise à jour est disponible. La valeur par défaut est true.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Accepted values: | CurrentUser, Process, Default, Environment |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Sorties
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour