Share via


設定 Azure PowerShell 全域設定

Azure PowerShell 支援數個全域設定,例如停用重大變更警告訊息。 在 Az PowerShell 模組第 9 版之前,沒有集中式或細微的方式來設定 Azure PowerShell 的全域設定。

集中式設定

Az PowerShell 模組第 9 版和更新版本包含用於管理 Azure PowerShell 全域設定設定的 Cmdlet。 這些 *-AzConfig Cmdlet 是 Az.Accounts PowerShell 模組的一部分:

細微設定

您可以套用只能在特定範圍中生效的設定。 Scope 參數的有效值為

  • Current User. 套用設定時的預設值。
  • Process. 設定只會套用至目前的PowerShell會話。
  • Default. 預設值尚未變更的唯讀範圍。
  • Environment. 透過環境變數設定值的唯讀範圍。

除了範圍之外,您還可以將設定套用至所有 Az PowerShell 模組,或只套用單一模組。 使用 AppliesTo 參數,您可以指定套用設定的範圍。 值 Az 表示設定會套用至屬於 Azure PowerShell 的所有可用模組。

若要停用 Az.Compute 模組中 Cmdlet 的重大變更警告訊息,請使用 Update-AzConfig Cmdlet 搭配 DisplayBreakingChangeWarningAppliesTo 參數,如下列範例所示。

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

在此案例中,除了 Az.Compute 以外的所有 Az PowerShell 模組中 Cmdlet,重大變更警告訊息仍為作用中。

默認訂用帳戶

根據預設,當您向 Azure 進行驗證時,會擷取您可以存取的所有訂用帳戶。 除非您使用 指定訂用帳戶,否則會使用 Azure 傳回的第一個訂用 Connect-AzAccount帳戶。 此行為可能很危險,例如,如果傳回的第一個訂用帳戶是生產環境。

若要設定預設訂用帳戶,您可以使用 Update-AzConfig Cmdlet 搭配 DefaultSubscriptionForLogin 參數,如下列範例所示。

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

注意

不要與 預設內容的訂用帳戶混淆, DefaultSubscriptionForLogin 組態只有在向 Azure 進行驗證時才會生效。

升級通知

Azure PowerShell 版本升級的工具內通知是在 Az PowerShell 模組 10.3.0 版中發行的功能。 當有新版本的 Azure PowerShell 可用時,您的互動式 PowerShell 會話中會顯示升級通知。

若要判斷是否啟用升級通知,請使用 Get-AzConfig Cmdlet 搭配 CheckForUpgrade 參數,如下列範例所示。

Get-AzConfig -CheckForUpgrade

若要啟用 Azure PowerShell 的升級通知,請使用 Cmdlet 搭配 CheckForUpgrade 參數和$true其值,如下列範例所Update-AzConfig示。

Update-AzConfig -CheckForUpgrade $true

若要關閉升級通知,請使用 Update-AzConfig Cmdlet 搭配 CheckForUpgrade 參數及其 $false 值,如下列範例所示。

Update-AzConfig -CheckForUpgrade $false

Azure 區域識別

Azure 客戶可以選擇在許多不同的區域中部署資源。 在某些情況下,客戶可以藉由選取提供相同服務的鄰近區域來降低成本。 如果識別附近的區域,訊息會顯示要選取以供未來部署的區域。

停用區域建議訊息

在下列範例中 Update-AzConfig ,Cmdlet 是用來停用區域建議訊息:

Update-AzConfig -DisplayRegionIdentified $false

如需 Azure 區域的詳細資訊,請參閱 為您選擇正確的 Azure 區域。

複寫設定

若要將設定從某個環境複寫到另一個環境,您可以使用 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