通过

Set-ForeignConnector (RTM)

  • 项目

 

适用于： Exchange Server 2007

上一次修改主题： 2007-06-11

使用 Set-ForeignConnector cmdlet 可以修改运行 Microsoft Exchange Server 2007 并安装了集线器传输服务器角色的计算机上的现有外部连接器。“外部连接器”使用集线器传输服务器上的投递目录，将邮件发送到不使用简单邮件传输协议 (SMTP) 作为主要传输机制的本地邮件服务器。这些邮件服务器称为外部网关服务器。第三方传真网关服务器就是外部网关服务器的示例。分配到外部连接器的地址空间可以是 SMTP 或非 SMTP。

语法

Set-ForeignConnector -Identity <ForeignConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

Set-ForeignConnector [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Instance <ForeignConnector>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

详细说明

Set-ForeignConnector cmdlet 用于修改现有外部连接器。使用 Set-ForeignConnector cmdlet 时指定的属性更改将覆盖现有的属性值。

要运行 Set-ForeignConnector cmdlet，必须为您使用的帐户委派 Exchange Server 管理员角色和目标服务器的本地 Administrators 组。

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

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.ForeignConnectorIdParameter

此参数指定要修改的外部连接器。Identity 参数可以将下列任意值作为外部连接器对象：

  • GUID

  • 连接器名称

  • 服务器名称\连接器名称

AddressSpaces

可选

Microsoft.Exchange.Data.MultiValuedProperty

该参数指定外部连接器向其发送邮件的域名。可以指定多个地址空间，使用逗号分隔地址空间。输入每个地址空间的完整语法如下：

<ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • ConnectorScope   如果指定值 Local，则只有与要运行 New-SendConnector cmdlet 的源集线器传输服务器位于同一个 Active Directory 站点的其他集线器传输服务器可以使用该连接器。如果省略 ConnectorScope 限定符，则整个 Exchange 2007 组织中的所有集线器传输服务器都可以使用该连接器。

  • AddressSpaceType   对于 SMTP 地址空间，此值必须是 SMTP。对于非 SMTP 地址空间，此值可以是任意描述性文本字符串，例如揕otus Notes

  • AddressSpace   对于 SMTP 地址空间，可以使用 RFC 1035 中定义的域名系统 (DNS) 通配符 (*)，例如?对于非 SMTP 地址空间，可以使用通配符 (*) 以及其他字符，例如?contoso.com

  • AddressSpaceCost   开销的有效输入范围是 1 到 100。开销越低表示路由越好。此参数是可选的。如果在使用完整语法输入地址空间时省略 AddressSpaceCost 限定符，则假定开销为 1。

只有在下列情况下才必须使用 AddressSpaces 参数的完整语法：

  • 具有 Local 限定符的定域连接器

  • 非 SMTP 地址空间

  • 开销不是 1 的 SMTP 地址空间

如果为 AddressSpaces 参数的值输入域名或逗号分隔的域名列表，则假定每个域名的地址空间类型是 SMTP，开销是 1。

Comment

可选

System.String

此参数指定外部连接器的注释（可选）。必须为 Comment 参数加上双引号，如下例所示："this is an admin note"。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定将此配置更改写入 Active Directory 目录服务的域控制器的完全限定的域名 (FQDN)，需包括 DomainController 参数。

DropDirectory

可选

System.String

此参数指定此外部连接器使用的投递目录的名称。发送到此外部连接器定义的地址空间的所有出站邮件将放入指定的投递目录。每个外部连接器投递目录的位置都是由以下两项控制的：

  • Set-TransportServer cmdlet 中的 RootDropDirectoryPath 参数 此选项用于位于集线器传输服务器上的所有外部连接器。RootDropDirectoryPath 参数的值可以是本地路径，也可以是指向远程服务器的通用命名约定 (UNC) 路径。

  • Set-ForeignConnector cmdlet 中的 DropDirectory 参数 对于位于集线器传输服务器上的每个外部连接器，都将设置该值。

默认情况下，RootDropDirectoryPath 参数为空。这表明 RootDropDirectoryPath 的值是 Exchange 2007 安装文件夹。Exchange 2007 的默认安装文件夹为 C:\Program Files\Microsoft\Exchange Server\。默认情况下，DropDirectory 参数的值是外部连接器的名称。

如果 DropDirectory 参数的值不包含绝对路径信息，则投递目录的位置由 DropDirectory 参数和 RootDropDirectoryPath 参数一起定义。如果 DropDirectory 参数的值包含绝对路径信息，则 RootDropDirectoryPath 的值必须是未指定的。投递目录的位置仅由 DropDirectory 参数的值定义。

不会为您创建投递目录。因此，您必须手动创建每个投递目录文件夹。

必须为投递目录分配下列权限：

  • 网络服务：完全控制

  • 系统：完全控制

  • 管理员：完全控制

DropDirectoryQuota

可选

Microsoft.Exchange.Data.Unlimited

此参数指定投递目录中的所有邮件文件的最大大小。如果到了指定的值，则无法再向投递目录复制新的邮件文件，直到现有邮件已投递并删除。为 DropDirectoryQuota 参数输入值时，请使用下列单位之一对该值进行限定：

  • B（字节）

  • KB（千字节）

  • MB（兆字节）

  • GB（千兆字节）

  • TB（兆兆字节）

未限定的值被视为以字节为单位。此参数的有效输入范围为 1 到 2147483647 字节。如果输入值 unlimited，则对投递目录没有邮件大小限制。默认值为 unlimited。

Enabled

可选

System.Boolean

此参数启用或禁用外部连接器。有效的输入值为 $True 或 $False。默认值为 $True。

Instance

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。

MaxMessageSize

可选

Microsoft.Exchange.Data.Unlimited

此参数指定可以通过此外部连接器传递的邮件的最大大小。输入 MaxMessageSize 参数的值时，请使用下列单位之一对值进行限定：

  • B（字节）

  • KB（千字节）

  • MB（兆字节）

  • GB（千兆字节）

  • TB（兆兆字节）

未限定的值被视为以千字节为单位。如果输入值 unlimited，则对此外部连接器没有邮件大小限制。默认值为 unlimited。此参数的有效输入范围为 0 到 2147483647 KB。如果将 MaxMessageSize 参数的值设置为 0，实际上会禁用外部连接器。但是，如果在 Enabled 属性的值为 $True 时将 MaxMessageSize 参数的值设置为 0，则会产生事件日志错误。禁用外部连接器的首选方法是使用 Enabled 参数。

Name

可选

System.String

此参数指定外部连接器的描述性名称。

RelayDsnRequired

可选

System.Boolean

此参数指定在将邮件写入投递目录时，外部连接器是否需要中继发送状态通知 (DSN)。此参数的有效输入值是 $True 或 $False。默认值为 $False。

SourceTransportServers

可选

Microsoft.Exchange.Data.MultiValuedProperty

该参数指定使用此外部连接器的集线器传输服务器的名称。通过用逗号分隔服务器名称，可以指定多个集线器传输服务器。如果一个外部连接器驻留在多台集线器传输服务器上，在某台集线器传输服务器出现故障时，可以实现容错和高可用性。此参数的默认值是安装第一个安装此外部连接器的集线器传输服务器的名称。

示例

以下代码示例显示使用 Set-ForeignConnector cmdlet 的两个示例。

第一个示例显示用于修改名为揅ontoso Foreign ConnectorSet-ForeignConnector 命令。该命令将 MaxMessageSize 参数设置为 10 MB。

第二个示例显示用于修改由名为揅ontoso Foreign ConnectorSet-ForeignConnector 命令。地址空间的详细信息如下所示：

  • 第一个地址空间：

    • 地址空间类型：SMTP

    • 地址空间：*.contoso.com

    • 地址空间开销： 1

  • 第二个地址空间：

    • 地址空间类型：Lotus Notes

    • 地址空间：*@domino

    • 地址空间开销： 55

Set-ForeignConnector "Contoso Foreign Connector" -MaxMessageSize 10MB
Set-ForeignConnector "Contoso Foreign Connector" -AddressSpaces ".contoso.com","Lotus Notes:*@domino;55"