New-SettingOverride
內部部署 Exchange 才有提供此 Cmdlet。
注意:不正確使用設定覆寫 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>]
Description
設定 會覆寫在 Active Directory 中設定及儲存 Exchange Server 自定義專案。 這些設定可以是整個組織或伺服器特定的設定,而且會跨 Exchange 累積 匯報 () 保存在 Active Directory 中。 web.config 或 exe.config XML 應用程式組態檔中的 Exchange 自定義是伺服器特定的,當您安裝下一個 Exchange CU 時會遺失。
您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 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 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
適用: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-* cmdlets) 則沒有內建暫停。 在使用這些 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
Force 參數會隱藏警告或確認訊息。 您不需要使用此參數指定值。
在不適合提示系統管理員輸入的場合中,您可以使用此參數來利用程式設計方式執行工作。
參數屬性
| 類型: | 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。