Az.Tools.Migration PowerShell 模組的概觀

  • 發行項

Az.Tools.Migration PowerShell 模組有助於從較舊的 AzureRM 模組轉換至較新的 Az 模組，這是建議用於 Azure 管理。

重要

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已被取代。

Microsoft 引進 了 Az.Tools.Migration 以回應客戶的意見反應，尤其是更新原本為 AzureRM 撰寫的腳本所需的工作。 可辨識許多客戶已投資為 Azure 環境建立複雜的腳本， 因此已建立 Az.Tools.Migration 來簡化和自動化移轉程式，進而降低腳本升級期間的手動工作負載和錯誤的可能性。

如何使用 Az.Tools.Migration 模組

使用 Az.Tools.Migration 的程序牽涉到幾個步驟：

  1. 更新至 AzureRM 6.13.1 版：在使用 Az.Tools.Migration 之前，用戶必須先確定其腳本已更新為 AzureRM 6.13.1 版，也就是移轉至 Az 模組之前的最後一個版本。

  2. 安裝 Az.Tools.Migration：您可以使用 命令，從 PowerShell 資源庫 Install-Module -Name Az.Tools.Migration 安裝模組。

  3. 產生升級計劃： Cmdlet New-AzUpgradeModulePlan 會產生升級計劃。 它不會變更現有的腳本，而是藉由建立詳細數據特定檔案和需要更新的位移點來提供升級路徑。 此 Cmdlet 會採用 FilePath 和 DirectoryPath 等參數，以特定腳本或資料夾為目標。

  4. 檢視升級計劃： 在執行升級之前，請務必檢閱計劃，瞭解任何可能防止自動升級的潛在問題，例如使用展開的命令，並視需要手動更正它們。

  5. 執行升級：檢閱並解決任何問題之後，會使用 Invoke-AzUpgradeModulePlan Cmdlet 執行實際的升級。 此 Cmdlet 可以修改現有的檔案，或更安全地將變更儲存至附加至其名稱的新檔案 _az_upgraded ，以保留原始腳本。

為了確保順利移轉，建議您先備份腳本，再執行升級，因為 Invoke-AzUpgradeModulePlan Cmdlet 在未搭配 -FileEditMode SaveChangesToNewFiles 選項使用時可能會具有破壞性。

建議使用者在 Azure-powershell-migration 的 GitHub 存放庫上提供移轉程式的意見反應或回報問題。