Set-SettingOverride

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

注意: 設定オーバーライドコマンドレットを誤って使用すると、Exchange 組織に重大な損害が発生する可能性があります。この損傷により、Exchange の再インストールが必要になる可能性があります。これらのコマンドレットは、製品ドキュメントの指示に従うか、カスタマーサービスとサポートの指示Microsoft使用してください。

Set-SettingOverride コマンドレットを使用して、サーバー上のテキストファイルではなく Active Directory に Exchange のカスタマイズを格納する設定のオーバーライドを変更します。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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

説明

設定は、Exchange サーバーのカスタマイズを構成して Active Directory に格納するオーバーライドです。設定は組織全体またはサーバー固有であり、Exchange 累積的な更新 (CU) 全体にわたって Active Directory に保持されます。 web.configまたはexe.config XML アプリケーション構成ファイルの Exchange カスタマイズはサーバー固有であり、次の Exchange CU をインストールすると失われます。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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 という名前のサーバーで Change OAB Generation という名前の設定オーバーライドを変更します。

パラメーター

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。これらのコマンドレットの場合、値なしで 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 パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは 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 の最も古いバージョンを指定します (指定した値までおよび指定した値を含む)。

構成されたバージョン値を削除して、オーバーライドが 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 パラメーターの値の組み合わせで利用可能な上書きの 1 つ以上のパラメーターを指定します。このパラメーターは、構文を使用します。 @("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 サーバーの名前を指定します。 1 つの Exchange 2016 サーバー名、または Exchange 2016 サーバー名ワイルドカードの配列を指定できます。たとえば、Exchange01、Exchange02、Exchange03 という名前の 3 つの 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