通过

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

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

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

  4. 查看升级计划： 在执行升级之前，请务必查看计划，了解可能阻止自动升级的任何潜在问题，例如使用 Splatting 的命令，并在必要时手动更正它们。

  5. 执行升级：查看并解决任何问题后，将使用 cmdlet 执行 Invoke-AzUpgradeModulePlan 实际升级。 此 cmdlet 可以修改现有文件，或者更安全地保存对新文件的更改，并将其 _az_upgraded 追加到其名称，以保留原始脚本。

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

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