設定 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 搭配 DisplayBreakingChangeWarning 和 AppliesTo 參數,如下列範例所示。
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