Sdílet prostřednictvím


Clear-AzConfig

Vymaže hodnoty konfigurací, které uživatel nastavil.

Syntaxe

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

Description

Vymaže hodnoty konfigurací, které uživatel nastavil. Ve výchozím nastavení se vymažou všechny konfigurace. Můžete také zadat klíče konfigurace, které se mají vymazat.

Příklady

Příklad 1

Clear-AzConfig -Force

Vymažte všechny konfigurace. -Force potlačuje výzvu k potvrzení.

Příklad 2

Clear-AzConfig -EnableDataCollection

Vymažte konfiguraci EnableDataCollection.

Parametry

-AppliesTo

Určuje, na jakou část Azure PowerShellu se konfigurace vztahuje. Možné hodnoty jsou:

  • Az: Konfigurace se vztahuje na všechny moduly a rutiny Azure PowerShellu.
  • Název modulu: Konfigurace se vztahuje na určitý modul Azure PowerShellu. Například Az.Storage.
  • Název rutiny: Konfigurace se vztahuje na určitou rutinu Azure PowerShellu. Například Get-AzKeyVault. Pokud není zadáno, při získávání nebo vymazání konfigurací se ve výchozím nastavení použije všechny výše uvedené hodnoty; při aktualizaci se ve výchozím nastavení nastaví na Az.
Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CheckForUpgrade

Pokud je tato možnost povolená, Azure PowerShell automaticky vyhledá aktualizace a zobrazí zprávu nápovědy, když je k dispozici aktualizace. Výchozí hodnota je true.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultSubscriptionForLogin

Název předplatného nebo identifikátor GUID. Nastaví výchozí kontext Azure PowerShellu při přihlašování bez zadání předplatného.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisableInstanceDiscovery

Nastavte hodnotu true, aby se zakázalo zjišťování instancí i ověřování autority. Tato funkce je určená pro použití ve scénářích, kdy není možné dosáhnout koncového bodu metadat, například v privátních cloudech nebo ve službě Azure Stack. Proces zjišťování instancí zahrnuje načtení metadat autority z https://login.microsoft.com/ ověření autority. Když tuto hodnotu nastavíte na true, ověření autority je zakázané. V důsledku toho je důležité zajistit, aby byl nakonfigurovaný hostitel autority platný a důvěryhodný.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisplayBreakingChangeWarning

Určuje, jestli se zobrazují nebo potlačí zprávy upozornění na zásadní změny. Pokud je tato možnost povolená, zobrazí se při spouštění rutin s zásadními změnami v budoucí verzi upozornění na změnu způsobující chybu.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisplayRegionIdentified

Když je tato možnost povolená, Azure PowerShell zobrazí doporučení pro oblasti, které můžou snížit náklady.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisplaySecretsWarning

Pokud je tato možnost povolená, zobrazí se zpráva s upozorněním, když výstup rutiny obsahuje tajné kódy. Další informace najdete na adrese https://go.microsoft.com/fwlink/?linkid=2258844

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DisplaySurveyMessage

Pokud je tato možnost povolená, budete vyzváni zřídka k účasti v průzkumech uživatelského prostředí pro Azure PowerShell.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnableDataCollection

Pokud je tato možnost povolená, rutiny Azure PowerShellu odesílají do Microsoftu telemetrická data, aby se zlepšilo uživatelské prostředí. Další informace najdete v našem prohlášení o zásadách ochrany osobních údajů: https://aka.ms/privacy

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnableErrorRecordsPersistence

Pokud je tato možnost povolená, zapíšou se do ~/. Azure/ErrorRecords.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnableLoginByWam

[Preview] Pokud je tato možnost povolená, bude výchozím interaktivním přihlašováním správce webových účtů (WAM). Pokud platforma nepodporuje WAM, vrátí se zpět do prohlížeče. Upozorňujeme, že tato funkce je ve verzi Preview. Účet Microsoft (MSA) se v současné době nepodporuje. Pokud máte nějaké připomínky, můžete se obrátit na tým Azure PowerShellu: https://aka.ms/azpsissue

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Při vymazání všech konfigurací nepožádejte o potvrzení.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LoginExperienceV2

Pouze aktivní při interaktivním ověřování umožňuje uživateli zvolit předplatné a tenanta použitého v následných příkazech. Možné hodnoty ad "Zapnuto" (Výchozí) a "Vypnuto". Zapnuto vyžaduje vstup uživatele. Možnost Vypnuto použije první tenanta a předplatné vrácené Azure, může se bez předchozího upozornění změnit a vést k provádění příkazů v nežádoucím kontextu (nedoporučuje se).

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

Vrátí hodnotu true, pokud se rutina spustí správně.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Scope

Určuje rozsah změn konfigurace, například zda se změny vztahují pouze na aktuální proces, nebo na všechny relace spuštěné tímto uživatelem. Ve výchozím nastavení je to CurrentUser.

Typ:ConfigScope
Přípustné hodnoty:CurrentUser, Process, Default, Environment
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

Boolean