了解 Cmdlet 扩展代理

**适用于：**Exchange Server 2010

**上一次修改主题：**2009-07-09

Cmdlet 扩展代理是在 cmdlet 运行时，由 Exchange 2010 cmdlet 调用的 Microsoft Exchange Server 2010 中的组件。顾名思义，cmdlet 扩展代理可扩展 cmdlet 的功能，通过帮助处理数据或执行其他基于 cmdlet 要求的操作来调用这些功能。Cmdlet 扩展代理在任何服务器角色（除了边缘传输服务器角色之外）上均可用。

这些代理可以修改、替换或扩展 Exchange 命令行管理程序 cmdlet 的功能。代理可以执行以下操作：为所需参数提供值（该值未在命令上提供）、覆盖由用户提供的值、在 cmdlet 运行时执行其他 cmdlet 工作流以外的操作等。

例如，New-Mailbox cmdlet 会接受 Database 参数，该参数指定要在其中创建新邮箱的邮箱数据库。在 Exchange Server 2007 中，运行 New-Mailbox cmdlet 时，如果不指定 Database 参数，则该命令将失败。通过 Exchange 2010，New-Mailbox cmdlet 可在 cmdlet 运行时调用 Mailbox Resources Management 代理。如果未指定 Database 参数，则 Mailbox Resources Management 代理将自动确定适合在其上创建新邮箱的邮箱数据库，并将该值插入到 Database 参数中。

只能通过 Exchange 2010 cmdlet 来调用 Cmdlet 扩展代理。Exchange 2007 cmdlet 以及由其他 Microsoft 和第三方产品提供的 cmdlet 无法调用 cmdlet 扩展代理。脚本也无法直接调用 cmdlet 扩展代理。但是，如果脚本包含 Exchange 2010 cmdlet，则这些 cmdlet 可继续调用 cmdlet 扩展代理。

若要了解与 cmdlet 扩展代理相关的管理任务，请参阅管理 Cmdlet 扩展代理。

代理优先级

cmdlet 运行时，代理的优先级会确定在其中调用代理的顺序。首先调用有较高优先级的代理（更接近 0）。当两个或多个代理尝试设置相同属性的值时，代理的优先级变得非常重要。优先级最高的代理将成功设置某个属性值，而所有尝试设置相同属性的较低优先级代理将被忽略。例如，如果优先级为 3 的代理修改了某个对象上的 Name 属性，而优先级为 6 的另一个代理也修改相同对象，则由优先级为 6 的代理进行的修改将被忽略。

如果要使用 Scripting agent 设置可能由其他较高优先级代理设置的属性的值，则可在以下选项中进行选择：

• 禁用当前设置该属性的代理。
• 设置 Scripting agent，使其优先级高于要替换的现有代理。
• 保持代理的优先级相同，并确保在 Scripting agent 下运行的脚本符合由其他代理提供的值。

警告

更改内置代理的优先级或替换内置代理的功能是一项高级操作。请确保您完全了解要进行的更改。

有关更改代理优先级的详细信息，请参阅更改 Cmdlet 扩展代理的优先级。

内置代理

Exchange 2010 包括多个可在 cmdlet 运行时调用的代理。下表列出了这些代理、其顺序，以及默认情况下是否启用代理。无法在运行 Exchange 2010 的服务器上添加或删除代理。但是可以使用脚本代理运行 Microsoft Windows PowerShell 脚本，以扩展使用它的 cmdlet 的功能。有关脚本代理的详细信息，请参阅脚本代理。

如果要将某个特定代理的功能替换为您在自定义脚本（使用脚本代理调用）中提供的功能，则可以启用或禁用代理，或者更改代理的优先级。

代理的配置存储在组织级别上。启用或禁用代理，或设置其优先级时，您将在组织中的每台服务器上设置该代理配置。但是，将脚本添加到 Scripting agent 时除外。您必须分别对每个服务器上的脚本进行更新。有关配置脚本以便与 Scripting agent 配合使用的详细信息，请参阅脚本代理。

警告

如果不完全了解每个代理所做的内容以及其与 Exchange cmdlet 交互的方式，则更改代理的优先级，或者启用（或禁用）代理，将会导致意外的结果。在更改任何代理的配置之前，请确保完全了解所要的更改和结果，并验证自定义脚本是否将按预期工作。

Exchange 2010 cmdlet 扩展代理

代理名	优先级	默认情况下启用	描述
Rus 代理	True	0
邮箱资源管理代理	True	1
设置策略代理	True	2
查询基本 DN 代理	True	3
OAB 资源管理代理	True	4
脚本代理	False	5
管理审核日志代理	True	255