共用方式為

設定 Azure PowerShell 全域設定

  • 發行項

Azure PowerShell 提供了各種全域設定，例如停用中斷性變更警告訊息的選項。 在 [Az] PowerShell 模組的版本 9 之前，沒有集中式或詳細的方法來設定這些全域設定。

集中式設定

[Az] PowerShell 模組版本 9 及更高版本包括用於管理 Azure PowerShell 全域設定組態的 Cmdlet。 這些 *-AzConfig Cmdlet 是 [Az.Accounts] PowerShell 模組的一部分：

  • [Get-AzConfig]
  • [Update-AzConfig]
  • [Export-AzConfig]
  • [Import-AzConfig]
  • [Clear-AzConfig]

細微設定

您可以套用在特定範圍內有效的設定。 [Scope] 參數的有效值為：

  • Current User：套用設定時的預設範圍。
  • Process：設定僅套用至目前 PowerShell 工作階段。
  • Default：預設值未變更的唯讀範圍。
  • Environment：透過環境變數設定值的唯讀範圍。

除了範圍之外，您還可以將設定套用至所有 [Az] PowerShell 模組或僅套用至單一模組。 使用 [AppliesTo] 參數，可以指定要套用設定的範圍。 值 Az 指示設定套用至 Azure PowerShell 的所有模組。

設定選項

您可以使用 *-AzConfig Cmdlet 設定許多組態選項。 本區段中顯示了許多組態選項。 執行以下命令以查看可以使用 *-AzConfig Cmdlet 設定的 Azure PowerShell 組態選項的完整清單。

Get-AzConfig | Format-List

升級通知

Azure PowerShell 版本升級的工具內通知是 [Az] PowerShell 模組 10.3.0 版本中發佈的一項功能。 當有新版本的 Azure PowerShell 可用時，您的互動式 PowerShell 工作階段中會顯示升級通知。

若要確定是否啟用了升級通知，請使用具有 [CheckForUpgrade] 參數的 Get-AzConfig Cmdlet，如下例所示。

Get-AzConfig -CheckForUpgrade

若要為 Azure PowerShell 啟用升級通知，請使用具有 [CheckForUpgrade] 參數和 $true 作為其值的 Update-AzConfig Cmdlet，如下例所示。

Update-AzConfig -CheckForUpgrade $true

若要關閉升級通知，請使用具有 [CheckForUpgrade] 參數和 $false 作為其值的 Update-AzConfig Cmdlet，如下例所示。

Update-AzConfig -CheckForUpgrade $false

預設訂用帳戶

根據預設，從 [Az] PowerShell 模組 12.0.0 版開始，如果您有權存取多個訂用帳戶，系統會提示您選取要使用哪個 Azure 訂用帳戶登入。

為了防止每次以互動方式登入時都提示您選取訂用帳戶，請使用具有 [DefaultSubscriptionForLogin] 參數的 Update-AzConfig Cmdlet 設定預設訂用帳戶，如下例所示。

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

注意

不要與 [預設内容的訂用帳戶] 混淆，[DefaultSubscriptionForLogin] 組態僅在向 Azure 進行驗證時生效。

執行個體探索

停用執行個體探索設定是為中繼資料端點不可存取的情况而設計的，例如在私人雲端或 Azure Stack 環境中。 執行個體探索涉及從 https://login.microsoft.com/ 中擷取授權單位中繼資料以驗證授權單位。 透過啟用此設定 (將其設定為 true)，您可以停用執行個體探索和授權單位驗證。 因此，確保設定的授權單位主機有效且值得信賴至關重要。

若要停用執行個體探索和授權單位驗證，請啟用此設定 (將其設定為 true)。

Update-AzConfig -DisableInstanceDiscovery $true

中斷性變更警告訊息

若要停用所有 [Az] 模組中 Cmdlet 的中斷性變更警告訊息，請使用具有 DisplayBreakingChangeWarning 參數的 Update-AzConfig Cmdlet，如下例所示：

Update-AzConfig -DisplayBreakingChangeWarning $false

若要停用 [Az.Compute] 模組中 Cmdlet 特有的中斷性變更警告訊息，請將 Update-AzConfig Cmdlet 與 [DisplayBreakingChangeWarning] 和 [AppliesTo] 參數一起使用，如下例所示：

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute

在此案例中，對於除 [Az.Compute] 之外的所有 [Az] PowerShell 模組中的 Cmdlet，中斷性變更警告訊息仍然處於作用中狀態。

Azure 區域識別碼

Azure 客戶可以選擇在幾個不同的區域部署資源。 有時，客戶可以透過選取附近提供相同服務的區域來降低成本。 如果識別出附近的區域，則會顯示一條訊息，顯示區域以供將來部署時選擇。

若要停用區域建議訊息，請使用具有 [DisplayRegionIdentified]Update-AzConfig 參數的 Cmdlet，如下例所示。

Update-AzConfig -DisplayRegionIdentified $false

如需 Azure 區域的更多資訊，請參閱 [為您選擇合適的 Azure 區域]。

顯示祕密顯示

Azure PowerShell 從版本 12.0.0 開始，當於命令輸出中識別出潛在的祕密時，預設會顯示警告訊息以協助您保護敏感性資訊。

在如下列範例中，Update-AzConfig Cmdlet 會用來停用警告訊息。

Update-AzConfig -DisplaySecretsWarning $false

問卷

使用 Azure PowerShell 時，您可能會受邀參與問卷，告訴我們您的體驗。 我們非常感謝此資料所提供的深入解析，但也理解不是每個人都想要收到完成問卷的提示。

可以使用 Update-AzConfig Cmdlet 停用參與調查的提示，如下例所示。

Update-AzConfig -DisplaySurveyMessage $false

資料集合

根據預設，Azure PowerShell Cmdlet 會向 Microsoft 傳送遙測資料以改進客戶體驗。 如需更多資訊，請參閱我們的隱私權聲明：[aka.ms/privacy]。

Update-AzConfig -EnableDataCollection $false

錯誤記錄

根據預設，Azure PowerShell 錯誤記錄會寫入 $HOME/.Azure/ErrorRecords。

若要停用永續性錯誤記錄，請使用具有 [EnableErrorRecordsPersistence] 參數的 Update-AzConfig Cmdlet，如下例所示。

Update-AzConfig -EnableErrorRecordsPersistence $false

Web 帳戶管理員 (WAM)

從 [Az] PowerShell 模組 12.0.0 版開始，Windows 系統預設會使用 Web 帳戶管理員 (WAM)，而 Linux 和 macOS 系統預設會使用瀏覽器型登入。

若要在 Windows 10 和更新版本或在 Windows Server 2019 和更新版本上使用瀏覽器型登入，請使用 [Az] 12.0.0 和更新版本。您必須停用 WAM，才能搭配 Azure PowerShell 使用。 使用下列命令來停用 WAM 並返回瀏覽器型登入，這是 Az 12.0.0 之前的預設登入。

Update-AzConfig -EnableLoginByWam $false

新的登入體驗

從 [Az] PowerShell 模組 12.0.0 版開始，如果您有權存取多個訂用帳戶，系統會提示您選取要使用哪個 Azure 訂用帳戶登入。

當新的登入體驗停用且您有權存取多個訂用帳戶時，您就會登入至 Azure 傳回的第一個訂用帳戶，除非您使用 Connect-AzAccount 指定訂用帳戶。 命令預設會針對此訂用帳戶執行。 此行為可能很危險，例如，如果傳回的第一個訂用帳戶是實際執行環境。

若要停用新的登入體驗，請使用 Update-AzConfig Cmdlet，如下例所示。

Update-AzConfig -LoginExperienceV2 Off

複寫設定

若要將設定從一個環境複寫到另一個環境，請使用 Export-AzConfig Cmdlet 將設定匯出至 JSON 檔案。

Export-AzConfig -Path $HOME\AzConfig.json

若要匯入設定，請使用 Import-AzConfig Cmdlet 並參考以前匯出的 JSON 檔案。

Import-AzConfig -Path $HOME\AzConfig.json

清除組態

若要將一個或多個 Azure PowerShell 全域設定的組態設定重設為預設值，請使用 Clear-AzConfig Cmdlet。 在以下範例中，已清除 [DefaultSubscriptionForLogin] 設定。

Clear-AzConfig -DefaultSubscriptionForLogin