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