Udostępnij za pośrednictwem


Clear-AzConfig

Czyści wartości konfiguracji ustawionych przez użytkownika.

Składnia

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>]

Opis

Czyści wartości konfiguracji ustawionych przez użytkownika. Domyślnie wszystkie konfiguracje zostaną wyczyszczone. Można również określić klucze konfiguracji do wyczyszczenia.

Przykłady

Przykład 1

Clear-AzConfig -Force

Wyczyść wszystkie konfiguracje. -Force pomija monit o potwierdzenie.

Przykład 2

Clear-AzConfig -EnableDataCollection

Wyczyść 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".
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultSubscriptionForLogin

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisplayRegionIdentified

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisplaySurveyMessage

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EnableErrorRecordsPersistence

Po włączeniu rekordy błędów zostaną zapisane na ~/. Azure/ErrorRecords.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Nie pytaj o potwierdzenie podczas czyszczenia wszystkich konfiguracji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LoginExperienceV2

Tylko aktywne podczas uwierzytelniania interakcyjnego umożliwia użytkownikowi wybranie subskrypcji i dzierżawy używanej w kolejnych poleceniach. Możliwe wartości reklamy "Włączone" (ustawienie domyślne) i "Wyłączone". Wartość "Włączone" wymaga danych wejściowych użytkownika. Opcja "Wyłączone" będzie używać pierwszej dzierżawy i subskrypcji zwróconej przez platformę Azure, może ulec zmianie bez powiadomienia i prowadzić do wykonywania poleceń w niepożądanym kontekście (niezalecane).

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PassThru

Zwraca wartość true, jeśli polecenie cmdlet jest wykonywane poprawnie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:ConfigScope
Dopuszczalne wartości:CurrentUser, Process, Default, Environment
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Dane wyjściowe

Boolean