Freigeben über


Update-AzConfig

Aktualisiert die Konfigurationen von Azure PowerShell.

Syntax

Default (Standard)

Update-AzConfig
    [-AppliesTo <String>]
    [-Scope <ConfigScope>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [-CheckForUpgrade <Boolean>]
    [-DefaultSubscriptionForLogin <String>]
    [-DisableInstanceDiscovery <Boolean>]
    [-DisplayBreakingChangeWarning <Boolean>]
    [-DisplayRegionIdentified <Boolean>]
    [-DisplaySecretsWarning <Boolean>]
    [-DisplaySurveyMessage <Boolean>]
    [-EnableDataCollection <Boolean>]
    [-EnableErrorRecordsPersistence <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. Mögliche Werte:

  • "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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 ist true.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

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

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultSubscriptionForLogin

Abonnementname oder GUID. Legt den Standardkontext für Azure PowerShell bei der Anmeldung ohne Angabe eines Abonnements fest.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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 aus https://login.microsoft.com/, um die Autorität zu überprüfen. 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.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DisplayRegionIdentified

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

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DisplaySurveyMessage

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

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-EnableErrorRecordsPersistence

Wenn diese Option aktiviert ist, werden Fehlerdatensätze in ~/geschrieben. Azure/ErrorRecords.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-LoginExperienceV2

Nur aktiv beim interaktiven Authentifizieren, ermöglicht es dem Benutzer, das abonnement und den Mandanten auszuwählen, das in nachfolgenden Befehlen verwendet wird. Mögliche Werte anzeigen 'Ein' (Standard) und 'Aus'. "Ein" erfordert die Eingabe des Benutzers. "Aus" verwendet den ersten Mandanten und das von Azure zurückgegebene Abonnement, kann sich ohne Vorheriges ändern und zur Ausführung von Befehlen in einem unerwünschten Kontext führen (nicht empfohlen).

Parametereigenschaften

Typ:LoginExperienceConfig
Standardwert:None
Zulässige Werte:On, Off
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:ConfigScope
Standardwert:None
Zulässige Werte:CurrentUser, Process, Default, Environment
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

Boolean

String

Ausgaben

PSConfig