Freigeben über


Clear-AzConfig

Löscht die Werte der Vom Benutzer festgelegten Konfigurationen.

Syntax

Clear-AzConfig
     [-Force]
     [-PassThru]
     [-AppliesTo <String>]
     [-Scope <ConfigScope>]
     [-DefaultProfile <IAzureContextContainer>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-AzConfig
     [-PassThru]
     [-AppliesTo <String>]
     [-Scope <ConfigScope>]
     [-DefaultProfile <IAzureContextContainer>]
     [-WhatIf]
     [-Confirm]
     [-CheckForUpgrade]
     [-DefaultSubscriptionForLogin]
     [-DisableInstanceDiscovery]
     [-DisplayBreakingChangeWarning]
     [-DisplayRegionIdentified]
     [-DisplaySecretsWarning]
     [-DisplaySurveyMessage]
     [-EnableDataCollection]
     [-EnableErrorRecordsPersistence]
     [-EnableLoginByWam]
     [-LoginExperienceV2]
     [<CommonParameters>]

Beschreibung

Löscht die Werte der Vom Benutzer festgelegten Konfigurationen. Standardmäßig werden alle Konfigurationen gelöscht. Sie können auch Schlüssel der zu löschenden Konfigurationen angeben.

Beispiele

Beispiel 1

Clear-AzConfig -Force

Löschen Sie alle Konfigurationen. -Force unterdrückt die Bestätigungsaufforderung.

Beispiel 2

Clear-AzConfig -EnableDataCollection

Deaktivieren Sie die Konfiguration "EnableDataCollection".

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.
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultSubscriptionForLogin

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayRegionIdentified

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplaySurveyMessage

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableErrorRecordsPersistence

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Bitten Sie nicht um Bestätigung, wenn Sie alle Konfigurationen löschen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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).

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt true zurück, wenn das Cmdlet ordnungsgemäß ausgeführt wird.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:ConfigScope
Zulässige Werte:CurrentUser, Process, Default, Environment
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

Boolean