Update-AzConfig

Referenz

Modul:: Az.Accounts

Aktualisiert die Konfigurationen von Azure PowerShell.

Syntax

Update-AzConfig
      [-AppliesTo <String>]
      [-Scope <ConfigScope>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [-CheckForUpgrade <Boolean>]
      [-DefaultSubscriptionForLogin <String>]
      [-DisableErrorRecordsPersistence <Boolean>]
      [-DisableInstanceDiscovery <Boolean>]
      [-DisplayBreakingChangeWarning <Boolean>]
      [-DisplayRegionIdentified <Boolean>]
      [-DisplaySurveyMessage <Boolean>]
      [-EnableDataCollection <Boolean>]
      [-EnableLoginByWam <Boolean>]
      [<CommonParameters>]

Beschreibung

Aktualisiert die Konfigurationen von Azure PowerShell. Je nachdem, auf welche Konfiguration aktualisiert werden soll, können Sie den Bereich angeben, in dem die Konfiguration beibehalten wird und für welches Modul oder Cmdlet es gilt.

Hinweis

Es wird davon abgeraten, Konfigurationen in mehreren PowerShell-Prozessen zu aktualisieren. Führen Sie dies entweder in einem Prozess aus, oder stellen Sie sicher, dass sich die Updates im Prozessbereich (-Scope Process) befinden, um unerwartete Nebenwirkungen zu vermeiden.

Beispiele

Beispiel 1

Update-AzConfig -DefaultSubscriptionForLogin "Name of subscription"

Key                         Value                Applies To Scope       Help Message
---                         -----                ---------- -----       ------------
DefaultSubscriptionForLogin Name of subscription Az         CurrentUser Subscription name or GUID. Sets the default context for Azure PowerShell when lo…

Legt die Konfiguration "DefaultSubscriptionForLogin" als "Name des Abonnements" fest. Wenn Connect-AzAccount das angegebene Abonnement als Standardabonnement ausgewählt wird.

Beispiel 2

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo "Az.KeyVault"

Key                          Value Applies To  Scope       Help Message
---                          ----- ----------  -----       ------------
DisplayBreakingChangeWarning False Az.KeyVault CurrentUser Controls if warning messages for breaking changes are displayed or suppressed. When enabled,…

Legt die Konfigurationskonfiguration "DisplayBreakingChangeWarnings" als "$false" für das Modul "Az.KeyVault" fest. Dadurch wird verhindert, dass alle Warnmeldungen für bevorstehende änderungen im Az.KeyVault-Modul dazu aufgefordert werden.

Beispiel 3

Update-AzConfig -EnableDataCollection $true

Key                  Value Applies To Scope       Help Message
---                  ----- ---------- -----       ------------
EnableDataCollection True  Az         CurrentUser When enabled, Azure PowerShell cmdlets send telemetry data to Microsoft to improve the customer experi…

Legt die Config "EnableDataCollection" als "$true" fest. Dies ermöglicht das Senden der Telemetriedaten. Das Festlegen dieser Konfiguration entspricht Enable-AzDataCollection und Disable-AzDataCollection.

Beispiel 4

Update-AzConfig -DisplaySecretsWarning $true

Key                   Value Applies To Scope       Help Message
---                   ----- ---------- -----       ------------
DisplaySecretsWarning True  Az         CurrentUser When enabled, a warning message for secrets redaction will be displ…

Legt die Konfigurationskonfiguration "DisplaySecretsWarning" als "$true" fest. Dies ermöglicht die Erkennung geheimer Schlüssel während der Cmdlet-Ausführung und zeigt eine Warnmeldung an, wenn geheime Schlüssel in der Ausgabe gefunden werden.

Parameter

-AppliesTo

Gibt an, auf welchen Teil von Azure PowerShell die Konfiguration angewendet wird. Dabei sind folgende Werte möglich:

"Az": Die Konfiguration gilt für alle Module und Cmdlets von Azure PowerShell.
Modulname: Die Konfiguration gilt für ein bestimmtes Modul von Azure PowerShell. Beispiel: "Az.Storage".
Cmdletname: Die Konfiguration gilt für ein bestimmtes Cmdlet von Azure PowerShell. Beispiel: "Get-AzKeyVault". Wenn sie nicht angegeben ist, werden beim Abrufen oder Löschen von Konfigurationen standardmäßig alle oben aufgeführt. beim Aktualisieren wird standardmäßig "Az" verwendet.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CheckForUpgrade

Wenn diese Option aktiviert ist, sucht Azure PowerShell automatisch nach Updates und zeigt eine Hinweismeldung an, wenn ein Update verfügbar ist. Der Standardwert lautet true.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultSubscriptionForLogin

Abonnementname oder GUID. Legt den Standardkontext für Azure PowerShell fest, wenn Sie sich ohne Angabe eines Abonnements anmelden.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DisableErrorRecordsPersistence

Wenn deaktiviert, werden Fehlerdatensätze nicht in ~/geschrieben. Azure/ErrorRecords. Diese Konfiguration wird durch "EnableErrorRecordsPersistence" als Opt-In in der nächsten Hauptversion von Az um November 2023 ersetzt.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DisableInstanceDiscovery

Legen Sie ihn auf "true" fest, um die Instanzermittlung und die Autoritätsüberprüfung zu deaktivieren. Diese Funktionalität ist für Szenarien vorgesehen, in denen der Metadatenendpunkt nicht erreicht werden kann, z. B. in privaten Clouds oder Azure Stack. Der Prozess der Instanzermittlung umfasst das Abrufen von Autoritätsmetadaten zur https://login.microsoft.com/ Überprüfung der Autorität. Durch Festlegen dieses Werts auf "true" ist die Überprüfung der Autorität deaktiviert. Daher ist es wichtig, sicherzustellen, dass der konfigurierte Autoritätshost gültig und vertrauenswürdig ist.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplayBreakingChangeWarning

Steuert, ob Warnmeldungen für unterbrechungsende Änderungen angezeigt oder unterdrückt werden. Wenn diese Option aktiviert ist, wird beim Ausführen von Cmdlets mit unterbrechungsfähigen Änderungen in einer zukünftigen Version eine Warnung angezeigt.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplayRegionIdentified

Wenn diese Option aktiviert ist, zeigt Azure PowerShell Empfehlungen zu Regionen an, die Ihre Kosten verringern können.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplaySecretsWarning

Wenn diese Option aktiviert ist, wird eine Warnmeldung angezeigt, wenn die Cmdlet-Ausgabe geheime Schlüssel enthält. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2258844.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplaySurveyMessage

Wenn diese Option aktiviert ist, werden Sie selten aufgefordert, an Benutzeroberflächenumfragen für Azure PowerShell teilzunehmen.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EnableDataCollection

Wenn diese Option aktiviert ist, senden Azure PowerShell-Cmdlets Telemetriedaten an Microsoft, um die Kundenerfahrung zu verbessern. Weitere Informationen finden Sie in unseren Datenschutzbestimmungen: https://aka.ms/privacy

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EnableLoginByWam

[Vorschau] Wenn diese Option aktiviert ist, ist Web Account Manager (WAM) die standardmäßige interaktive Anmeldeoberfläche. Sie wird auf die Verwendung des Browsers zurückgreifen, wenn die Plattform WAM nicht unterstützt. Beachten Sie, dass dieses Feature in der Vorschau angezeigt wird. Microsoft-Konto (MSA) wird derzeit nicht unterstützt. Wenden Sie sich an das Azure PowerShell-Team, wenn Sie Feedback haben: https://aka.ms/azpsissue

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Scope

Bestimmt den Umfang von Konfigurationsänderungen, z. B. ob Änderungen nur für den aktuellen Prozess gelten, oder für alle Sitzungen, die von diesem Benutzer gestartet wurden. Standardmäßig ist es CurrentUser.

Type:	ConfigScope
Accepted values:	CurrentUser, Process, Default, Environment
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Boolean

String

Ausgaben

PSConfig