你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
将 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 参考文档。
重要
对于 Az cmdlet 来说，即使 cmdlet 名称使用了别名，也仍然可能存在新的（或重命名的）参数或更改的返回值。 不要期望通过别名来处理迁移事项。 请参阅中断性变更完整列表，了解在什么情况下可能需要对脚本进行更新。
在弃用 AzureRM PowerShell 模块时，不会弃用对 Enable-AzureRmAlias 的支持。
