Get-AzConfig

Pobiera konfiguracje programu Azure PowerShell.

Składnia

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

Opis

Pobiera konfiguracje programu Azure PowerShell. Domyślnie wyświetla listę wszystkich konfiguracji. Wynik można filtrować przy użyciu różnych parametrów.

Uwaga

Konfiguracje mają priorytety. Ogólnie rzecz biorąc, zakres procesu ma wyższy priorytet niż zakres CurrentUser; konfiguracja, która ma zastosowanie do określonego polecenia cmdlet, ma wyższy priorytet niż dotyczy modułu, ponownie wyższy niż Az. Aby zmniejszyć zamieszanie, wynik Get-AzConfig pokazuje te konfiguracje, które zaczynają obowiązywać. Jest to kombinacja wszystkich konfiguracji, ale nie wszystkie konfiguracje. Jednak zawsze można je wyświetlić, stosując różne parametry filtru, takie jak -Scope.

Przykłady

Przykład 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, …

Pobiera wszystkie konfiguracje.

Przykład 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…

Pobiera konfigurację "EnableDataCollection".

Parametry

-AppliesTo

Określa, do której części programu Azure PowerShell ma zastosowanie konfiguracja. Dopuszczalne wartości:

  • "Az": konfiguracja ma zastosowanie do wszystkich modułów i poleceń cmdlet programu Azure PowerShell.
  • Nazwa modułu: konfiguracja ma zastosowanie do określonego modułu programu Azure PowerShell. Na przykład "Az.Storage".
  • Nazwa polecenia cmdlet: konfiguracja ma zastosowanie do określonego polecenia cmdlet programu Azure PowerShell. Na przykład "Get-AzKeyVault". Jeśli nie zostanie określony, podczas pobierania lub czyszczenia konfiguracji wartość domyślna to wszystkie powyższe wartości; podczas aktualizowania wartość domyślna to "Az".
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckForUpgrade

Po włączeniu programu Azure PowerShell będzie automatycznie sprawdzać dostępność aktualizacji i wyświetlać komunikat wskazówek po udostępnieniu aktualizacji. Wartość domyślna to true.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-DefaultSubscriptionForLogin

Nazwa subskrypcji lub identyfikator GUID. Ustawia domyślny kontekst programu Azure PowerShell podczas logowania bez określania subskrypcji.

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

-DisableErrorRecordsPersistence

Po wyłączeniu rekordy błędów nie zostaną zapisane na ~/. Azure/ErrorRecords. Ta konfiguracja zostanie zastąpiona przez wyrażenie "EnableErrorRecordsPersistence" jako wyrażenie zgody w następnej głównej wersji modułu Az około listopada 2023 r.

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

-DisableInstanceDiscovery

Ustaw wartość true, aby wyłączyć zarówno odnajdywanie wystąpień, jak i walidację urzędu. Ta funkcja jest przeznaczona do użycia w scenariuszach, w których nie można uzyskać dostępu do punktu końcowego metadanych, na przykład w chmurach prywatnych lub w usłudze Azure Stack. Proces odnajdywania wystąpień wiąże się z pobieraniem metadanych urzędu z https://login.microsoft.com/ , aby zweryfikować urząd. Ustawiając wartość true, walidacja urzędu jest wyłączona. W związku z tym niezwykle ważne jest upewnienie się, że skonfigurowany host urzędu jest prawidłowy i godny zaufania.

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

-DisplayBreakingChangeWarning

Określa, czy komunikaty ostrzegawcze dotyczące zmian powodujących niezgodność są wyświetlane lub pomijane. Po włączeniu ustawienia zmiany powodującej niezgodność jest wyświetlane podczas wykonywania poleceń cmdlet z powodu zmian powodujących niezgodność w przyszłej wersji.

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

-DisplayRegionIdentified

Po włączeniu program Azure PowerShell wyświetla zalecenia dotyczące regionów, które mogą obniżyć koszty.

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

-DisplaySecretsWarning

Po włączeniu komunikat ostrzegawczy zostanie wyświetlony, gdy dane wyjściowe polecenia cmdlet zawierają wpisy tajne. Dowiedz się więcej na stronie 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

Po włączeniu często pojawia się monit o uczestnictwo w ankietach środowiska użytkownika dla programu Azure PowerShell.

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

-EnableDataCollection

Po włączeniu polecenia cmdlet programu Azure PowerShell wysyłają dane telemetryczne do firmy Microsoft, aby poprawić jakość obsługi klienta. Aby uzyskać więcej informacji, zobacz nasze zasady zachowania poufności informacji: https://aka.ms/privacy

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

-EnableLoginByWam

[Wersja zapoznawcza] Po włączeniu menedżera kont sieci Web (WAM) będzie domyślnym interaktywnym środowiskiem logowania. Jeśli platforma nie obsługuje WAM, wróci do korzystania z przeglądarki. Pamiętaj, że ta funkcja jest w wersji zapoznawczej. Konto Microsoft (MSA) nie jest obecnie obsługiwane. Jeśli masz jakiekolwiek opinie, możesz skontaktować się z zespołem programu Azure PowerShell: https://aka.ms/azpsissue

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

-Scope

Określa zakres zmian konfiguracji, na przykład, czy zmiany mają zastosowanie tylko do bieżącego procesu, czy do wszystkich sesji uruchomionych przez tego użytkownika. Domyślnie jest to CurrentUser.

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

Dane wejściowe

None

Dane wyjściowe

PSConfig