Configurer les paramètres globaux Azure PowerShell

Azure PowerShell offre différents paramètres globaux, tels que l’option permettant de désactiver les messages d’avertissement de modification cassants. Avant la version 9 du module Az PowerShell, aucune méthode centralisée ou détaillée n’a été utilisée pour configurer ces paramètres globaux.

Configuration centralisée

Le module Az PowerShell version 9 et ultérieure inclut des applets de commande pour gérer la configuration des paramètres globaux pour Azure PowerShell. Ces *-AzConfig applets de commande font partie du module PowerShell Az.Accounts :

• Get-AzConfig
• Update-AzConfig
• Export-AzConfig
• Import-AzConfig
• Clear-AzConfig

Paramètres granulaires

Vous pouvez appliquer des paramètres efficaces dans une étendue particulière. Les valeurs valides pour le paramètre Scope sont les suivantes :

• Current User: étendue par défaut lors de l’application d’un paramètre.
• Process: le paramètre est appliqué uniquement à la session PowerShell actuelle.
• Default: étendue en lecture seule où la valeur par défaut n’a pas changé.
• Environment: étendue en lecture seule où la valeur est configurée via une variable d’environnement.

Outre les étendues, vous pouvez appliquer des paramètres à tous les modules Az PowerShell ou à un seul module. À l’aide du paramètre AppliesTo , vous pouvez spécifier la largeur à laquelle vous souhaitez appliquer le paramètre. La valeur Az indique que le paramètre est appliqué à tous les modules qui font partie d’Azure PowerShell.

Options de configuration

Il existe de nombreuses options de configuration que vous pouvez définir avec les *-AzConfig applets de commande. La plupart de ces options de configuration sont affichées dans cette section. Exécutez la commande suivante pour afficher la liste complète des options de configuration Azure PowerShell que vous pouvez définir avec les *-AzConfig applets de commande.

Get-AzConfig | Format-List

Notifications de mise à niveau

Les notifications dans les outils pour les mises à niveau des versions d’Azure PowerShell sont une fonctionnalité publiée dans le module Az PowerShell version 10.3.0. Lorsqu’une nouvelle version d’Azure PowerShell est disponible, une notification de mise à niveau s’affiche dans votre session PowerShell interactive.

Pour déterminer si les notifications de mise à niveau sont activées, utilisez l’applet Get-AzConfig de commande avec le paramètre CheckForUpgrade , comme illustré dans l’exemple suivant.

Get-AzConfig -CheckForUpgrade

Pour activer les notifications de mise à niveau pour Azure PowerShell, utilisez l’applet de commande avec le Update-AzConfig paramètre CheckForUpgrade et $true pour sa valeur, comme illustré dans l’exemple suivant.

Update-AzConfig -CheckForUpgrade $true

Pour désactiver les notifications de mise à niveau, utilisez l’applet Update-AzConfig de commande avec le paramètre CheckForUpgrade et $false pour sa valeur, comme illustré dans l’exemple suivant.

Update-AzConfig -CheckForUpgrade $false

Abonnement par défaut

Par défaut, à partir du module Az PowerShell version 12.0.0, si vous avez accès à plusieurs abonnements, vous êtes invité à sélectionner un abonnement Azure avec lequel vous vous connecter.

Pour éviter d’être invité à sélectionner un abonnement chaque fois que vous vous connectez de manière interactive, utilisez l’applet de commande avec le Update-AzConfig paramètre DefaultSubscriptionForLogin pour définir votre abonnement par défaut, comme illustré dans l’exemple suivant.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Découverte d’instances

Le paramètre de découverte d’instance de désactivation est conçu pour les situations où le point de terminaison de métadonnées est inaccessible, par exemple dans les clouds privés ou les environnements Azure Stack. La découverte d’instances implique la récupération des métadonnées d’autorité https://login.microsoft.com/ pour valider l’autorité. En activant ce paramètre (défini sur true), vous désactivez à la fois la découverte d’instances et la validation de l’autorité. Par conséquent, il est essentiel de s’assurer que l’hôte d’autorité configuré est valide et fiable.

Pour désactiver la découverte d’instances et la validation de l’autorité, activez ce paramètre (défini sur true).

Update-AzConfig -DisableInstanceDiscovery $true

Messages d’avertissement de modification cassants

Pour désactiver les messages d’avertissement de modification cassants pour les applets de commande dans tous les modules Az , utilisez l’applet de commande avec le Update-AzConfigDisplayBreakingChangeWarning paramètre, comme illustré dans l’exemple suivant :

Update-AzConfig -DisplayBreakingChangeWarning $false

Pour désactiver le message d’avertissement de modification cassant spécifiquement pour les applets de commande du module Az.Compute , utilisez l’applet Update-AzConfig de commande avec les paramètres DisplayBreakingChangeWarning et AppliesTo , comme illustré dans l’exemple suivant :

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute

Dans ce scénario, le message d’avertissement de changement cassant reste actif pour les applets de commande dans tous les modules Az PowerShell, à l’exception d’Az.Compute.

Identification de la région Azure

Les clients Azure peuvent choisir de déployer des ressources dans plusieurs régions différentes. Parfois, les clients peuvent réduire les coûts en sélectionnant les régions voisines offrant les mêmes services. Si une région proche est identifiée, un message affiche la région à choisir pour les déploiements futurs.

Pour désactiver les messages de recommandation de région, utilisez l’applet Update-AzConfig de commande avec le paramètre DisplayRegionIdentified , comme illustré dans l’exemple suivant.

Update-AzConfig -DisplayRegionIdentified $false

Pour plus d’informations sur les régions Azure, consultez Choisir la région Azure appropriée pour vous.

Afficher l’avertissement des secrets

Azure PowerShell affiche par défaut un message d’avertissement commençant par la version 12.0.0 pour vous aider à protéger les informations sensibles lorsqu’il identifie un secret potentiel dans la sortie d’une commande.

Dans l’exemple suivant, l’applet Update-AzConfig de commande est utilisée pour désactiver le message d’avertissement.

Update-AzConfig -DisplaySecretsWarning $false

Enquêtes

Lorsque vous utilisez Azure PowerShell, vous pouvez être invité à participer à une enquête pour nous informer de votre expérience. Bien que nous appréciions les insights que ces données fournissent, nous comprenons que tout le monde ne veut pas être invité à effectuer une enquête.

Vous pouvez désactiver l’invite à participer à des enquêtes avec l’applet Update-AzConfig de commande, comme illustré dans l’exemple suivant.

Update-AzConfig -DisplaySurveyMessage $false

Collecte de données

Par défaut, 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é : aka.ms/privacy.

Update-AzConfig -EnableDataCollection $false

Enregistrements d’erreurs

Par défaut, les enregistrements d’erreur Azure PowerShell sont écrits dans $HOME/.Azure/ErrorRecords.

Pour désactiver les enregistrements d’erreurs persistants, utilisez l’applet Update-AzConfig de commande avec le paramètre EnableErrorRecordsPersistence , comme illustré dans l’exemple suivant.

Update-AzConfig -EnableErrorRecordsPersistence $false

Gestionnaire de comptes web (WAM)

À compter du module Az PowerShell version 12.0.0, les systèmes Windows utilisent le Gestionnaire de comptes web (WAM) et les systèmes Linux et macOS utilisent la connexion basée sur un navigateur par défaut.

Pour utiliser la connexion basée sur un navigateur sur Windows 10 et versions ultérieures ou ultérieures ou sur Windows Server 2019 et versions ultérieures avec Az 12.0.0 et versions ultérieures, vous devez désactiver WAM pour une utilisation avec Azure PowerShell. Utilisez la commande suivante pour désactiver WAM et revenir à la connexion basée sur le navigateur, la valeur par défaut avant Az 12.0.0.

Update-AzConfig -EnableLoginByWam $false

Nouvelle expérience de connexion

À compter du module Az PowerShell version 12.0.0, si vous avez accès à plusieurs abonnements, vous êtes invité à sélectionner un abonnement Azure avec lequel vous vous connecter.

Lorsque la nouvelle expérience de connexion est désactivée et que vous avez accès à plusieurs abonnements, vous êtes connecté au premier abonnement qu’Azure retourne, sauf si vous spécifiez un abonnement avec Connect-AzAccount. Les commandes s’exécutent par défaut sur cet abonnement. Ce comportement peut être dangereux, par exemple si le premier abonnement retourné est un environnement de production.

Pour désactiver la nouvelle expérience de connexion, utilisez l’applet Update-AzConfig de commande, comme illustré dans l’exemple suivant.

Update-AzConfig -LoginExperienceV2 Off

Paramètres de réplication

Pour répliquer vos paramètres d’un environnement vers un autre, vous utilisez l’applet Export-AzConfig de commande pour exporter les paramètres dans un fichier JSON.

Export-AzConfig -Path $HOME\AzConfig.json

Pour importer vos paramètres, utilisez l’applet Import-AzConfig de commande et référencez le fichier JSON précédemment exporté.

Import-AzConfig -Path $HOME\AzConfig.json

Effacement de la configuration

Pour réinitialiser le paramètre de configuration d’un ou plusieurs paramètres globaux Azure PowerShell par défaut, utilisez l’applet Clear-AzConfig de commande. Dans l’exemple suivant, le paramètre DefaultSubscriptionForLogin est effacé.

Clear-AzConfig -DefaultSubscriptionForLogin