New-SettingOverride

モジュール:
Exchange PowerShell

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

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

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

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

構文

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>]

説明

設定は、Exchange サーバーのカスタマイズを構成して Active Directory に格納するオーバーライドです。 設定はorganization全体またはサーバー固有であり、Exchange 累積Updates (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 でインスタント メッセージングと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

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Component パラメーターは、設定上書きが適用されるコンポーネントを指定します。 例:

  • TimeBasedAssistants
  • OwaServer

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 この切り替えがコマンドレットにどのように影響するかは、続行する前にコマンドレットで確認が必要かどうかによって異なります。

  • データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットでは、値を指定せずに [確認] スイッチを指定すると、続行する前にコマンドの確認を強制する一時停止が発生します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DomainController

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

パラメーターのプロパティ

型:Fqdn
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Force

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。

管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MaxVersion

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

MaxVersion パラメーターは、このオーバーライドが適用される最新バージョンの Exchange 2016 を指定します (指定した値までおよび指定した値を含む)。

このパラメーターの有効な入力は、15.1.xxx.xx 形式の Exchange 2016 バージョン値です。 先行ゼロが付いた値を使用できますが、先行ゼロは結果から削除されます。 たとえば、15.01.0225.042 は 15.1.225.42 として保存されます。

既定値は空白 ($null) であり、オーバーライドは Exchange 2016 のすべてのバージョンに適用されます。

パラメーターのプロパティ

型:Version
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-MinVersion

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

MinVersion パラメーターは、このオーバーライドが適用される Exchange 2016 の最も古いバージョンを指定します (指定した値までおよび指定した値を含む)。

このパラメーターの有効な入力は、15.1.xxx.xx 形式の Exchange 2016 バージョン値です。 先行ゼロが付いた値を使用できますが、先行ゼロは結果から削除されます。 たとえば、15.01.0225.042 は 15.1.225.42 として保存されます。

既定値は空白 ($null) であり、オーバーライドは Exchange 2016 のすべてのバージョンに適用されます。

パラメーターのプロパティ

型:Version
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Name パラメーターは、設定上書きの一意の名前を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Parameters

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Parameters パラメーターは、Component および Section パラメーターの値の組み合わせで利用可能な上書きの 1 つ以上のパラメーターを指定します。 このパラメーターは次の構文を使用します: @("Parameter1=Value1","Parameter2=Value2"...)。 例:

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

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Reason

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Reason パラメーターは、設定上書きを作成する理由を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Section

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Section パラメーターは、上書きを作成するセクションの名前を指定します。 このパラメーターに使用できる値は、Component パラメーターの値に依存しています。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Server

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Server パラメーターは、オーバーライドを適用する Exchange 2016 サーバーの名前を指定します。 1 つの Exchange 2016 サーバー名、または Exchange 2016 サーバー名ワイルドカードの配列を指定できます。 たとえば、Exchange01、Exchange02、Exchange03 という名前の 3 つの Exchange 2016 サーバーがある場合は、値 Exchange* を指定して、それらのすべてにオーバーライドを適用します。

このパラメーターを使用してサーバーを指定しない場合、オーバーライドはActive Directory フォレスト内のすべての Exchange 2016 サーバーに適用されます。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

WhatIf スイッチは、変更を加えずにコマンドの動作を示します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:wi

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。