將 Azure PowerShell AzureRM 遷移到 Az

AzureRM PowerShell 模組的所有版本都已過期。 Az PowerShell 模組現在是建議與 Azure 互動的 PowerShell 模組。

為什麼要使用新模組?

最大且最重要的變更是 PowerShell以 .NET 標準文件庫為基礎,自推出以來一直是跨平台產品。

就像 PowerShell 語言一樣,我們致力於將 Azure 支援帶到所有平臺。 我們的承諾表示,Azure PowerShell模組必須更新,才能使用 .NET Standard,並且與 PowerShell Core 相容。 Az 模組已建立,而不是修改現有的 AzureRM 模組,並引入複雜的變更來新增此支援。

建立新模組也可以讓我們的工程師讓 Cmdlet 的設計、命名和模組保持一致。 現在所有模組的開頭都是 Az. 首碼,而 Cmdlet 則全部使用 Verb-AzNoun 命名慣例。 先前,Cmdlet 名稱會較長且不一致。

模組數量也會減少:某些使用相同服務的模組已合併。 相同服務的管理平面和資料平面 Cmdlet 現在包含在單一模組中。 對於手動管理相依性與導入的這些使用者來說,這項合併讓事情變得簡單得多。

通過進行這些重要變更,小組已承諾讓使用 Azure 與 PowerShell Cmdlet 時,能更輕鬆且更上一步地在更多平臺上使用。

升級至 Az PowerShell

為 AzureRM Cmdlet 所撰寫的腳本不會自動與 Az 一起使用。 為了簡化轉換, 已開發 AzureRM 到 Az 移轉 工具套件。 移轉至新的命令集一點都很方便,但本文可協助您開始轉換至 Az PowerShell 模組。 若要深入瞭解 Az PowerShell 模組的建立原因,請參閱介紹新的 AzAzure PowerShell模組。

新的 Cmdlet 名稱已設計成易於學習。 使用 ,而不是使用 AzureRm Azure 或輸入 Cmdlet 名稱 Az 。 例如,舊的 Cmdlet New-AzureRMVm 已變成 New-AzVm 。 不過,移轉不只是熟悉新的 Cmdlet 名稱。 有重新命名的模組、參數和其他重要變更。

若要查看 AzureRM 和 Az 之間中斷變更的完整清單,請參閱 AzureRM 到 Az 的完整變更

確保現有的腳本能與最新的 AzureRM 版本一起使用

執行任何移移步驟之前,請檢查系統已安裝哪些版本的 AzureRM。 這麼做可讓您確定腳本已在最新發行上執行,並讓您知道必須卸載哪些版本的 AzureRM。

若要檢查您 (AzureRM) 的版本,請執行下列範例:

Get-Module -Name AzureRM -ListAvailable -All

AzureRM 的最新可用版本為 6.13.1。 如果您沒有安裝此版本,您的現有腳本可能需要進行其他修改,以在本文所述範圍及中斷變更清單中使用 Az模組。

如果您的腳本無法與 AzureRM 6.13.1 一起使用,請依照 AzureRM 5.x 至 6.x移移指南進行更新。 如果您使用較舊版本的 AzureRM 模組,則每個主要版本都有可用的移移指南。

這個建議的選項可將將 AzureRM 腳本遷移到 Az 所需的工作量降到最低。

將 AzureRM 安裝到 Az 移移工具套件

Install-Module -Name Az.Tools.Migration

自動轉換腳本

使用 AzureRM 到 Az 移移工具組,您可以產生一個計畫,決定在腳本上執行哪些變更,然後再進行任何修改,然後再安裝 Az PowerShell 模組。

自動將 PowerShell 腳本從 AzureRM 遷移到 Az PowerShell 模組快速入門會引導您完成從 AzureRM 自動更新 PowerShell 腳本到 Az PowerShell 模組的整個程式。

選項 2:使用相容模式Enable-AzureRmAlias

Az 模組具有相容性模式,可協助在更新至新語法時使用現有的腳本。 Enable-AzureRmAlias Cmdlet 透過別名啟用相容模式。 此模式可讓您以最小修改的方式使用現有的腳本,同時致力於將腳本完全移往 Az。 根據預設, Enable-AzureRmAlias 只會啟用目前 PowerShell 會話的相容性別名。 使用其 Scope 參數來保留 PowerShell 會話的相容性別名。 詳細資訊,請參閱參考 Enable-AzureRmAlias檔

重要

即使 Cmdlet 名稱為別名,Az Cmdlet 可能仍有新的 (或重新命名) 參數或變更的退貨值。 不要期待啟用別名來處理您的移移! 請參閱 完整的中斷變更清單 ,找出腳本可能需要更新的地方。

選項 3:以副檔名在 Visual Studio Code 中Azure PowerShell腳本

安裝 Azure PowerShell擴展Visual Studio Code

安裝VSCode Azure PowerShell副檔名

手動轉換腳本

  1. 在 VSCode 中載入 AzureRM 腳本
  2. 開啟命令調色盤並選取以 Ctrl+Shift+P 開始移移 Migrate Azure PowerShell script
  3. 選取來源版本 AzureRM
  4. 請遵循每個有加分的指令或參數的建議動作。

下一個步驟