通过

New-SettingOverride

模块:
Exchange PowerShell

此 cmdlet 仅适用于本地 Exchange。

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

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

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

语法

Default （默认值） 

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

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

  • TimeBasedAssistants
  • OwaServer

参数属性

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

参数集

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

-Confirm

适用：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

-DomainController

适用：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

-Force

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

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

参数属性

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

参数集

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

-MaxVersion

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

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

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

参数属性

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

参数集

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

-MinVersion

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

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

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

参数属性

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

参数集

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

-Name

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

参数属性

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

参数集

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

-Parameters

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

  • @("Enabled=true")
  • @("IMServerName=<SkypePoolFQDN>","IMCertificateThumbprint=<ThumbprintGUID>")

参数属性

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

参数集

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

-Reason

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Reason 参数指定为什么要创建设置替换。 如果值中有空格，请使用双引号 (") 将此值括起来。

参数属性

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

参数集

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

-Section

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

参数属性

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

参数集

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

-Server

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

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

如果不使用此参数指定服务器，则替代将应用于 Active Directory 林中的所有 Exchange 2016 服务器。

参数属性

类型:

String[]

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

参数集

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

-WhatIf

适用：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。