次の方法で共有

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

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

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

  • TimeBasedAssistants
  • OwaServer

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

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

パラメーター セット

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

-Confirm

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

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

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

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

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

パラメーター セット

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

-DomainController

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

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

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

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

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

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

パラメーター セット

(All)
配置: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
DontShow:False

パラメーター セット

(All)
配置: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
DontShow:False

パラメーター セット

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

-Name

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

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

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

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

パラメーター セット

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

-Parameters

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

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

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

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

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

パラメーター セット

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

-Section

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

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

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

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

パラメーター セット

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

-Server

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

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

WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。

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

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

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

CommonParameters

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