Clear-AzConfig

參考

模組:: Az.Accounts

清除使用者所設定的組態值。

Syntax

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

清除使用者所設定的組態值。默認會清除所有設定。您也可以指定要清除的組態索引鍵。

範例

範例 1

Clear-AzConfig -Force

清除所有設定。 -Force 會隱藏確認的提示。

範例 2

Clear-AzConfig -EnableDataCollection

清除「EnableDataCollection」設定。

參數

-AppliesTo

指定組態適用的 Azure PowerShell 部分。可能的值包括：

“Az”：組態適用於 Azure PowerShell 的所有模組和 Cmdlet。
模組名稱：組態適用於 Azure PowerShell 的特定模組。例如，“Az.儲存體”。
Cmdlet 名稱：組態會套用至 Azure PowerShell 的特定 Cmdlet。例如，“Get-AzKeyVault”。如果未指定，則取得或清除組態時，它會預設為上述所有設定;更新時，預設為 “Az”。

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

-CheckForUpgrade

啟用時，Azure PowerShell 會自動檢查更新，並在有更新可用時顯示提示訊息。預設值為 True。

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

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

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

-DefaultSubscriptionForLogin

訂用帳戶名稱或 GUID。在登入時設定 Azure PowerShell 的預設內容，而不指定訂用帳戶。

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

-DisableInstanceDiscovery

將它設定為 true 以停用實例探索和授權單位驗證。這項功能適用於無法連線到元數據端點的案例，例如在私人雲端或 Azure Stack 中。實例探索的程式需要從 https://login.microsoft.com/ 擷取授權單位元數據來驗證授權單位。將此值設定為 true，即會停用授權單位的驗證。因此，請務必確保已設定的授權單位主機有效且值得信任。

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

-DisplayBreakingChangeWarning

控制是否顯示或隱藏重大變更的警告訊息。啟用時，未來版本中執行具有重大變更的 Cmdlet 時，會顯示重大變更警告。

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

-DisplayRegionIdentified

啟用時，Azure PowerShell 會顯示可能會降低成本的區域建議。

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

-DisplaySecretsWarning

啟用時，Cmdlet 輸出包含秘密時會顯示警告訊息。深入了解：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

啟用時，系統會提示您不常參與 Azure PowerShell 的用戶體驗問卷。

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

-EnableDataCollection

啟用時，Azure PowerShell Cmdlet 會將遙測數據傳送至 Microsoft，以改善客戶體驗。如需詳細資訊，請參閱我們的隱私聲明： https://aka.ms/privacy

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

-EnableErrorRecordsPersistence

啟用時，錯誤記錄會寫入 ~/。Azure/ErrorRecords。

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

-EnableLoginByWam

[預覽]啟用時，Web 帳戶管理員（WAM）會是預設的互動式登入體驗。如果平臺不支援 WAM，它會回復為使用瀏覽器。請注意，這項功能處於預覽狀態。目前不支援 Microsoft 帳戶（MSA）。如果您有任何意見反應，請隨時連絡 Azure PowerShell 小組： https://aka.ms/azpsissue

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

-Force

清除所有設定時，請勿要求確認。

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

-LoginExperienceV2

只有在以互動方式進行驗證時，使用者才能選擇後續命令中使用的訂用帳戶和租使用者。可能的值廣告『On』（預設值）和『Off』。 'On' 需要使用者的輸入。 'Off' 會使用 Azure 傳回的第一個租使用者和訂用帳戶，可以變更而不通知，並導致命令在不必要的內容中執行（不建議）。

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

-PassThru

如果 Cmdlet 正確執行，則傳回 true。

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

-Scope

判斷組態變更的範圍，例如，變更僅適用於目前進程，或套用至此用戶啟動的所有會話。根據預設，它是 CurrentUser。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

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

輸入

None

輸出

Boolean

共用方式為