Set-ForeignConnector

  • 项目

 

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

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

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

语法

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

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

详细说明

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

此参数指定外部连接器将邮件发送到的域名。输入每个地址空间的完整语法如下：<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • AddressSpaceType   地址空间类型可能是 SMTP、X400 或其他任何文本字符串。如果省略了地址空间类型，则假定它为一个 SMTP 地址空间类型。

  • AddressSpace   对于 SMTP 地址空间类型，输入的地址空间必须符合 RFC 1035。例如，输入 *、*.com 和 *.contoso.com 是允许的，而输入 *contoso.com 则是不允许的。对于 X.400 地址空间类型，输入的地址空间必须符合 RFC 1685，例如 o=MySite;p=MyOrg;a=adatum;c=us。对于其他所有地址类型的值，您可为地址空间输入任何文本。

  • AddressSpaceCost   开销的有效输入范围是 1 到 100。开销越低表示路由越好。如果您省略了址空间开销，则假定开销为 1。如果您输入了一个包含分号 ( ; ) 的非 SMTP 地址空间，则必需指定地址空间开销。

如果您指定了地址空间类型或地址空间开销，则必须为该地址空间加上双引号 ( " )。例如，下面的各地址空间条目是等效的：

  • "SMTP:contoso.com;1"

  • "contoso.com;1"

  • "SMTP:contoso.com"

  • contoso.com

通过像如下所示用逗号分隔地址空间，可以指定多个地址空间，示例：contoso.com,fabrikam.com。如果您指定了地址空间类型或地址空间开销，则必须像如下所示为该地址空间加上双引号 ( " )，示例："contoso.com;2","fabrikam.com;3"。

Comment

可选

System.String

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

Confirm

可选

System.Management.Automation.SwitchParameter

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

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 参数的值定义。

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

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

  • 网络服务：完全控制

  • 系统：完全控制

  • Administrators：完全控制

DropDirectoryQuota

可选

Microsoft.Exchange.Data.Unlimited

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

  • B（字节）

  • KB（千字节）

  • MB（兆字节）

  • GB（千兆字节）

  • TB（兆兆字节）

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

Enabled

可选

System.Boolean

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

Force

可选

System.Management.Automation.SwitchParameter

此参数禁止在特定配置更改过程中显示警告消息或确认消息。

Instance

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

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

IsScopedConnector

可选

System.Boolean

此参数控制某个连接器是否可用于其他集线器传输服务器。当此参数的值为 $False 时，该连接器可用于 Exchange 组织中的所有集线器传输服务器。当此参数的值为 $True 时，该连接器仅可用于同一个 Active Directory 站点中的集线器传输服务器。默认值为 $False。

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

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

WhatIf

可选

System.Management.Automation.SwitchParameter

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

示例

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

第一个示例显示用于修改名为“Contoso Foreign Connector”的现有外部连接器的 Set-ForeignConnector 命令。该命令将 MaxMessageSize 参数设置为 10 MB。

第二个示例显示用于修改由名为“Contoso Foreign Connector”的现有外部连接器提供服务的地址空间的 Set-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"