New-SettingOverride

リファレンス

モジュール:: ExchangePowerShell

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

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

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

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

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

構文

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

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 プールと、Outlook on the webとSkype for Business間のインスタントメッセージング (IM) 統合を可能にする証明書拇印を指定します。 Server パラメーターは使用されないため、オーバーライドは Active Directory フォレスト内のすべての Exchange 2016 サーバーに適用されます。

詳細については、「Exchange 2016 でインスタントメッセージングとOutlook on the webの統合を構成する」トピックを参照してください。

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

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