Get-AzConfig

Ruft die Konfigurationen von Azure PowerShell ab.

Syntax

Get-AzConfig
   [-AppliesTo <String>]
   [-Scope <ConfigScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-CheckForUpgrade]
   [-DefaultSubscriptionForLogin]
   [-DisableErrorRecordsPersistence]
   [-DisableInstanceDiscovery]
   [-DisplayBreakingChangeWarning]
   [-DisplayRegionIdentified]
   [-DisplaySurveyMessage]
   [-EnableDataCollection]
   [-EnableLoginByWam]
   [<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.
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:SwitchParameter
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayRegionIdentified

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplaySurveyMessage

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

Eingaben

None

Ausgaben

PSConfig