Install-TransportAgent

 

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

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

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

语法

Install-TransportAgent -Name <String> -AssemblyPath <String> -TransportAgentFactory <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

详细说明

Install-TransportAgent cmdlet 用于注册要在边缘传输服务器或集线器传输服务器上使用的传输代理。

警告：
传输代理对其遇到的电子邮件具有完全控制访问权限。Exchange 对传输代理的行为没有任何限制。不稳定或包含安全缺陷的传输代理可能会影响 Exchange 的稳定性和安全性。因此，必须只安装您完全信任且在测试环境中经过完全测试的传输代理。

若要运行 Install-TransportAgent cmdlet，必须为您使用的帐户委派以下角色：

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

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

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

参数

参数	必需	类型	说明
AssemblyPath	必需	System.String	此参数指定传输代理 Microsoft .NET 程序集的位置。不能使用通用命名约定 (UNC) 文件路径。
Name	必需	System.String	此参数指定要安装的传输代理的显示名。名称长度不能超过 64 个字符。
TransportAgentFactory	必需	System.String	此参数指定传输代理工厂的 Microsoft .NET 类类型。要安装的传输代理的开发人员提供传输代理工厂及相关信息。有关详细信息，请参阅传输代理开发人员提供的文档。
Confirm	可选	System.Management.Automation.SwitchParameter	Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。
DomainController	可选	Microsoft.Exchange.Data.Fqdn	若要指定用于将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。运行边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色将只读取和写入本地 ADAM 实例。
WhatIf	可选	System.Management.Automation.SwitchParameter	WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误	说明

异常

异常	说明

示例

以下示例显示如何在边缘传输服务器或集线器传输服务器上安装虚构的防病毒应用程序。

Install-TransportAgent -Name "Antivirus for Exchange" -TransportAgentFactory "vendor.exchange.avTransportAgentfactory" -AssemblyPath "c:\Program Files\Vendor\TransportAgent\AvTransportAgentFactory.dll"