你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Az.Tools.Migration PowerShell 模块概述

  • 项目

Az.Tools.Migration PowerShell 模块可以简化从旧的 AzureRM 模块过渡到新的 Az 模块（建议用于 Azure 管理）的过程。

重要

AzureRM PowerShell 模块自 2024 年 2 月 29 日起弃用。

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：可以使用 Install-Module -Name Az.Tools.Migration 命令从 PowerShell 库安装该模块。

  3. 生成升级计划：New-AzUpgradeModulePlan cmdlet 生成升级计划。 它不会更改现有脚本，而是通过创建一个用于详细说明需要更新的具体文件和偏移点的计划来提供升级路径。 此 cmdlet 采用 FilePath 和 DirectoryPath 等参数来定位特定的脚本或文件夹。

  4. 查看升级计划：在执行升级之前，请务必查看计划中是否存在可能阻止自动升级的任何潜在问题（例如使用 splatting 的命令），必要时手动更正这些问题。

  5. 执行升级：检查并解决所有问题后，使用 Invoke-AzUpgradeModulePlan cmdlet 执行实际升级。 此 cmdlet 可以修改现有文件，或者保存对新文件的更改（这样更安全），并在新文件名后追加 _az_upgraded 以保留原始脚本。

为了确保顺利迁移，建议在执行升级之前备份脚本，因为如果不结合 -FileEditMode SaveChangesToNewFiles 选项使用，Invoke-AzUpgradeModulePlan cmdlet 可能具有破坏性。

我们建议用户在 azure-powershell-migration 的 GitHub 存储库中提供反馈或报告迁移过程中出现的问题。