为什么Remote PowerShell正在被淘汰：理解Exchange V3模块的REST API连接迁移（office-docs-powershell）

为什么Remote PowerShell正在被淘汰：理解Exchange V3模块的REST API连接迁移（office-docs-powershell）

【免费下载链接】office-docs-powershellPowerShell Reference for Office Products - Short URL: aka.ms/office-powershell项目地址: https://gitcode.com/gh_mirrors/of/office-docs-powershell

本文基于官方文档库 office-docs-powershell（Office PowerShell Reference），帮助你彻底理解Remote PowerShell 连接方式正在被淘汰的原因，以及 Exchange Online PowerShell 如何通过Exchange Online PowerShell V3 模块（EXO V3 模块）迁移到REST API 连接。无论你是 Exchange 管理员还是运维脚本开发者，这条迁移路线都直接决定你的脚本还能不能跑、连接还安不安全。只需 5 分钟，带你完成从原理到实操的完整理解。

为什么 Remote PowerShell 正在被淘汰？

过去连接 Exchange Online PowerShell，标准姿势是通过 WinRM 建立一条远程 PowerShell 会话。这套老方案有三个绕不开的短板：

正因如此，微软先后发布了弃用公告：Exchange Online PowerShell 的 Remote PowerShell（RPS）协议于 2022 年 12 月宣布结束支持，Security & Compliance PowerShell 的 RPS 协议于 2023 年 5 月跟进公告。换句话说，Basic 认证（远程 PowerShell）连接已经成为历史，官方文档中相关章节也只保留作历史参考。

REST API 连接：安全、可靠、性能的三维升级

EXO V3 模块（3.0.0 及更高版本）带来了根本性改变：所有 cmdlet 都改由 REST API 直接驱动，不再建立远程 PowerShell 会话。官方对三种连接方式的对比如下：

对普通用户来说，最省心的一点是：REST API 的 cmdlet 名称和参数与原来完全一致，你旧脚本里的Get-Mailbox、Set-TransportRule等命令基本无需改动，换个模块版本就能继续用。

快速上手：3 步完成 Exchange V3 模块迁移

第 1 步：安装或更新模块

从 PowerShell Gallery 安装最新版本的 ExchangeOnlineManagement 模块即可（Windows 上 REST API 连接还需要 PowerShellGet 与 PackageManagement 模块）：

Install-Module -Name ExchangeOnlineManagement

第 2 步：使用现代身份验证连接

Connect-ExchangeOnline -UserPrincipalName admin@contoso.com

弹出登录窗口输入密码（启用 MFA 的账户完成多因素验证）即可完成连接，全程不需要再折腾 WinRM 配置。

第 3 步：确认连接类型

REST API 连接不会出现在传统的Get-PSSession里，应改用模块自带的Get-ConnectionInformationcmdlet 查看：

Get-ConnectionInformation

看到返回的连接信息对象，就说明你已经跑在 REST API 通道上了。完整的连接细节可参考官方文档 connect-to-exchange-online-powershell.md。

迁移后必知的 4 个坑

1. Invoke-Command 不再工作

很多老脚本习惯用Invoke-Command -Session $Session -ScriptBlock {...}指定远程会话执行命令，它在 REST API 连接中完全不可用。好消息是多数场景可以简化为直接运行 cmdlet，官方文档按场景给出了完整的替代写法，见 invoke-command-workarounds-rest-api.md。

2. 多连接管理换一套命令

同一窗口开多个连接时，以前靠Get-PSSession区分，现在改用Connect-ExchangeOnline的Prefix参数（如-Prefix C1、-Prefix C2），再配合Get-ConnectionInformation筛选，即可分别操作不同连接。

3. 批量操作注意 15 分钟超时

REST API 命令有 15 分钟超时限制。例如一次性向万人邮件组更新成员可能超时，建议拆成Update-DistributionGroupMember处理前 5000 个、再用循环逐个Add-DistributionGroupMember补齐剩余成员。

4. 善用 Get-EXO* 加速命令

模块内置 9 个Get-EXO*专属 cmdlet（如 Get-EXOMailbox、Get-EXORecipient），配合PropertySets属性集按需取数，在批量拉取成千上万条数据时速度优势明显，详见 cmdlet-property-sets.md 与 filters-v2.md。

免密码自动化：App-only 认证与托管标识

REST API 连接还解锁了一个老方案做不到的能力——无值守脚本安全运行。过去后台任务只能把账号密码存本地，风险极高；现在有两种推荐做法：

• App-only 认证（证书认证）：在 Microsoft Entra 中注册应用、上传证书并分配目录角色，脚本即可用证书令牌静默连接，全程无需人工登录。
• Azure 托管标识：脚本跑在 Azure 自动化账户或 VM 上时，直接Connect-ExchangeOnline -ManagedIdentity -Organization yourdomain.onmicrosoft.com，连证书都不用管理。

注册应用的操作界面如下（Exchange Online PowerShell REST API 迁移中的 App-only 认证配置）：

证书上传成功后，界面会显示绿色对勾确认（Exchange V3 模块证书认证配置完成）：

最后一步，把应用分配到对应的管理员角色，认证通过后 cmdlet 权限即按 RBAC 生效（Remote PowerShell 到 REST API 迁移后的角色分配）：

若在 Azure 自动化中使用托管标识，可先记下自动化账户的资源 ID，供后续配置授权参考（Azure 托管标识连接 Exchange PowerShell 的入口）：

完整的配置步骤分别见 app-only-auth-powershell-v2.md 和 connect-exo-powershell-managed-identity.md。

延伸阅读：去哪看完整官方文档

本文所有结论均出自本仓库的官方文档，核心文件路径如下：

• V3 模块总览与 REST API 连接详解：exchange-online-powershell-v2.md
• 版本更新日志（各版本新增能力一览）：whats-new-in-the-exo-module.md
• 连接操作指南：connect-to-exchange-online-powershell.md
• 连接与认证 cmdlet 参考：Connect-ExchangeOnline.md、Get-ConnectionInformation.md

如需查阅全部文档源码，可以克隆本仓库：

git clone https://gitcode.com/gh_mirrors/of/office-docs-powershell

概念性文档集中在 exchange/docs-conceptual/ 目录，各 cmdlet 的参数级参考文档在 exchange/exchange-ps/exchange/ 目录，迁移遇到问题时按图索骥即可。

【免费下载链接】office-docs-powershellPowerShell Reference for Office Products - Short URL: aka.ms/office-powershell项目地址: https://gitcode.com/gh_mirrors/of/office-docs-powershell