將 Azure PowerShell 從 AzureRM 移轉至 Az

  • 發行項

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。

判斷您是否使用 AzureRM PowerShell 模組

使用下列命令來判斷您是否已安裝 AzureRM PowerShell 模組：

Get-Module -Name AzureRM -ListAvailable

您也可以針對模式 *-AzureRM* 執行腳本的全文搜索，以判斷其中是否有任何腳本正在使用 AzureRM PowerShell 模組。

升級至 Az PowerShell 模組

針對 AzureRM Cmdlet 撰寫的腳本不會自動與 Az 搭配運作。 為了簡化轉換， 已開發 AzureRM 至 Az 移轉工具組 。 無法移轉至新的命令集，但本文將協助您開始轉換至 Az PowerShell 模組。 若要深入瞭解建立 Az PowerShell 模組的原因，請參閱 Az PowerShell 模組簡介。

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

若要查看 AzureRM 與 Az 之間重大變更的完整清單，請參閱 從 AzureRM 到 Az 的完整變更。

確定現有的腳本可與最新的 AzureRM 版本搭配使用

在採取任何移轉步驟之前，請先判斷系統上已安裝哪些版本的 AzureRM。 這麼做可讓您確定腳本已在最新版本上執行，並讓您知道必須卸載哪些版本的 AzureRM。

若要判斷您已安裝的 AzureRM 版本，請執行下列範例：

Get-Module -Name AzureRM -ListAvailable -All

AzureRM 的最新可用版本是 6.13.2。 如果您尚未安裝此版本，現有的腳本可能需要額外的修改，才能使用 Az 模組，而超出本文所述範圍和 重大變更清單中的內容。

如果您的腳本不適用於 AzureRM 6.13.2，請根據 AzureRM 5.x 更新為 6.x 移轉指南。 如果您使用舊版的 AzureRM 模組，則每個主要版本都有可用的移轉指南。

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

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

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

選項 2：搭配 Enable-AzureRmAlias 使用相容性模式

Az 模組具有相容性模式，可協助您在更新至新語法時使用現有的腳本。 Enable-AzureRmAlias Cmdlet 可透過別名啟用相容性模式。 此模式可讓您以最少的修改方式使用現有的腳本，同時致力於完整移轉至 Az。 根據預設， Enable-AzureRmAlias 只會啟用目前 PowerShell 工作階段的相容性別名。 使用其 Scope 參數，在PowerShell工作之間保存相容性別名。 如需詳細資訊，請參閱 Enable-AzureRmAlias 參考檔。

重要

即使 Cmdlet 名稱為別名，仍可能會有新的 （或重新命名） 參數，或變更 Az Cmdlet 的傳回值。 請勿預期讓別名為您處理移轉。 請參閱完整的重大變更清單，以找出您的腳本可能需要更新的位置。

Enable-AzureRmAlias使用 AzureRM PowerShell 模組的淘汰功能，將不會取代 對 的支援。

下一步