Set-SettingOverride

此 cmdlet 仅适用于本地 Exchange。

警告:设置替代 cmdlet 的使用不正确可能会对 Exchange 组织造成严重损害。 此损坏可能需要重新安装 Exchange。 仅按照产品文档的说明或Microsoft客户服务和支持的指导使用这些 cmdlet。

使用 Set-SettingOverride cmdlet 修改将 Exchange 自定义项存储在 Active Directory 而不是服务器上的文本文件中的设置替代。

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

语法

Set-SettingOverride
   [-Identity] <SettingOverrideIdParameter>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-MaxVersion <Version>]
   [-MinVersion <Version>]
   [-Parameters <MultiValuedProperty>]
   [-Reason <String>]
   [-Server <String[]>]
   [-WhatIf]
   [<CommonParameters>]

说明

设置将替代在 Active Directory 中配置和存储 Exchange 服务器自定义项。 这些设置可以是组织范围设置,也可以特定于服务器,并且会跨 Exchange 累积汇报 (库) 保留在 Active Directory 中。 web.config 或 exe.config XML 应用程序配置文件中的 Exchange 自定义项特定于服务器,在安装下一个 Exchange CU 时会丢失。

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Set-SettingOverride -Identity "Change OAB Generation" -Server Mailbox01 -Parameters @("WorkCycle=03:00:00")

本示例通过将 OAB 生成间隔更改为 3 小时,修改名为 Mailbox01 的服务器上名为“更改 OAB 生成”的设置替代。

参数

-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

-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

-Force

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Identity

Identity 参数指定要修改的设置替代。 可以使用任何唯一标识该替换的值。 例如:

  • 名称
  • 可分辨名称 (DN)
  • GUID
Type:SettingOverrideIdParameter
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

-MaxVersion

MaxVersion 参数指定此重写应用于 (的最新版本的 Exchange 2016,该版本最多包括指定值) 。

此参数的有效输入是格式为 15.1.xxx.xx 的 Exchange 2016 版本值。 您可以使用带前导零的值,但系统会从结果中删除前导零。 例如,系统会将 15.01.0225.042 存储为 15.1.225.42。

若要删除配置的版本值,以便重写适用于所有版本的 Exchange 2016,请使用 值$null。

Type:Version
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

-MinVersion

MinVersion 参数指定此重写应用于 (的最早版本的 Exchange 2016,包括指定值) 。

此参数的有效输入是格式为 15.1.xxx.xx 的 Exchange 2016 版本值。 您可以使用带前导零的值,但系统会从结果中删除前导零。 例如,系统会将 15.01.0225.042 存储为 15.1.225.42。

若要删除配置的版本值,以便重写适用于所有版本的 Exchange 2016,请使用 值$null。

Type:Version
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

-Parameters

Parameters 参数为替换指定一个或多个参数,可用于 Component 和 Section 参数值的组合。 此参数使用语法: @("Parameter1=Value1","Parameter2=Value2"...)。 例如:

  • @("Enabled=true")
  • @("IMServerName=<SkypePoolFQDN>","IMCertificateThumbprint=<ThumbprintGUID>")
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

-Reason

Reason 参数用于说明创建替代的原因。 如果值中有空格,请使用双引号 (") 将此值括起来。

Type:String
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

-Server

Server 参数指定要应用替代的 Exchange 2016 服务器的名称。 可以指定单个 Exchange 2016 服务器名称或 Exchange 2016 服务器名称通配符数组。 例如,如果有三个名为 Exchange01、Exchange02 和 Exchange03 的 Exchange 2016 服务器,请指定值 Exchange* 以对所有服务器应用替代。

若要删除指定的服务器,以便重写应用于 Active Directory 林中的所有 Exchange 2016 服务器,请使用 值 $null。

Type:String[]
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