New-SettingOverride

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

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

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

以下の構文セクションのパラメーター セットの詳細については、「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 に保存します。 設定は organizationwide またはサーバー固有であり、Exchange Cumulative 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 サーバー統合」という名前の新しい設定オーバーライドを作成します。 このオーバーライドは、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"

この例では、「OAB 世代の変更」という名前の新しい設定オーバーライドを作成します。 このオーバーライドでは、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-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。

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

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
エイリアス: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 サーバーの名前を指定します。 単一の 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
エイリアス:wi

パラメーター セット

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

CommonParameters

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