Get-AzConfig
取得 Azure PowerShell 的組態。
Syntax
Get-AzConfig
[-AppliesTo <String>]
[-Scope <ConfigScope>]
[-DefaultProfile <IAzureContextContainer>]
[-CheckForUpgrade]
[-DefaultSubscriptionForLogin]
[-DisableInstanceDiscovery]
[-DisplayBreakingChangeWarning]
[-DisplayRegionIdentified]
[-DisplaySecretsWarning]
[-DisplaySurveyMessage]
[-EnableDataCollection]
[-EnableErrorRecordsPersistence]
[-EnableLoginByWam]
[-LoginExperienceV2]
[<CommonParameters>]
Description
取得 Azure PowerShell 的組態。 根據預設,它會列出所有設定。 您可以使用各種參數來篩選結果。
注意
設定具有優先順序。 一般而言,進程範圍的優先順序高於 CurrentUser 範圍;套用至特定 Cmdlet 的組態優先順序高於模組,再次高於 Az。
為了減少混淆,結果 Get-AzConfig
會顯示正在生效的設定。 它是所有組態的組合,但並非字面上所有的設定。 不過,您可以套用不同的篩選參數來檢視它們,例如 -Scope
。
範例
範例 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, …
取得所有設定。
範例 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…
取得 「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 |
-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 |
-LoginExperienceV2
只有在以互動方式進行驗證時,使用者才能選擇後續命令中使用的訂用帳戶和租使用者。 可能的值廣告 『On』 (預設值) 和 『Off』。 'On' 需要使用者的輸入。 'Off' 會使用 Azure 傳回的第一個租使用者和訂用帳戶,可以變更而不通知,並導致命令在不必要的內容中執行(不建議)。
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 |
輸入
None
輸出
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應