共用方式為


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

輸出

PSConfig