你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
警告
截至 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 名称设计为易于学习。 不使用 AzureRm cmdlet 名称或使用 Azure cmdlet 名称。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 的返回值。 不要期望启用别名来为你处理迁移。 请参阅 完整的中断性变更列表 ，查找脚本可能需要更新的位置。
Enable-AzureRmAlias在弃用 AzureRM PowerShell 模块时，不会弃用对支持。
