Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Azure PowerShell bietet verschiedene globale Einstellungen, z. B. die Option zum Deaktivieren von Warnmeldungen für unterbrechungsveränderende Änderungen. Vor Version 9 des Az PowerShell-Moduls gab es keine zentrale oder detaillierte Methode zum Konfigurieren dieser globalen Einstellungen.
Zentrale 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:
Granulare Einstellungen
Sie können Einstellungen anwenden, die innerhalb eines bestimmten Bereichs wirksam sind. Die gültigen Werte für den Scope-Parameter sind:
-
Current User: Der Standardbereich beim Anwenden einer Einstellung. -
Process: Die Einstellung wird nur auf die aktuelle PowerShell-Sitzung angewendet. -
Default: Ein schreibgeschützter Bereich, in dem sich der Standardwert nicht geändert hat. -
Environment: Ein schreibgeschützter Bereich, in dem der Wert über eine Umgebungsvariable konfiguriert wird.
Neben Bereichen können Sie Einstellungen auf alle Az PowerShell-Module oder nur ein einzelnes Modul anwenden.
Mit dem Parameter "AppliesTo " können Sie angeben, wie breit die Einstellung angewendet werden soll. Der Wert Az gibt an, dass die Einstellung auf alle Module angewendet wird, die Teil von Azure PowerShell sind.
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 ein Feature, das in Az PowerShell-ModulVersion 10.3.0 veröffentlicht wird. Wenn eine neue Version von Azure PowerShell verfügbar ist, wird in Ihrer interaktiven PowerShell-Sitzung eine Upgradebenachrichtigung angezeigt.
Um festzustellen, ob Upgradebenachrichtigungen aktiviert sind, verwenden Sie das Get-AzConfig Cmdlet mit dem Parameter CheckForUpgrade , wie im folgenden Beispiel gezeigt.
Get-AzConfig -CheckForUpgrade
Um Upgradebenachrichtigungen für Azure PowerShell zu aktivieren, verwenden Sie das Update-AzConfig Cmdlet mit dem Parameter CheckForUpgrade und $true dessen Wert, wie im folgenden Beispiel gezeigt.
Update-AzConfig -CheckForUpgrade $true
Verwenden Sie zum Deaktivieren von Upgradebenachrichtigungen das Update-AzConfig Cmdlet mit dem Parameter CheckForUpgrade und $false dessen Wert, wie im folgenden Beispiel gezeigt.
Update-AzConfig -CheckForUpgrade $false
Standardabonnement
Ab Az PowerShell-Modul, Version 12.0.0, werden Sie standardmäßig aufgefordert, ein Azure-Abonnement auszuwählen, mit dem Sie sich anmelden möchten.
Um zu verhindern, dass jedes Mal, wenn Sie sich interaktiv anmelden, ein Abonnement auswählen, verwenden Sie das Update-AzConfig Cmdlet mit dem Parameter DefaultSubscriptionForLogin , um Ihr Standardabonnement festzulegen, wie im folgenden Beispiel gezeigt.
Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>
Hinweis
Nicht mit dem Abonnement des Standardkontexts zu verwechseln, wird die DefaultSubscriptionForLogin-Konfiguration nur bei der Authentifizierung bei Azure wirksam.
Instanzermittlung
Die Einstellung "Instanzermittlung deaktivieren" wurde für Situationen entwickelt, in denen auf den Metadatenendpunkt nicht zugegriffen werden kann, z. B. in privaten Clouds oder Azure Stack-Umgebungen. Die Instanzermittlung umfasst das Abrufen von Autoritätsmetadaten, um https://login.microsoft.com/ die Autorität zu überprüfen. Durch Aktivieren dieser Einstellung (festlegen 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 (legen Sie sie auf truefest).
Update-AzConfig -DisableInstanceDiscovery $true
Warnmeldungen für die Unterbrechung von Änderungen
Verwenden Sie das Cmdlet mit dem Update-AzConfig Parameter, wie im folgenden Beispiel gezeigt, um die Warnmeldungen für Cmdlets für Cmdlets in allen DisplayBreakingChangeWarning zu deaktivieren:
Update-AzConfig -DisplayBreakingChangeWarning $false
Verwenden Sie das Cmdlet sowohl mit den Update-AzConfig als auch "AppliesTo", wie im folgenden Beispiel gezeigt, um die Warnmeldung zu deaktivieren, die sich speziell auf Cmdlets im Az.Compute-Modul beziehen:
Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute
In diesem Szenario bleibt die Warnmeldung "Änderung unterbrechend" für Cmdlets in allen Az PowerShell-Modulen mit Ausnahme von Az.Compute aktiv.
Azure-Regionsidentifikation
Azure-Kunden können ressourcen in mehreren verschiedenen Regionen bereitstellen. Manchmal können Kunden Kosten senken, indem Sie in der Nähe Regionen auswählen, die dieselben Dienste anbieten. Wenn eine Region in der Nähe identifiziert wird, zeigt eine Meldung die Region an, die für zukünftige Bereitstellungen ausgewählt werden soll.
Verwenden Sie zum Deaktivieren der Regionsempfehlungsmeldungen das Update-AzConfig Cmdlet 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.
Warnung "Geheime Schlüssel anzeigen"
Azure PowerShell zeigt standardmäßig eine Warnmeldung an, die mit Version 12.0.0 beginnt, um vertrauliche Informationen zu schützen, wenn sie einen potenziellen Geheimschlüssel in der Ausgabe eines Befehls identifiziert.
Im folgenden Beispiel wird das Update-AzConfig Cmdlet verwendet, um die Warnmeldung zu deaktivieren.
Update-AzConfig -DisplaySecretsWarning $false
Befragungen
Wenn Sie Azure PowerShell verwenden, werden Sie möglicherweise eingeladen, an einer Umfrage teilzunehmen, um uns über Ihre Erfahrung zu informieren. Obwohl wir die Erkenntnisse schätzen, die diese Daten liefern, verstehen wir, dass nicht jeder aufgefordert werden möchte, eine Umfrage abzuschließen.
Sie können die Teilnahme an Umfragen mit dem Update-AzConfig Cmdlet deaktivieren, wie im folgenden Beispiel gezeigt.
Update-AzConfig -DisplaySurveyMessage $false
Datenerfassung
Standardmäßig senden Azure PowerShell-Cmdlets Telemetriedaten an Microsoft, um die Kundenerfahrung zu verbessern. Weitere Informationen finden Sie in unseren Datenschutzbestimmungen: aka.ms/privacy.
Update-AzConfig -EnableDataCollection $false
Fehlerdatensätze
Standardmäßig werden Azure PowerShell-Fehlerdatensätze in $HOME/.Azure/ErrorRecords.
Verwenden Sie zum Deaktivieren persistenter Fehlerdatensätze das Update-AzConfig Cmdlet mit dem Parameter EnableErrorRecordsPersistence , wie im folgenden Beispiel gezeigt.
Update-AzConfig -EnableErrorRecordsPersistence $false
Web-Kundenbetreuer (WAM)
Ab Az PowerShell-Modul Version 12.0.0 verwenden Windows-Systeme Web Account Manager (WAM) und Linux- und macOS-Systeme standardmäßig 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, der Standardeinstellung vor Az 12.0.0.
Update-AzConfig -EnableLoginByWam $false
Die neue Anmeldeoberfläche
Ab Az PowerShell-Modul, Version 12.0.0, werden Sie aufgefordert, ein Azure-Abonnement auszuwählen, mit dem Sie sich anmelden möchten.
Wenn die neue Anmeldeoberfläche 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 mit Connect-AzAccount. Befehle werden standardmäßig für dieses Abonnement ausgeführt. Dieses Verhalten kann gefährlich sein, z. B. wenn das erste zurückgegebene Abonnement eine Produktionsumgebung ist.
Um die neue Anmeldeoberfläche zu deaktivieren, verwenden Sie das Update-AzConfig Cmdlet, wie im folgenden Beispiel gezeigt.
Update-AzConfig -LoginExperienceV2 Off
Replizieren von Einstellungen
Um Ihre Einstellungen aus einer Umgebung in eine andere zu replizieren, verwenden Sie das Export-AzConfig Cmdlet, um die Einstellungen in eine JSON-Datei zu exportieren.
Export-AzConfig -Path $HOME\AzConfig.json
Verwenden Sie zum Importieren Ihrer Einstellungen das Import-AzConfig Cmdlet, und verweisen Sie auf die zuvor exportierte JSON-Datei.
Import-AzConfig -Path $HOME\AzConfig.json
Löschen der Konfiguration
Verwenden Sie das Cmdlet, um die Konfigurationseinstellung einer oder mehrerer globalen Azure PowerShell-Einstellungen auf die Clear-AzConfig Standardeinstellung zurückzusetzen. Im folgenden Beispiel wird die Einstellung "DefaultSubscriptionForLogin " gelöscht.
Clear-AzConfig -DefaultSubscriptionForLogin
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
Azure PowerShell