Konfigurieren globaler Azure PowerShell-Einstellungen
Azure PowerShell bietet verschiedene globale Einstellungen, z. B. die Option zum Deaktivieren von Warnmeldungen Breaking Changes. Vor Version 9 des Az PowerShell-Moduls gab es keine zentrale oder detaillierte Methode zum Konfigurieren dieser globalen Einstellungen.
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 in einem bestimmten Bereich wirksam sind. Für den Parameter Scope sind folgende Werte gültig:
Current User: Der Standardumfang beim Anwenden einer Einstellung.Process: Die Einstellung wird nur auf die aktuelle PowerShell-Sitzung angewendet.Default: Schreibgeschützter Bereich, in dem sich der Standardwert nicht verändert hat.Environment: Schreibgeschützter Bereich, in dem der Wert über eine Umgebungsvariable konfiguriert wird.
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 Module angewendet wird, die zu Azure PowerShell gehören.
Konfigurationsoptionen
Es gibt zahlreiche Konfigurationsoptionen, die Sie mit den *-AzConfig-Cmdlets festlegen können. Viele dieser Konfigurationsoptionen werden in diesem Abschnitt gezeigt. Führen Sie den folgenden Befehl aus, um eine vollständige Liste der Azure PowerShell-Konfigurationsoptionen anzuzeigen, die Sie mit den *-AzConfig-Cmdlets festlegen können.
Get-AzConfig | Format-List
Upgradebenachrichtigungen
In-Tool-Benachrichtigungen für Azure PowerShell-Versionsupgrades 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
Standardabonnement
Ab Version 12.0.0 des Az PowerShell-Moduls werden Sie standardmäßig aufgefordert, ein Azure-Abonnement für die Anmeldung auszuwählen, falls Sie Zugriff auf mehrere Abonnements haben.
Um zu verhindern, dass Sie bei jeder interaktiven Anmeldung zum Auswählen eines Abonnements aufgefordert werden, verwenden Sie das Cmdlet Update-AzConfig mit dem Parameter DefaultSubscriptionForLogin, um Ihr Standardabonnement festzulegen, 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.
Instanzermittlung
Die Einstellung „Instanzermittlung deaktivieren“ wurde für Situationen entwickelt, in denen nicht auf den Metadatenendpunkt zugegriffen werden kann, z. B. in privaten Clouds oder Azure Stack-Umgebungen. Die Instanzermittlung umfasst das Abrufen von Autoritätsmetadaten von https://login.microsoft.com/, um die Autorität zu überprüfen. Durch Aktivieren dieser Einstellung (Festlegung auf true) deaktivieren Sie sowohl die Instanzermittlung als auch die Autoritätsüberprüfung. Daher ist es wichtig sicherzustellen, dass der konfigurierte Autoritätshost gültig und vertrauenswürdig ist.
Aktivieren Sie diese Einstellung, um sowohl die Instanzermittlung als auch die Autoritätsüberprüfung zu deaktivieren (Festlegung auf true).
Update-AzConfig -DisableInstanceDiscovery $true
Warnmeldungen zu Breaking Changes
Verwenden Sie das Cmdlet Update-AzConfig mit dem Parameter DisplayBreakingChangeWarning, um die Warnmeldungen für Cmdlets in allen Az-Modulen zu deaktivieren.
Update-AzConfig -DisplayBreakingChangeWarning $false
Um die Warnmeldung zu Breaking Changes speziell für Cmdlets im Modul Az.Compute zu deaktivieren, verwenden Sie das Cmdlet Update-AzConfig mit den beiden 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.
Azure-Regionsidentifikation
Azure-Kunden können sich für die Bereitstellung von Ressourcen in 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.
Verwenden Sie zum Deaktivieren der Meldungen mit Regionsempfehlungen das Cmdlet Update-AzConfig mit dem Parameter DisplayRegionIdentified, wie im folgenden Beispiel gezeigt.
Update-AzConfig -DisplayRegionIdentified $false
Weitere Informationen zu Azure-Regionen finden Sie unter Auswählen der richtigen Azure-Region für Sie.
Anzeigen der Warnung zu geheimen Schlüsseln
Azure PowerShell zeigt standardmäßig ab Version 12.0.0 eine Warnmeldung an, um vertrauliche Informationen zu schützen, wenn es ein potenzielles Geheimnis in der Ausgabe eines Befehls identifiziert.
Im folgenden Beispiel wird das Cmdlet Update-AzConfig verwendet, um die Warnmeldung zu deaktivieren.
Update-AzConfig -DisplaySecretsWarning $false
Umfragen
Wenn Sie Azure PowerShell verwenden, werden Sie möglicherweise zur Teilnahme an einer Umfrage eingeladen, um uns Ihre Erfahrungen mitzuteilen. Wir schätzen die Erkenntnisse, die uns diese Daten liefern, wissen aber auch, dass es Benutzer gibt, die nicht zur Teilnahme an einer Umfrage eingeladen werden möchten.
Die Aufforderung zur Teilnahme an Umfragen kann mithilfe des Cmdlets Update-AzConfig deaktiviert werden, wie im folgenden Beispiel gezeigt.
Update-AzConfig -DisplaySurveyMessage $false
Datensammlung
Azure PowerShell-Cmdlets senden standardmäßig Telemetriedaten an Microsoft, um das Kundenerlebnis zu verbessern. Weitere Informationen finden Sie in den Datenschutzbestimmungen: aka.ms/privacy.
Update-AzConfig -EnableDataCollection $false
Fehlerdatensätze
Standardmäßig werden Azure PowerShell-Fehlerdatensätze in $HOME/.Azure/ErrorRecords geschrieben.
Verwenden Sie zum Deaktivieren persistenter Fehlerdatensätze das Cmdlet Update-AzConfig mit dem Parameter EnableErrorRecordsPersistence, wie im folgenden Beispiel gezeigt.
Update-AzConfig -EnableErrorRecordsPersistence $false
Web Account Manager (WAM)
Ab Version 12.0.0 des Az PowerShell-Moduls verwenden Windows-Systeme standardmäßig Web Account Manager (WAM) und Linux- und macOS-Systeme browserbasierte Anmeldung.
Um die browserbasierte Anmeldung unter Windows 10 und höher oder unter Windows Server 2019 und höher mit Az 12.0.0 und höher zu verwenden, müssen Sie WAM für die Verwendung mit Azure PowerShell deaktivieren. Verwenden Sie den folgenden Befehl, um WAM zu deaktivieren und zur browserbasierten Anmeldung zurückzukehren (die Standardmethode vor Az 12.0.0).
Update-AzConfig -EnableLoginByWam $false
Die neue Anmeldeoberfläche
Ab Version 12.0.0 des Az PowerShell-Moduls werden Sie aufgefordert, ein Azure-Abonnement für die Anmeldung auszuwählen, falls Sie Zugriff auf mehrere Abonnements haben.
Wenn die neue Anmeldeumgebung deaktiviert ist und Sie Zugriff auf mehrere Abonnements haben, werden Sie beim ersten Abonnement angemeldet, das Azure zurückgibt, es sei denn, Sie geben ein Abonnement nicht mit Connect-AzAccount an. Befehle werden für dieses Abonnement standardmäßig ausgeführt. Dieses Verhalten kann gefährlich sein, z. B. wenn das erste zurückgegebene Abonnement eine Produktionsumgebung ist.
Um die neue Anmeldeumgebung zu deaktivieren, verwenden Sie das Cmdlet Update-AzConfig, wie im folgenden Beispiel gezeigt:
Update-AzConfig -LoginExperienceV2 Off
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