Partager via

Configurer les paramètres globaux d’Azure PowerShell

  • Article

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érieures comprend des cmdlets permettant de gérer la configuration des paramètres globaux pour Azure PowerShell. Ces cmdlets *-AzConfig font partie du module PowerShell Az.Accounts :

Paramètres précis

Vous pouvez appliquer des paramètres qui sont effectifs au sein d’une étendue particulière. Les valeurs valides pour le paramètre Scope sont :

  • 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 par le biais d’une variable d’environnement.

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

Options de configuration

De nombreuses options de configuration que vous pouvez définir avec les cmdlets *-AzConfig sont disponibles. 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 cmdlets *-AzConfig.

Get-AzConfig | Format-List

Notifications de mise à niveau

Les notifications dans l’outil pour les mises à niveau de version d’Azure PowerShell sont une fonctionnalité publiée dans le module Az PowerShell version 10.3.0. Quand 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 de commande Get-AzConfig 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 Update-AzConfig avec le paramètre CheckForUpgrade défini sur $true, comme illustré dans l’exemple suivant.

Update-AzConfig -CheckForUpgrade $true

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

Update-AzConfig -CheckForUpgrade $false

Abonnement par défaut

Par défaut, à 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 connectez.

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

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Remarque

La configuration DefaultSubscriptionForLogin prend uniquement effet lors de l’authentification auprès d’Azure (à ne pas confondre avec l’abonnement du contexte par défaut).

Messages d’avertissement de changement cassant

Pour désactiver les messages d’avertissement de changement cassant pour les cmdlets dans tous les modules Az, utilisez la cmdlet Update-AzConfig avec le paramètre DisplayBreakingChangeWarning, comme illustré dans l’exemple suivant :

Update-AzConfig -DisplayBreakingChangeWarning $false

Pour désactiver le message d’avertissement de changement cassant spécifiquement pour les cmdlets dans le module Az.Compute, utilisez la cmdlet Update-AzConfig 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 cmdlets 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 voisine 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 la cmdlet Update-AzConfig 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 qui vous convient.

Afficher l’avertissement des secrets

À compter de la version 12.0.0, Azure PowerShell affiche un message d’avertissement par défaut pour vous aider à protéger les informations sensibles quand il identifie un secret potentiel dans la sortie d’une commande.

Dans l’exemple suivant, l’applet de commande Update-AzConfig 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 faire part de votre expérience. Même si les insights au travers de ces données nous sont très utiles, nous comprenons que tout le monde ne souhaite pas être invité à répondre à une enquête.

Vous pouvez désactiver l’invitation à participer aux enquêtes avec la cmdlet Update-AzConfig, comme illustré dans l’exemple suivant.

Update-AzConfig -DisplaySurveyMessage $false

Collecte de données

Par défaut, les cmdlets 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’erreurs Azure PowerShell sont écrits dans $HOME/.Azure/ErrorRecords.

Pour désactiver les enregistrements d’erreurs persistants, utilisez la cmdlet Update-AzConfig 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), tandis que 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 sur Windows Server 2019 et versions ultérieures avec Az 12.0.0 et versions ultérieures, vous devez désactiver le WAM pour une utilisation avec Azure PowerShell. Utilisez la commande suivante pour désactiver le WAM et revenir à la connexion basée sur le navigateur, 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 connectez.

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. Par défaut, les commandes s’exécutent 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 la cmdlet Update-AzConfig, comme illustré dans l’exemple suivant.

Update-AzConfig -LoginExperienceV2 Off

Réplication des paramètres

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

Export-AzConfig -Path $HOME\AzConfig.json

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

Import-AzConfig -Path $HOME\AzConfig.json

Effacement de la configuration

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

Clear-AzConfig -DefaultSubscriptionForLogin