Konfigurieren globaler Azure PowerShell-Einstellungen

  • Artikel

Azure PowerShell unterstützt mehrere globale Einstellungen wie z. B. das Deaktivieren von Warnmeldungen zu Breaking Changes. Vor Version 9 des Az PowerShell-Moduls gab es keine zentralisierte oder detaillierte Möglichkeit, globale Einstellungen für Azure PowerShell zu konfigurieren.

Zentralisierte Konfiguration

Das Az PowerShell-Modul, Version 9 und höher, enthält Cmdlets zum Verwalten der Konfiguration globaler Einstellungen für Azure PowerShell. Diese *-AzConfig-Cmdlets sind Teil des Az.Accounts-PowerShell-Moduls:

Detaillierte Einstellungen

Sie können Einstellungen anwenden, die nur in einem bestimmten Bereich wirksam sind. Für den Parameter Scope sind folgende Werte gültig:

  • Current User. Der Standardwert beim Anwenden einer Einstellung.
  • Process. Die Einstellung wird nur auf die aktuelle PowerShell-Sitzung angewendet.
  • Default. Schreibgeschützter Bereich, in dem der Standardwert nicht geändert wurde.
  • Environment. Schreibgeschützter Bereich, in dem der Wert über eine Umgebungsvariable konfiguriert wurde.

Neben Bereichen können Sie die Einstellungen auf alle Az PowerShell-Module oder nur auf ein einzelnes Modul anwenden. Mit dem Parameter AppliesTo können Sie angeben, wie umfassend die Einstellung angewendet werden soll. Der Wert Az gibt an, dass die Einstellung auf alle verfügbaren Module angewendet wird, die zu Azure PowerShell gehören.

Um die Warnmeldung zu Breaking Changes für Cmdlets im Modul Az.Compute zu deaktivieren, verwenden Sie das Cmdlet Update-AzConfig mit den Parametern DisplayBreakingChangeWarning und AppliesTo, wie im folgenden Beispiel gezeigt.

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

In diesem Szenario bleibt die Breaking Change-Warnmeldung für Cmdlets in allen Az PowerShell-Modulen mit Ausnahme von Az.Compute aktiv.

Standardabonnement

Wenn Sie sich bei Azure authentifizieren, werden standardmäßig alle Abonnements abgerufen, auf die Sie zugreifen können. Wenn Sie kein Abonnement mit Connect-AzAccount angeben, wird das erste von Azure zurückgegebene Abonnement verwendet. Dieses Verhalten kann gefährlich sein, z. B. wenn das erste zurückgegebene Abonnement eine Produktionsumgebung ist.

Verwenden Sie zum Konfigurieren Ihres Standardabonnements das Cmdlet Update-AzConfig mit dem Parameter DefaultSubscriptionForLogin, wie im folgenden Beispiel gezeigt.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Hinweis

Die Konfiguration DefaultSubscriptionForLogin ist nicht zu verwechseln mit dem Abonnement des Standardkontexts und wird nur bei der Authentifizierung bei Azure wirksam.

Upgradebenachrichtigungen

In-Tool-Benachrichtigungen für Versionsupgrades von Azure PowerShell ist eine Funktion, die in Az PowerShell-Modul, Version 10.3.0 veröffentlicht wurde. Wenn eine neue Version von Azure PowerShell verfügbar ist, wird eine Upgrade-Benachrichtigung in Ihrer interaktiven PowerShell-Sitzung angezeigt.

Um festzustellen, ob Upgradebenachrichtigungen aktiviert sind, verwenden Sie das Cmdlet „Get-AzConfig“ mit dem Parameter CheckForUpgrade, wie im folgenden Beispiel gezeigt.

Get-AzConfig -CheckForUpgrade

Um Upgradebenachrichtigungen für Azure PowerShell zu aktivieren, verwenden Sie das Cmdlet „Update-AzConfig“ mit dem Parameter CheckForUpgrade und „$true“ als Wert, wie im folgenden Beispiel gezeigt.

Update-AzConfig -CheckForUpgrade $true

Um Upgradebenachrichtigungen zu deaktivieren, verwenden Sie das Cmdlet „Update-AzConfig“ mit dem Parameter CheckForUpgrade und „$false“ als Wert, wie im folgenden Beispiel gezeigt.

Update-AzConfig -CheckForUpgrade $false

Azure-Regionsidentifikation

Azure-Kunden können sich für die Bereitstellung von Ressourcen in vielen verschiedenen Regionen entscheiden. In einigen Fällen können Kunden die Kosten senken, indem sie Regionen in der Nähe auswählen, die die gleichen Dienste anbieten. Wenn eine Region in der Nähe bestimmt wird, wird eine Meldung angezeigt, die Region für zukünftige Bereitstellungen auszuwählen.

Deaktivieren der Meldung zur Regionsempfehlung

Im folgenden Beispiel wird das Cmdlet Update-AzConfig verwendet, um die Meldung zur Regionsempfehlung zu deaktivieren.

Update-AzConfig -DisplayRegionIdentified $false

Weitere Informationen zu Azure-Regionen finden Sie unter Auswählen der richtigen Azure-Region für Sie.

Replizieren von Einstellungen

Um Ihre Einstellungen von einer Umgebung in eine andere zu replizieren, exportieren Sie die Einstellungen über das Cmdlet Export-AzConfig in eine JSON-Datei.

Export-AzConfig -Path $HOME\AzConfig.json

Verwenden Sie zum Importieren Ihrer Einstellungen das Cmdlet Import-AzConfig, und verweisen Sie auf die zuvor exportierte JSON-Datei.

Import-AzConfig -Path $HOME\AzConfig.json

Löschen der Konfiguration

Um die Konfigurationseinstellung einer oder mehrerer globaler Azure PowerShell-Einstellungen auf die Standardeinstellung zurückzusetzen, verwenden Sie das Cmdlet Clear-AzConfig. Im folgenden Beispiel wird die Einstellung DefaultSubscriptionForLogin gelöscht.

Clear-AzConfig -DefaultSubscriptionForLogin