New-ForeignConnector
此 cmdlet 仅适用于本地 Exchange。
使用 New-ForeignConnector cmdlet 可在邮箱服务器的传输服务中新建一个外部连接器。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
New-ForeignConnector
[-Name] <String>
-AddressSpaces <MultiValuedProperty>
[-Confirm]
[-DomainController <Fqdn>]
[-IsScopedConnector <Boolean>]
[-SourceTransportServers <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
说明
外部连接器使用邮箱服务器的传输服务中的投递目录将邮件发送到不使用 SMTP 作为其主要传输机制的本地邮件服务器。 这些邮件服务器称为外部网关服务器。 第三方传真网关服务器就是外部网关服务器的示例。 分配到外部连接器的地址空间可以是 SMTP 或非 SMTP。
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
New-ForeignConnector -Name "Contoso Foreign Connector" -AddressSpaces "X400:c=US;a=Fabrikam;P=Contoso;5" -SourceTransportServers Hub01,Hub02
本示例创建具有下列属性的外部连接器:
- 连接器名称:Contoso 外部连接器
- 地址空间:"c=US;a=Fabrikam;P=Contoso"
- 地址空间类型:X.400
- 地址空间开销:5
- 源传输服务器:Hub01 和 Hub02
参数
-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"
。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | True |
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 |
-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 |
-Name
Name 参数指定外部连接器的名称。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SourceTransportServers
SourceTransportServers 参数指定可以使用此外部连接器的邮箱服务器的名称。 如果一个外部连接器驻留在多个服务器上,在某个邮箱服务器出现故障时,可以实现容错和高可用性。 此参数的默认值是第一个安装此外部连接器的服务器的名称。
Update 如果值包含空格或需要引号,请使用以下语法: "Value1","Value2",..."ValueN"
。
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 不返回任何数据。