New-SettingOverride

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅适用于本地 Exchange。

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

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

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

语法

New-SettingOverride
   [-Name] <String>
   -Component <String>
   -Parameters <MultiValuedProperty>
   -Reason <String>
   -Section <String>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-MaxVersion <Version>]
   [-MinVersion <Version>]
   [-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

New-SettingOverride -Name "IM Override" -Component OwaServer -Section IMSettings -Parameters @("IMServerName=skype01.contoso.com","IMCertificateThumbprint=CDF34A740E9D225A1A06193A9D44B2CE22775308") -Reason "Configure IM"

此示例创建名为 IM Server Integration 的新设置替代。此替代指定Skype for Business Server 2015 池和证书指纹，该池允许即时消息 (IM) Outlook 网页版与Skype for Business之间的集成。由于不使用 Server 参数，因此重写适用于 Active Directory 林中的所有 Exchange 2016 服务器。

有关详细信息，请参阅主题在 Exchange 2016 中配置与 Outlook 网页版的即时消息集成。

示例 2

New-SettingOverride -Name "Change OAB Generation" -Server Mailbox01 -Component TimeBasedAssistants -Section OABGeneratorAssistant -Parameters @("WorkCycle=02:00:00") -Reason "Generate OAB Every 2 hours"

此示例创建名为 Change OAB Generation 的新设置替代。此替代指定 2 小时的 OAB 生成间隔。由于使用了 Server 参数，因此重写仅适用于名为 Mailbox01 的指定服务器。

有关详细信息，请参阅主题更改 Exchange 中的脱机通讯簿生成计划。

参数

-Component

Component 参数指定应用此设置替换的组件。例如：

TimeBasedAssistants
OwaServer

Type:	String
Position:	Named
Default value:	None
Required:	True
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

-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 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。

默认值为空白 ($null) ，这意味着重写适用于所有版本的 Exchange 2016。

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，包括指定值) 。

默认值为空白 ($null) ，这意味着重写适用于所有版本的 Exchange 2016。

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

-Name

Name 参数指定设置替换的唯一名称。如果值中有空格，请使用双引号 (") 将此值括起来。

Type:	String
Position:	1
Default value:	None
Required:	True
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:	True
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:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Section

Section 参数指定要为其创建替换的部分的名称。可用与此参数的值取决于 Component 参数的值。

Type:	String
Position:	Named
Default value:	None
Required:	True
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 服务器。

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