將 Azure PowerShell 從 AzureRM 移轉至 Azure

已完成

針對 AzureRM Cmdlet 建立的指令碼無法自動與 Az 模組搭配使用。 為了更輕鬆地轉換,已開發 AzureRM 至 Az 移轉工具組。 移轉至使用新的命令集並不方便,但請務必了解如何轉換至 Az PowerShell 模組。

新 Cmdlet 名稱的設計是為了更易於了解。 不需在 Cmdlet 名稱中使用 AzureRm 或 Azure,而是可以使用 Az Cmdlet。 例如,舊的 Cmdlet New-AzureRMVm 已變為 New-AzVm。 不過,移轉不僅只是要熟悉新的 Cmdlet 名稱。 此外還有重新命名的模組、參數和其他重要變更。

在採取任何移轉步驟之前,請先檢查系統上安裝了哪些版本的 AzureRM。 進行檢查可讓您確定指令碼是在最新的版本上執行,而且可讓您知道必須解除安裝哪些版本的 AzureRM。

若要檢查您安裝的 AzureRM 版本,請執行下列命令:

Get-Module -Name AzureRM -ListAvailable -All

注意

AzureRM 最新的可用版本為 6.13.1。 如果您沒有安裝此版本,現有的指令碼可能需要經過額外修改,才能使用 Az 模組。

從 AzureRM 移轉至 Az PowerShell 模組的建議選項是使用自動移轉。 為此,您必須執行下列命令,將 AzureRM 安裝至 Az 移轉工具組:

Install-Module -Name Az.Tools.Migration

透過 AzureRM 至 Az 移轉工具組,您可以產生一個計劃,以判斷在對指令碼進行任何修改之前,以及在安裝 Az PowerShell 模組之前,要對其執行哪些變更。

其他閱讀: 若要了解自動移轉的步驟,請參閱快速入門:將 PowerShell 指令碼從 AzureRM 自動移轉至 Az PowerShell 模組

您也可以使用 Microsoft Visual Studio Code 來移轉您現有的指令碼。 若要這樣做,您必須先安裝適用於 Visual Studio Code 的 Azure PowerShell 延伸模組。 然後您必須執行下列步驟:

  1. 在 Visual Studio Code 中載入您的 AzureRM 指令碼。
  2. 選取 Ctrl+Shift+P 以開啟命令選擇區。
  3. 選取 [移轉 Azure PowerShell] 指令碼。
  4. 選取 AzureRM 來源版本。
  5. 遵循建議的動作,執行每個加底線的命令或參數。