New-ForeignConnector

此 cmdlet 仅适用于本地 Exchange。

使用 New-ForeignConnector cmdlet 可在邮箱服务器的传输服务中新建一个外部连接器。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Default (默认值)

New-ForeignConnector
    [-Name] <String>
    -AddressSpaces <MultiValuedProperty>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IsScopedConnector <Boolean>]
    [-SourceTransportServers <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

说明

外部连接器使用邮箱服务器的传输服务中的投递目录将邮件发送到不使用 SMTP 作为其主要传输机制的本地邮件服务器。 这些邮件服务器称为外部网关服务器。 非Microsoft传真网关服务器是外部网关服务器的示例。 分配到外部连接器的地址空间可以是 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

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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"

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DomainController

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。

边缘传输服务器上不支持 DomainController 参数。 边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IsScopedConnector

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

IsScopedConnector 参数指定连接到其他邮箱服务器的连接器的可用性。 当此参数的值$false时,Exchange 组织中的所有邮箱服务器都可以使用该连接器。 当此参数的值$true时,连接器只能由同一 Active Directory 站点中的邮箱服务器使用。 默认值为 $false。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Name 参数指定外部连接器的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SourceTransportServers

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

SourceTransportServers 参数指定可以使用此外部连接器的邮箱服务器的名称。 如果一个外部连接器驻留在多个服务器上,在某个邮箱服务器出现故障时,可以实现容错和高可用性。 此参数的默认值是第一个安装此外部连接器的服务器的名称。

Update 如果值中有空格或需要使用双引号,请使用以下语法:"Value1","Value2",..."ValueN"

参数属性

类型:MultiValuedProperty
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

Input types

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。