你当前正在访问 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 命令行程序编写的脚本不会自动与 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 的支持。