Set-EdgeSyncServiceConfig

此 cmdlet 仅适用于本地 Exchange。

使用 Set-EdgeSyncServiceConfig cmdlet 修改可控制所有 EdgeSync 服务共享的同步行为的边缘同步服务设置的配置。

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

语法

Default (默认值)

Set-EdgeSyncServiceConfig
    [-Identity] <EdgeSyncServiceConfigIdParameter>
    [-ConfigurationSyncInterval <EnhancedTimeSpan>]
    [-Confirm]
    [-CookieValidDuration <EnhancedTimeSpan>]
    [-DomainController <Fqdn>]
    [-FailoverDCInterval <EnhancedTimeSpan>]
    [-LockDuration <EnhancedTimeSpan>]
    [-LockRenewalDuration <EnhancedTimeSpan>]
    [-LogEnabled <Boolean>]
    [-LogLevel <EdgeSyncLoggingLevel>]
    [-LogMaxAge <EnhancedTimeSpan>]
    [-LogMaxDirectorySize <Unlimited>]
    [-LogMaxFileSize <Unlimited>]
    [-LogPath <String>]
    [-Name <String>]
    [-OptionDuration <EnhancedTimeSpan>]
    [-RecipientSyncInterval <EnhancedTimeSpan>]
    [-WhatIf]
    [<CommonParameters>]

说明

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

示例

示例 1

Set-EdgeSyncServiceConfig "Primary EdgeSync Settings" -LogEnabled $true -LogLevel Medium -LogPath "\\Server01\EdgeSyncLog" -LogMaxFileSize 5MB -LogMaxAge 3

此示例使用以下值配置名为“主 EdgeSync 设置”的 Microsoft Exchange EdgeSync 服务设置:

启动 EdgeSync 日志记录并将其设置为中等详细级别。

日志文件存储在服务器 Server01 上的 EdgeSyncLog 共享中。

每个日志文件的大小最大为 5 MB。

日志文件将保留 3 天。

参数

-ConfigurationSyncInterval

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

ConfigurationSyncInterval 参数指定 exchange EdgeSync 服务Microsoft同步配置数据的频率。 默认值为 3 分钟。

若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。

参数属性

类型:EnhancedTimeSpan
默认值: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

-CookieValidDuration

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

CookieValidDuration 参数指定 Cookie 记录的有效时长。 默认值为 21 天。

若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。

参数属性

类型:EnhancedTimeSpan
默认值: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。

参数属性

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

参数集

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

-FailoverDCInterval

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

FailoverDCInterval 参数指定如果 EdgeSync 无法从 Active Directory 读取配置数据,则故障转移到另一个域控制器之前等待的时间。 默认值为 5 分钟。

若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。

参数属性

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

参数集

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

-Identity

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

Identity 参数指定要配置的 Microsoft Exchange EdgeSync 服务的名称。

参数属性

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

参数集

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

-LockDuration

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

LockDuration 参数指定 Microsoft Exchange EdgeSync 服务的实例可以保留同步权限上的排他锁的时间长度。 在 EdgeSync 服务维护对同步权限的排他锁时,其他任何 EdgeSync 服务都不能接管同步。 默认值为 6 分钟。

若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。

参数属性

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

参数集

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

-LockRenewalDuration

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

LockRenewalDuration 参数指定排他锁到期之前 EdgeSync 服务可以续订锁的时长。 默认值为 4 分钟。

若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。

参数属性

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

参数集

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

-LogEnabled

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

LogEnabled 参数指定启用或禁用 EdgeSyncLog。 此参数的有效输入为 $true 或 $false。 默认值为 $true。

参数属性

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

参数集

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

-LogLevel

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

LogLevel 参数指定 EdgeSync 日志记录级别。 有效值包含:

  • 无 (默认值)

参数属性

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

参数集

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

-LogMaxAge

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

LogMaxAge 参数保留 EdgeSyncLog 文件的最大天数。 可以将早于指定值的日志文件删除。 默认值为 30 天。

若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。

参数属性

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

参数集

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

-LogMaxDirectorySize

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

LogMaxDirectorySize 指定 EdgeSyncLog 目录可以使用的最大磁盘空间量。 默认值为 250 MB。

有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。

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

非限定值通常被视为字节,但小值可能会向上舍入到最接近的千字节。

LogMaxFileSize 参数的值必须小于或等于 LogMaxDirectorySize 参数的值。 这两个参数的有效输入范围都是从 1 到 9223372036854775807 字节。 如果输入值 unlimited,则对 EdgeSyncLog 目录没有大小限制。

参数属性

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

参数集

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

-LogMaxFileSize

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

LogMaxFileSize 参数指定 EdgeSyncLog 文件的最大日志文件大小。 默认值为 10 MB。

有效值是一个数字,最大可为 1.999999999 TB(即 2199023254528 B)或值 unlimited。默认值为 6 GB(即 6442450944 B)。

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

非限定值通常被视为字节,但小值可能会向上舍入到最接近的千字节。

LogMaxFileSize 参数的值必须小于或等于 LogMaxDirectorySize 参数的值。 这两个参数的有效输入范围都是从 1 到 9223372036854775807 字节。 如果输入值 unlimited,则对连接 EdgeSyncLog 文件没有大小限制。

参数属性

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

参数集

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

-LogPath

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

LogPath 参数指定用于存储 EdgeSyncLog 文件的磁盘位置。 默认值为 TransportRoles\Logs\EdgeSync\。

参数属性

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

参数集

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

-Name

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

Name 参数为 EdgeSync 服务配置指定一个唯一名称。

参数属性

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

参数集

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

-OptionDuration

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

OptionDuration 参数指定 Microsoft Exchange EdgeSync 服务的实例可以保留同步权限上的可选锁的时间长度。 在 EdgeSync 服务维护对同步权限的可选锁时,如果此同步是使用 Start-EdgeSynchronization 命令启动的,则在可选锁到期之后,其他 EdgeSync 服务可接管此同步。 默认值为 30 分钟。

若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。

参数属性

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

参数集

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

-RecipientSyncInterval

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

RecipientSyncInterval 参数指定 Microsoft Exchange EdgeSync 服务从全局编录同步收件人数据的频率。 默认值为 5 分钟。

若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。

参数属性

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