Freigeben über


Get-AzConfig

Ruft die Konfigurationen von Azure PowerShell ab.

Syntax

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

Beschreibung

Ruft die Konfigurationen von Azure PowerShell ab. Standardmäßig werden alle Konfigurationen aufgelistet. Sie können das Ergebnis mithilfe verschiedener Parameter filtern.

Hinweis

Configs haben Prioritäten. Im Allgemeinen hat der Prozessbereich eine höhere Priorität als der CurrentUser-Bereich. eine Konfiguration, die für ein bestimmtes Cmdlet gilt, hat eine höhere Priorität als für ein Modul, das erneut höher als Az ist. Um Verwirrung zu reduzieren, zeigt das Ergebnis Get-AzConfig dieser Konfigurationen an, die wirksam werden. Es ist eine Kombination aller Konfigurationen, aber nicht buchstäblich alle Konfigurationen. Sie können sie jedoch immer anzeigen, indem Sie verschiedene Filterparameter anwenden, z -Scope. B. .

Beispiele

Beispiel 1

Get-AzConfig

Key                           Value Applies To Scope       Help Message
---                           ----- ---------- -----       ------------
EnableDataCollection          False Az         CurrentUser When enabled, Azure PowerShell cmdlets send telemetry data to Microsoft to improve the custom…
DefaultSubscriptionForLogin         Az         Default     Subscription name or GUID. Sets the default context for Azure PowerShell when logging in with…
DisplayBreakingChangeWarning  True  Az         Default     Controls if warning messages for breaking changes are displayed or suppressed. When enabled, …

Ruft alle Konfigurationen ab.

Beispiel 2

Get-AzConfig -EnableDataCollection

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

Ruft die Konfiguration "EnableDataCollection" ab.

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

-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

-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

-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

Eingaben

None

Ausgaben

PSConfig