Update-AzConfig
更新 Azure PowerShell 的設定。
Syntax
Update-AzConfig
[-AppliesTo <String>]
[-Scope <ConfigScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-CheckForUpgrade <Boolean>]
[-DefaultSubscriptionForLogin <String>]
[-DisableErrorRecordsPersistence <Boolean>]
[-DisableInstanceDiscovery <Boolean>]
[-DisplayBreakingChangeWarning <Boolean>]
[-DisplayRegionIdentified <Boolean>]
[-DisplaySurveyMessage <Boolean>]
[-EnableDataCollection <Boolean>]
[-EnableLoginByWam <Boolean>]
[<CommonParameters>]
Description
更新 Azure PowerShell 的設定。 視要更新的組態而定,您可以指定要保存組態的範圍,以及其套用至哪個模組或 Cmdlet。
注意
不建議更新多個 PowerShell 程式中的設定。 在一個進程中執行,或確定更新位於進程範圍 (-Scope Process
) 以避免非預期的副作用。
範例
範例 1
Update-AzConfig -DefaultSubscriptionForLogin "Name of subscription"
Key Value Applies To Scope Help Message
--- ----- ---------- ----- ------------
DefaultSubscriptionForLogin Name of subscription Az CurrentUser Subscription name or GUID. Sets the default context for Azure PowerShell when lo…
將 「DefaultSubscriptionForLogin」 組態設定為 「訂用帳戶名稱」。 將 Connect-AzAccount
選取指定的訂用帳戶作為預設訂用帳戶時。
範例 2
Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo "Az.KeyVault"
Key Value Applies To Scope Help Message
--- ----- ---------- ----- ------------
DisplayBreakingChangeWarning False Az.KeyVault CurrentUser Controls if warning messages for breaking changes are displayed or suppressed. When enabled,…
將 「Az.KeyVault」 模組的 「DisplayBreakingChangeWarnings」 設定為 「$false」。 這可防止 Az.KeyVault 模組中即將進行重大變更的所有警告訊息提示。
範例 3
Update-AzConfig -EnableDataCollection $true
Key Value Applies To Scope Help Message
--- ----- ---------- ----- ------------
EnableDataCollection True Az CurrentUser When enabled, Azure PowerShell cmdlets send telemetry data to Microsoft to improve the customer experi…
將 「EnableDataCollection」 組態設定為 「$true」。。 這可傳送遙測數據。
設定此群組態相當於 Enable-AzDataCollection
和 Disable-AzDataCollection
。
範例 4
Update-AzConfig -DisplaySecretsWarning $true
Key Value Applies To Scope Help Message
--- ----- ---------- ----- ------------
DisplaySecretsWarning True Az CurrentUser When enabled, a warning message for secrets redaction will be displ…
將 「DisplaySecretsWarning」 設定為 「$true」。。 這可在 Cmdlet 執行期間啟用秘密偵測,並在輸出中找到任何秘密時顯示警告訊息。
參數
-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: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
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: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisableErrorRecordsPersistence
停用時,錯誤記錄將不會寫入 ~/。Azure/ErrorRecords。 此設定將會取代為 「EnableErrorRecordsPersistence」 作為 2023 年 11 月左右 Az 下一個主要版本的選擇加入。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisableInstanceDiscovery
將它設定為 true 以停用實例探索和授權單位驗證。 這項功能適用於無法連線到元數據端點的案例,例如在私人雲端或 Azure Stack 中。 實例探索的程式需要從 https://login.microsoft.com/ 擷取授權單位元數據來驗證授權單位。 將此值設定為 true,即會停用授權單位的驗證。 因此,請務必確保已設定的授權單位主機有效且值得信任。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayBreakingChangeWarning
控制是否顯示或隱藏重大變更的警告訊息。 啟用時,未來版本中執行具有重大變更的 Cmdlet 時,會顯示重大變更警告。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayRegionIdentified
啟用時,Azure PowerShell 會顯示可能會降低成本的區域建議。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplaySecretsWarning
啟用時,Cmdlet 輸出包含秘密時會顯示警告訊息。 深入了解:https://go.microsoft.com/fwlink/?linkid=2258844
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplaySurveyMessage
啟用時,系統會提示您不常參與 Azure PowerShell 的用戶體驗問卷。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EnableDataCollection
啟用時,Azure PowerShell Cmdlet 會將遙測數據傳送至 Microsoft,以改善客戶體驗。 如需詳細資訊,請參閱我們的隱私聲明: https://aka.ms/privacy
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EnableLoginByWam
[預覽]啟用時,Web 帳戶管理員 (WAM) 會是預設的互動式登入體驗。 如果平臺不支援 WAM,它會回復為使用瀏覽器。 請注意,這項功能處於預覽狀態。 目前不支援 Microsoft 帳戶 (MSA)。 如果您有任何意見反應,請隨時連絡 Azure PowerShell 小組: https://aka.ms/azpsissue
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
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 |
輸入
輸出
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應