Konfigurieren globaler Azure PowerShell-Einstellungen
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
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für