Set-FrontendTransportService
此 cmdlet 仅适用于本地 Exchange。
使用 Get-FrontEndTransportService cmdlet 修改安装了客户端访问服务器角色的 Exchange 2013 或更高版本服务器上的前端传输服务配置。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Set-FrontendTransportService
[-Identity] <FrontendTransportServerIdParameter>
[-AgentLogEnabled <Boolean>]
[-AgentLogMaxAge <EnhancedTimeSpan>]
[-AgentLogMaxDirectorySize <Unlimited>]
[-AgentLogMaxFileSize <Unlimited>]
[-AgentLogPath <LocalLongFullPath>]
[-AntispamAgentsEnabled <Boolean>]
[-Confirm]
[-ConnectivityLogEnabled <Boolean>]
[-ConnectivityLogMaxAge <EnhancedTimeSpan>]
[-ConnectivityLogMaxDirectorySize <Unlimited>]
[-ConnectivityLogMaxFileSize <Unlimited>]
[-ConnectivityLogPath <LocalLongFullPath>]
[-DnsLogEnabled <Boolean>]
[-DnsLogMaxAge <EnhancedTimeSpan>]
[-DnsLogMaxDirectorySize <Unlimited>]
[-DnsLogMaxFileSize <Unlimited>]
[-DnsLogPath <LocalLongFullPath>]
[-DomainController <Fqdn>]
[-ExternalDNSAdapterEnabled <Boolean>]
[-ExternalDNSAdapterGuid <Guid>]
[-ExternalDNSProtocolOption <ProtocolOption>]
[-ExternalDNSServers <MultiValuedProperty>]
[-ExternalIPAddress <IPAddress>]
[-InternalDNSAdapterEnabled <Boolean>]
[-InternalDNSAdapterGuid <Guid>]
[-InternalDNSProtocolOption <ProtocolOption>]
[-InternalDNSServers <MultiValuedProperty>]
[-IntraOrgConnectorProtocolLoggingLevel <ProtocolLoggingLevel>]
[-MaxConnectionRatePerMinute <Int32>]
[-ReceiveProtocolLogMaxAge <EnhancedTimeSpan>]
[-ReceiveProtocolLogMaxDirectorySize <Unlimited>]
[-ReceiveProtocolLogMaxFileSize <Unlimited>]
[-ReceiveProtocolLogPath <LocalLongFullPath>]
[-RoutingTableLogMaxAge <EnhancedTimeSpan>]
[-RoutingTableLogMaxDirectorySize <Unlimited>]
[-RoutingTableLogPath <LocalLongFullPath>]
[-SendProtocolLogMaxAge <EnhancedTimeSpan>]
[-SendProtocolLogMaxDirectorySize <Unlimited>]
[-SendProtocolLogMaxFileSize <Unlimited>]
[-SendProtocolLogPath <LocalLongFullPath>]
[-TransientFailureRetryCount <Int32>]
[-TransientFailureRetryInterval <EnhancedTimeSpan>]
[-WhatIf]
[<CommonParameters>]
说明
前端传输服务在所有邮箱服务器上运行,并充当 Exchange 组织的所有入站和出站外部 SMTP 流量的无状态代理。 前端传输服务仅与邮箱服务器上的传输服务进行通信,而不在本地对任何邮件排队。
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-FrontEndTransportService MBX01 -TransientFailureRetryCount 3 -TransientFailureRetryInterval 00:00:30
对于名为 MBX01 的邮箱服务器上的前端传输服务,本示例将 TransientFailureRetryCount 参数设置为 3,同时将 TransientFailureRetryInterval 参数设置为 30 秒。
示例 2
Set-FrontEndTransportService MBX01 -ReceiveProtocolLogPath "C:\SMTP Protocol Logs\Receive.log"
对于名为 MBX01 的邮箱服务器上的前端传输服务,本示例将 ReceiveProtocolLogPath 参数设置为 C:\SMTP Protocol Logs\Receive.log。
参数
-AgentLogEnabled
AgentLogEnabled 参数指定是否启用代理日志。 默认值为 $true。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AgentLogMaxAge
AgentLogMaxAge 参数指定代理日志文件的最长期限。 早于指定值的日志文件将被删除。 默认值为 7.00:00:00(即 7 天)。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
将 AgentLogMaxAge 参数的值设置为 00:00:00,可以防止由于期限问题而自动删除代理日志文件。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AgentLogMaxDirectorySize
AgentLogMaxDirectorySize 参数指定代理日志目录中所有代理日志的最大大小。 当目录达到其最大文件大小时,服务器会首先删除最早的日志文件。 默认值为 250 MB。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
AgentLogMaxFileSize 参数的值必须小于或等于 AgentLogMaxDirectorySize 参数的值。 如果输入值 unlimited,则对代理日志目录没有大小限制。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AgentLogMaxFileSize
AgentLogMaxFileSize 参数指定每个代理日志文件的最大大小。 当日志文件达到其最大文件大小时,将创建新的日志文件。 默认值为 10 MB。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
AgentLogMaxFileSize 参数的值必须小于或等于 AgentLogMaxDirectorySize 参数的值。 如果输入值 unlimited,则对代理日志文件没有大小限制。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AgentLogPath
AgentLogPath 参数指定默认的代理日志目录位置。 默认位置为 %ExchangeInstallPath%TransportRoles\Logs\FrontEnd\AgentLog。 将此参数的值设置为 $null 可禁用代理日志记录。 但是,在 AgentLogEnabled 属性的值为 $null 时,将此参数设置为 $true 将生成事件日志错误。
Type: | LocalLongFullPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AntispamAgentsEnabled
AntispamAgentsEnabled 参数指定是否在通过 Identity 参数指定的服务器上安装了反垃圾邮件代理。 前端传输服务的默认值是 $false。
此参数是通过使用脚本设置的。 不应手动修改此参数。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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 2013, Exchange Server 2016, Exchange Server 2019 |
-ConnectivityLogEnabled
ConnectivityLogEnabled 参数指定是否启用连接日志。 默认值为 $true。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConnectivityLogMaxAge
ConnectivityLogMaxAge 参数指定连接日志文件的最长期限。 早于指定值的日志文件将被删除。 默认值为 30 天。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
例如,若要为此参数指定 25 天,请使用 25.00:00:00。 此参数的有效输入范围是 00:00:00 到 24855.03:14:07。 将 ConnectivityLogMaxAge 参数的值设置为 00:00:00,可以防止由于期限问题而自动删除连接日志文件。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConnectivityLogMaxDirectorySize
ConnectivityLogMaxDirectorySize 参数指定连接日志目录中所有连接日志的最大大小。 当目录达到其最大文件大小时,服务器会首先删除最早的日志文件。 默认值为 1,000 MB。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
ConnectivityLogMaxFileSize 参数的值必须小于或等于 ConnectivityLogMaxDirectorySize 参数的值。 这两个参数的有效输入范围都是从 1 到 9223372036854775807 字节。 如果输入值 unlimited,则对连接日志目录没有大小限制。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConnectivityLogMaxFileSize
ConnectivityLogMaxFileSize 参数指定每个连接日志文件的最大大小。 当日志文件达到其最大文件大小时,将创建新的日志文件。 默认值为 10 MB。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
ConnectivityLogMaxFileSize 参数的值必须小于或等于 ConnectivityLogMaxDirectorySize 参数的值。 这两个参数的有效输入范围都是从 1 到 9223372036854775807 字节。 如果输入值 unlimited,则对连接日志文件没有大小限制。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConnectivityLogPath
ConnectivityLogPath 参数指定默认的连接日志目录位置。 默认位置为 %ExchangeInstallPath%TransportRoles\Logs\FrontEnd\Connectivity。 将此参数的值设置为 $null 可禁用连接日志记录。 但是,在 ConnectivityLogEnabled 属性的值为 $true 时,将此参数设置为 $null 将会生成事件日志错误。
Type: | LocalLongFullPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DnsLogEnabled
DnsLogEnabled 参数指定是否启用 DNS 日志。 默认值为 $false。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DnsLogMaxAge
DnsLogMaxAge 参数指定 DNS 日志文件的最长期限。 早于指定值的日志文件将被删除。 默认值为 7.00:00:00(即 7 天)。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
将 DnsLogMaxAge 参数的值设置为 00:00:00 可以防止由于期限问题而自动删除 DNS 日志文件。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DnsLogMaxDirectorySize
DnsLogMaxDirectorySize 参数指定 DNS 日志目录中的所有 DNS 日志的最大大小。 当目录达到其最大文件大小时,服务器会首先删除最早的日志文件。 默认值为 100 MB。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
DnsLogMaxFileSize 参数的值必须小于或等于 DnsLogMaxDirectorySize 参数的值。 如果输入 unlimited 值,则对 DNS 日志目录没有大小限制。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DnsLogMaxFileSize
DnsLogMaxFileSize 参数指定每个 DNS 日志文件的最大大小。 当日志文件达到其最大文件大小时,将创建新的日志文件。 默认值为 10 MB。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
DnsLogMaxFileSize 参数的值必须小于或等于 DnsLogMaxDirectorySize 参数的值。 如果输入 unlimited 值,则对 DNS 日志文件没有大小限制。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DnsLogPath
DnsLogPath 参数指定 DNS 日志目录的位置。 默认值为空 ($null),说明未配置任何位置。 如果启用 DNS 日志记录,需要使用此参数指定 DNS 日志文件的本地文件路径。 如果路径中包含空格,则使用引号 (") 将整个路径值括起来。
Type: | LocalLongFullPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalDNSAdapterEnabled
ExternalDNSAdapterEnabled 参数指定 Exchange 用于外部 DNS 查找的一个或多个域名系统 (DNS) 服务器。 当 ExternalDNSAdapterEnabled 参数设置为 $true时,将使用由 ExternalDNSAdapterGuid 参数的值指定的外部网络适配器的 DNS 设置来执行 Exchange 组织外部目标的 DNS 查找。 如果只想指定用于外部 Exchange DNS 查找的 DNS 服务器的自定义列表,则必须使用 ExternalDNSServers 参数指定 DNS 服务器,并且还必须将 ExternalDNSAdapterEnabled 参数的值设置为$false。 ExternalDNSAdapterEnabled 参数的默认值为 $true。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalDNSAdapterGuid
ExternalDNSAdapterGuid 参数指定具有 DNS 设置的网络适配器,该设置用于对 Exchange 组织外部存在的目标进行 DNS 查找。 外部网络适配器和内部网络适配器的概念仅适用于多宿主 Exchange 服务器环境。 如果尚未将特定网络适配器指定为外部 DNS 查找的网络适配器,则 ExternalDNSAdapterGuid 参数的值为 00000000-0000-0000-0000-000000000000,并使用任何可用网络适配器的 DNS 设置执行外部 DNS 查找。 您可以输入特定网络适配器的 GUID 用于外部 DNS 查找。 ExternalDNSAdapterGuid 参数的默认值为 00000000-0000-0000-0000-000000000000。
如果将 ExternalDNSAdapterEnabled 参数的值设置为 $false,则会忽略 ExternalDNSAdapterGuid 参数的值,并使用 ExternalDNSServers 参数中的 DNS 服务器列表。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalDNSProtocolOption
ExternalDNSProtocolOption 参数指定在查询外部 DNS 服务器时所使用的协议。 此参数的有效选项为 Any、UseTcpOnly 和 UseUdpOnly。 默认值为 Any。
Type: | ProtocolOption |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalDNSServers
ExternalDNSServers 参数指定服务器在解析远程域时查询的外部 DNS 服务器的列表。 必须使用逗号分隔 IP 地址。 默认值为空列表 ({}) 。
如果将 ExternalDNSAdapterEnabled 参数设置为 $true,将不使用 ExternalDNSServers 参数及其 DNS 服务器列表。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExternalIPAddress
ExternalIPAddress 参数指定经过前端传输服务的每封邮件的 Received 邮件头字段中使用的 IP 地址。 Received 头字段中的 IP 地址用于跃点计数和路由循环检测。 ExternalIPAddress 参数指定的 IP 地址优先于外部网络适配器的实际 IP 地址。 通常,应将 ExternalIPAddress 参数的值设置为与域的公用 MX 记录的值相匹配。 ExternalIPAddress 参数的默认值为空。 这意味着在 Received 头字段中使用外部网络适配器的实际 IP 地址。
Type: | IPAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity 参数指定要修改的服务器。
Type: | FrontendTransportServerIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalDNSAdapterEnabled
InternalDNSAdapterEnabled 参数指定 Exchange 用于内部 DNS 查找的一个或多个 DNS 服务器。 当 InternalDNSAdapterEnabled 参数设置为 $true 时,将使用由 InternalDNSAdapterGuid 参数的值指定的内部网络适配器的 DNS 设置来执行 Exchange 组织内目标的 DNS 查找。 如果只想指定用于内部 Exchange DNS 查找的 DNS 服务器的自定义列表,则必须使用 InternalDNSServers 参数指定 DNS 服务器,并且还必须将 InternalDNSAdapterEnabled 参数的值设置为$false。 InternalDNSAdapterEnabled 参数的默认值为 $true。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalDNSAdapterGuid
InternalDNSAdapterGuid 参数指定具有用于对 Exchange 组织中存在的服务器的 DNS 设置的网络适配器。 内部网络适配器和外部网络适配器的概念仅适用于多宿主 Exchange 服务器环境。 如果尚未将特定网络适配器指定为外部 DNS 查找的网络适配器,则 InternalDNSAdapterGuid 参数的值为 00000000-0000-0000-0000-000000000000,并使用任何可用网络适配器的 DNS 设置执行内部 DNS 查找。 您可以输入特定网络适配器的 GUID 用于内部 DNS 查找。 InternalDNSAdapterGuid 参数的默认值为 00000000-0000-0000-0000-000000000000。
如果将 InternalDNSAdapterEnabled 参数的值设置为 $false,则会忽略 InternalDNSAdapterGuid 参数的值,并使用 InternalDNSServers 参数中的 DNS 服务器列表。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalDNSProtocolOption
InternalDNSProtocolOption 参数指定在查询内部 DNS 服务器时使用的协议。 此参数的有效选项为 Any、UseTcpOnly, 或 UseUdpOnly。
默认值为 Any。
Type: | ProtocolOption |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-InternalDNSServers
InternalDNSServers 参数指定在解析域名时应使用的 DNS 服务器列表。 DNS 服务器通过 IP 地址指定,并使用逗号分隔。 默认值为 () {} 的任何空列表。
如果设置了 InternalDNSAdapterGuid 参数,并将 InternalDNSAdapterEnabled 参数的值设置为 $true,将不使用 InternalDNSServers 参数及其 DNS 服务器列表。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IntraOrgConnectorProtocolLoggingLevel
IntraOrgConnectorProtocolLoggingLevel 参数在前端传输服务中隐式和不可见的组织内部发送连接器上启用或禁用 SMTP 协议日志记录。 有效值包含:
- 无:前端传输服务中的组织内部发送连接器禁用协议日志记录。
- 详细:为前端传输服务中的组织内部发送连接器启用协议日志记录。 此值为默认值。 日志文件的位置由 SendProtocolLogPath 参数控制。
Type: | ProtocolLoggingLevel |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MaxConnectionRatePerMinute
MaxConnectionRatePerMinute 参数指定允许对传输服务打开连接的最大速率。 如果同时有许多连接尝试访问传输服务,MaxConnectionRatePerMinute 参数将限制打开连接的速率,以免服务器的资源负荷过重。 默认值为每分钟 1200 个连接。 此参数的有效输入范围是 1 到 2147483647。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ReceiveProtocolLogMaxAge
ReceiveProtocolLogMaxAge 参数指定服务器传输服务中所有接收连接器共享的协议日志文件的最长期限。 将自动删除早于指定值的日志文件。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
有效值为 00:00:00 到 24855.03:14:07。 默认值为 30.00:00:00(30 天)。 00:00:00 值防止由于期限问题而自动删除前端传输服务中的接收连接器协议日志文件。
只有在服务器的前端传输服务中至少为一个接收连接器启用协议日志记录时,此参数才有意义。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ReceiveProtocolLogMaxDirectorySize
ReceiveProtocolLogMaxDirectorySize 参数指定服务器的前端传输服务中所有接收连接器共享的协议日志目录的最大大小。 如果已达到最大目录大小,服务器会首先删除最早的日志文件。
有效值是一个最多为 909.5 TB(999999999999999 字节)的数值或值 unlimited。 默认值为 250 MB(262144000 字节)。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
此参数的值必须大于或等于 ReceiveProtocolLogMaxFileSize 参数的值。
只有在服务器的前端传输服务中至少为一个接收连接器启用协议日志记录时,此参数才有意义。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ReceiveProtocolLogMaxFileSize
ReceiveProtocolLogMaxFileSize 参数指定由服务器上的前端传输服务中的所有接收连接器共享的协议日志文件的最大大小。 当日志文件达到其最大文件大小时,将创建新的日志文件。
有效值是一个最多为 909.5 TB(999999999999999 字节)的数值或值 unlimited。 默认值为 10 MB(10485760 字节)。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
此参数的值必须小于或等于 ReceiveProtocolLogMaxDirectorySize 参数的值。
只有在服务器的前端传输服务中至少为一个接收连接器启用协议日志记录时,此参数才有意义。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ReceiveProtocolLogPath
ReceiveProtocolLogPath 参数指定服务器的前端传输服务中所有接收连接器的协议日志目录的位置。 默认位置为 %ExchangeInstallPath%TransportRoles\Logs\FrontEnd\ProtocolLog\SmtpReceive。
不要将此参数的值设置为 $null,因为如果为前端传输服务中的任何接收连接器启用了协议日志记录,则会生成事件日志错误。 若要禁用接收连接器的协议日志记录,请在前端传输服务中的每个接收连接器的 Set-ReceiveConnector cmdlet 上对 ProtocolLoggingLevel 参数使用值 None。
Type: | LocalLongFullPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RoutingTableLogMaxAge
RoutingTableLogMaxAge 参数指定路由表日志的最长期限。 早于指定值的日志文件将被删除。 默认值为 7 天。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
例如,若要为此参数指定 5 天,请使用 5.00:00:00。 此参数的有效输入范围是 00:00:00 到 24855.03:14:07。 将此参数设置为 00:00:00 会阻止自动删除路由表日志文件,因为其使用年限。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-RoutingTableLogMaxDirectorySize
RoutingTableLogMaxDirectorySize 参数指定路由表日志目录的最大大小。 如果已达到最大目录大小,服务器会首先删除最早的日志文件。 默认值为 250 MB。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
此参数的有效输入范围是从 1 到 9223372036854775807 字节。 如果输入值 unlimited,则对路由表日志目录没有大小限制。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-RoutingTableLogPath
RoutingTableLogPath 参数指定要存储路由表日志文件的目录位置。 默认位置为 %ExchangeInstallPath%TransportRoles\Logs\FrontEnd\Routing。 将此参数设置为$null将禁用路由表日志记录。
Type: | LocalLongFullPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-SendProtocolLogMaxAge
SendProtocolLogMaxAge 参数指定将服务器配置为源服务器的前端传输服务中所有发送连接器共享的协议日志文件的最长期限。 早于指定值的日志文件将被删除。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
有效值为 00:00:00 到 24855.03:14:07。 默认值为 30.00:00:00(30 天)。 00:00:00 值防止由于期限问题而自动删除前端传输服务的发送连接器协议日志文件。
只有在服务器的前端传输服务中为至少一个发送连接器启用协议日志记录,此参数才有意义。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SendProtocolLogMaxDirectorySize
SendProtocolLogMaxDirectorySize 参数指定将服务器配置为源服务器的前端传输服务中所有发送连接器共享的协议日志目录的最大大小。 如果已达到最大目录大小,服务器会首先删除最早的日志文件。
有效值是一个最多为 909.5 TB(999999999999999 字节)的数值或值 unlimited。 默认值为 250 MB(262144000 字节)。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
此参数的值必须大于或等于 SendProtocolLogMaxDirectorySize 参数的值。
只有在服务器的前端传输服务中为至少一个发送连接器启用协议日志记录,此参数才有意义。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SendProtocolLogMaxFileSize
SendProtocolLogMaxFileSize 参数指定前端传输服务中将此服务器配置为源服务器的所有发送连接器共享的协议日志文件的最大大小。 当日志文件达到其最大文件大小时,将创建新的日志文件。
有效值是一个最多为 909.5 TB(999999999999999 字节)的数值或值 unlimited。 默认值为 10 MB(10485760 字节)。
有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。
- B(字节)
- KB(千字节)
- MB(兆字节)
- GB(千兆字节)
- TB (TB)
TB(兆兆字节)
此参数的值必须小于或等于 SendProtocolLogMaxDirectorySize 参数的值。
只有在服务器的前端传输服务中为至少一个发送连接器启用协议日志记录,此参数才有意义。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SendProtocolLogPath
SendProtocolLogPath 参数指定将此服务器配置为源服务器的前端传输服务中所有发送连接器的协议日志目录的位置。 默认位置为 %ExchangeInstallPath%TransportRoles\Logs\FrontEnd\ProtocolLog\SmtpSend。
不要将此参数的值设置为 $null,因为如果在将此服务器配置为源服务器的前端传输服务中为任何发送连接器启用了协议日志记录,则会生成事件日志错误。 若要禁用这些发送连接器的协议日志记录,请对以下参数使用值 None:
- IntraOrgConnectorProtocolLoggingLevel 参数。
- 前端传输服务中每个发送连接器的 Set-SendConnector cmdlet 上的 ProtocolLoggingLevel 参数。
Type: | LocalLongFullPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TransientFailureRetryCount
TransientFailureRetryCount 参数指定服务器在与远程服务器连接失败时,立即重试连接的最大次数。 默认值为 6。 此参数的有效输入范围是 0 到 15。 如果将此参数的值设置为 0,则服务器将不会立即尝试重试未成功的连接。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TransientFailureRetryInterval
TransientFailureRetryInterval 参数控制由 TransientFailureRetryCount 参数指定的连接尝试之间的连接间隔。 对于前端传输服务,TransientFailureRetryInterval 参数的默认值为 5 分钟。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
例如,若要为此参数指定 8 分钟,请使用 00:08:00。 此参数的有效输入范围是 00:00:01 到 12:00:00。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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 2013, Exchange Server 2016, Exchange Server 2019 |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。