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」を参照してください。