Set-ForeignConnector
此 cmdlet 仅适用于本地 Exchange。
使用 Set-ForeignConnector cmdlet 修改邮箱服务器的传输服务中的现有外部连接器。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Set-ForeignConnector
[-Identity] <ForeignConnectorIdParameter>
[-AddressSpaces <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-DropDirectory <String>]
[-DropDirectoryQuota <Unlimited>]
[-Enabled <Boolean>]
[-Force]
[-IsScopedConnector <Boolean>]
[-MaxMessageSize <Unlimited>]
[-Name <String>]
[-RelayDsnRequired <Boolean>]
[-SourceTransportServers <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] 说明
外部连接器使用邮箱服务器的传输服务中的投递目录将邮件发送到不使用 SMTP 作为其主要传输机制的本地邮件服务器。 这些邮件服务器称为外部网关服务器。 第三方传真网关服务器就是外部网关服务器的示例。 分配到外部连接器的地址空间可以是 SMTP 或非 SMTP。
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-ForeignConnector "Fax Connector" -MaxMessageSize 10MB此示例对名为“传真连接器”的现有外部连接器配置 10 MB 的邮件大小限制。
参数
-AddressSpaces
AddressSpaces 参数指定外部连接器向其发送邮件的域名。 用于输入每个地址空间的完整语法为： 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"。
若要在不影响任何现有条目的情况下添加或删除一个或多个地址空间值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Comment
Comment 参数指定可选注释。 如果您指定包含空格的值，为该值加上双引号(")，例如："这是管理员备注"。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
边缘传输服务器上不支持 DomainController 参数。 边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DropDirectory
DropDirectory 参数指定此 Foreign 连接器使用的 Drop 目录的名称。 发送到此外部连接器定义的地址空间的所有出站消息都放置在指定的 Drop 目录中。 每个外部连接器的 Drop 目录的位置由以下两项控制：
- Set-TransportService cmdlet 中的 RootDropDirectoryPath 参数：此选项用于邮箱服务器上存在的所有外部连接器。 RootDropDirectoryPath 参数的值可以是本地路径或通用命名约定 (UNC) 远程服务器的路径。
- Set-ForeignConnector cmdlet 中的 DropDirectory 参数：此值是为服务器上存在的每个外部连接器设置的。
默认情况下，RootDropDirectoryPath 参数为空。 这表示 RootDropDirectoryPath 的值是 Exchange 2010 安装文件夹。 默认的 Exchange 2010 安装文件夹为 C：\Program Files\Microsoft\Exchange Server\。 默认情况下，DropDirectory 参数的值是 Foreign 连接器的名称。
如果 DropDirectory 参数的值不包含绝对路径信息，则 Drop Directory 的位置由 DropDirectory 参数和 RootDropDirectoryPath 参数的组合定义。 如果 DropDirectory 参数的值包含绝对路径信息，则必须未指定 RootDropDirectoryPath 的值。 Drop 目录的位置仅由 DropDirectory 参数的值定义。
不会为你创建 Drop 目录。 因此，必须手动创建每个 Drop 目录文件夹。
Drop 目录必须向其分配以下权限：
- 网络服务：完全控制
- 系统：完全控制
- 管理员：完全控制
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DropDirectoryQuota
DropDirectoryQuota 参数指定 Drop 目录中所有消息文件的最大大小。 达到指定值后，在传递和删除现有邮件之前，不能将新的邮件文件复制到 Drop 目录中。
有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。
- B（字节）
- KB（千字节）
- MB（兆字节）
- GB（千兆字节）
- TB (TB)
TB（兆兆字节）
此参数的有效输入范围是从 1 到 2147483647 字节。 如果输入的值无限制，则不会对 Drop 目录施加消息大小限制。 默认值为无限制。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
Enabled 参数指定是否启用 Foreign 连接器。 有效值为 $true 或 $false。 默认值为 $true。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
强制开关隐藏警告或确认消息。 不必为此开关指定值。
您可以在以编程方式运行任务时使用此开关，因为此时并不适合提示用户提供管理输入。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity 参数指定要修改的 Foreign 连接器。 Identity 参数可为 Foreign 连接器对象采用以下任何值：
- GUID
- 连接器或名称
- ServerName\ConnectorName
| Type: | ForeignConnectorIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IsScopedConnector
IsScopedConnector 参数指定连接到其他邮箱服务器的连接器的可用性。 当此参数的值$false时，Exchange 组织中的所有邮箱服务器都可以使用该连接器。 当此参数的值$true时，连接器只能由同一 Active Directory 站点中的邮箱服务器使用。 默认值为 $false。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MaxMessageSize
MaxMessageSize 参数指定可通过此外部连接器传递的消息的最大大小。
有效值是一个数字，最大可为 1.999999999 TB（即 2199023254528 B）或值 unlimited。默认值为 6 GB（即 6442450944 B）。
- B（字节）
- KB（千字节）
- MB（兆字节）
- GB（千兆字节）
- TB (TB)
TB（兆兆字节）
如果输入的值无限制，则不会对此外部连接器施加任何邮件大小限制。 默认值为无限制。 此参数的有效输入范围为 0 到 2147483647 KB。 如果将 MaxMessageSize 参数的值设置为 0，则可以有效地禁用 Foreign 连接器。 但是，如果在 Enabled 属性的值$true时将 MaxMessageSize 参数的值设置为 0，则会生成事件日志错误。 禁用 Foreign 连接器的首选方法是使用 Enabled 参数。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Name
Name 参数指定外部连接器的描述性名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RelayDsnRequired
RelayDsnRequired 参数指定在将消息写入 Drop 目录时，外部连接器是否需要中继传递状态通知 (DSN) 。 此参数的有效输入值$true或$false。 默认值为 $false。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SourceTransportServers
SourceTransportServers 参数指定可以使用此外部连接器的邮箱服务器的名称。 让单个外部连接器驻留在运行传输服务的多个邮箱服务器上提供容错和高可用性（如果其中一个服务器发生故障）。 此参数的默认值是首次安装此外部连接器的邮箱服务器的名称。
若要输入多个值并覆盖任何现有条目，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value1","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。