將 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 名稱已設計成易於學習。 不要在 Cmdlet 名稱中使用 AzureRm 或 Azure，請使用 Az。 例如，舊的 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 模組，則每個主要版本都有可用的移轉指南。
選項 1（建議）：自動移轉 PowerShell 腳本
這個建議選項可將將 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 的參數可能仍會有新增或重新命名的情況，或其傳回值可能有所變更。 請勿期望啟用別名會自動處理您的遷移。 請參閱 完整的重大變更清單，以找出您的腳本可能需要更新的位置。
即使 AzureRM PowerShell 模組遭到淘汰，對 Enable-AzureRmAlias 的支援仍將繼續。
