Set-TransportAgent

 

适用于: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题: 2007-07-27

使用 Set-TransportAgent cmdlet 可以修改 Microsoft Exchange Server 2007 组织中已安装边缘传输服务器角色或集线器传输服务器角色的计算机上的传输代理。

语法

Set-TransportAgent -Identity <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <Nullable>] [-WhatIf [<SwitchParameter>]]

详细说明

Set-TransportAgent cmdlet 用于修改边缘传输服务器或集线器传输服务器上的传输代理。

若要运行 Set-TransportAgent cmdlet,必须为您使用的帐户委派以下角色:

  • Exchange Server 管理员角色和目标服务器的本地 Administrators 组

若要在安装了边缘传输服务器角色的计算机上运行 Set-TransportAgent cmdlet,必须使用作为该计算机上本地 Administrators 组成员的帐户进行登录。

有关权限、角色委派以及管理 Exchange 2007 所需权限的详细信息,请参阅权限注意事项

参数

参数 必需 类型 说明

Identity

必需

System.String

使用此参数可以指定要修改的传输代理的显示名称。名称长度不能超过 64 个字符。

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理,并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定用于将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名 (FQDN),请在命令中包含 DomainController 参数。运行边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色将只读取和写入本地 ADAM 实例。

Priority

可选

System.Nullable

使用此参数可以指定传输代理的优先级。传输代理的优先级用于控制传输代理处理电子邮件的顺序。优先级必须是一个介于 0 与传输代理最多个数之间的值。默认行为是在优先级列表的末尾追加新的传输代理。优先级最接近 0 的传输代理将首先处理电子邮件。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数,您可以查看要发生的更改,而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

 

异常

异常 说明

 

示例

以下示例显示如何修改虚构的防病毒代理的优先级。

Set-TransportAgent -Identity "Antivirus for Exchange" -Priority 3