Set-DeliveryAgentConnector

此 cmdlet 仅适用于本地 Exchange。

使用 Set-DeliveryAgentConnector cmdlet 可以在组织中配置特定的传递代理连接器。

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

语法

Default (默认值)

Set-DeliveryAgentConnector
    [-Identity] <DeliveryAgentConnectorIdParameter>
    [-AddressSpaces <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DeliveryProtocol <String>]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-Force]
    [-IsScopedConnector <Boolean>]
    [-MaxConcurrentConnections <Int32>]
    [-MaxMessageSize <Unlimited>]
    [-MaxMessagesPerConnection <Int32>]
    [-Name <String>]
    [-SourceTransportServers <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

说明

传递代理连接器用于路由发往外部系统的邮件,这些外部系统不使用 SMTP 协议。 当邮件路由到传递代理连接器时,相关的传递代理将执行内容转换和邮件传递。 由于传递代理连接器允许管理外部连接器队列,因此无需将邮件存储在文件系统上的投递目录和拾取目录中。 有关详细信息,请参阅传递代理和传递代理连接器

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Set-DeliveryAgentConnector "Contoso X.400 Connector" -MaxMessageSize 10MB -MaxMessagesPerConnection 100 -MaxConcurrentConnections 10

本示例配置对传递代理连接器 Contoso X.400 Connector 的限制。 将进行以下配置更改:

将允许通过此连接器的最大邮件大小设置为 10 MB。

将每个连接允许的最大邮件数设置为 100。

将最大并发连接数设置为 10。

示例 2

$ConnectorConfig = Get-DeliveryAgentConnector "Contoso X.400 Connector"

$ConnectorConfig.AddressSpaces += "X400:c=US;p=Fabrikam;a=Contoso;o=Sales;1"

$ConnectorConfig.SourceTransportServers += Hub04; Set-DeliveryAgentConnector "Contoso X.400 Connector" -AddressSpaces $ConnectorConfig.AddressSpaces -SourceTransportServers $ConnectorConfig.SourceTransportServers

本示例使用临时变量 $ConnectorConfig 将地址空间 c=US;p=Fabrikam;a=Contoso;o=Sales 添加到传递代理连接器 Contoso X.400 Connector,并将服务器 Hub04 添加到承载该连接器的服务器列表中。

参数

-AddressSpaces

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

AddressSpaces 参数指定传递代理连接器负责的域名。 用于输入地址空间的完整语法为: AddressSpaceType:AddressSpace;AddressSpaceCost。 将每个地址空间括在引号 (“) 。

参数属性

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

参数集

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

-Comment

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

Comment 参数指定可选注释。 如果您指定包含空格的值,为该值加上双引号("),例如:"这是管理员备注"。

参数属性

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

参数集

(All)
Position:Named
必需:False
来自管道的值: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

-DeliveryProtocol

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

DeliveryProtocol 参数指定用于确定哪些传递代理负责为连接器提供服务的通信协议。

参数属性

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

参数集

(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

-Enabled

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

Enabled 参数指定是否启用传递代理连接器。

默认值为 $true。

参数属性

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

参数集

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

-Force

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

强制开关隐藏警告或确认消息。 不必为此开关指定值。

您可以在以编程方式运行任务时使用此开关,因为此时并不适合提示用户提供管理输入。

参数属性

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

参数集

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

-Identity

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

Identity 参数指定传递代理连接器的 GUID 或名称。

参数属性

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

参数集

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

-IsScopedConnector

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

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

默认值为 $false。

参数属性

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

参数集

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

-MaxConcurrentConnections

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

MaxConcurrentConnections 参数指定此连接器从特定 IP 地址接受的最大并发连接数。

默认值为 5。

参数属性

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

参数集

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

-MaxMessageSize

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

MaxMessageSize 参数指定此连接器允许传递的最大邮件大小。 有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。

  • B(字节)
  • KB(千字节)
  • MB(兆字节)
  • GB(千兆字节)

未限定的值被视为以字节为单位。 此参数的有效输入范围是从 65536 到 2147483647 字节。

默认值为 unlimited。

参数属性

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

参数集

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

-MaxMessagesPerConnection

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

MaxMessagesPerConnection 参数指定此连接器每次连接时接受的最大邮件数。 达到此限制后,连接器终止连接,发送服务器需要启动新的连接以便发送更多的邮件。

默认值为 20。

参数属性

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

参数集

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

-Name

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

Name 参数指定此传递代理连接器的名称。 Name 参数的值不能超过 64 个字符。

参数属性

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

参数集

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

-SourceTransportServers

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

SourceTransportServers 参数指定承载此连接器的邮箱服务器列表。 可以指定多台服务器,使用逗号将名称分隔。

默认情况下,仅将在其上执行此命令的本地服务器添加到此参数。

参数属性

类型: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 不返回任何数据。