New-SettingOverride

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

內部部署 Exchange 才有提供此 Cmdlet。

注意：不正確使用設定覆寫 Cmdlet 可能會對您的 Exchange 組織造成嚴重損害。此損害可能需要您重新安裝 Exchange。請只依照產品檔或Microsoft客戶服務和支援指示使用這些 Cmdlet。

使用 New-SettingOverride Cmdlet 來建立設定覆寫，以將 Exchange 自訂專案儲存在 Active Directory 中，而不是儲存在伺服器上的文字檔中。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

New-SettingOverride
   [-Name] <String>
   -Component <String>
   -Parameters <MultiValuedProperty>
   -Reason <String>
   -Section <String>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-MaxVersion <Version>]
   [-MinVersion <Version>]
   [-Server <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

設定會覆寫在 Active Directory 中設定及儲存 Exchange Server 自訂專案。這些設定可以是整個組織或伺服器特定的設定，而且會跨 Exchange 累積更新 () 保存在 Active Directory 中。 web.config或exe.config XML 應用程式組態檔中的 Exchange 自訂是伺服器特定的，當您安裝下一個 Exchange CU 時會遺失。

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 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 Server 2015 集區和憑證指紋，以允許立即訊息 (IM) Outlook 網頁版與商務用 Skype之間的整合。因為未使用 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

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