Set-SettingOverride
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
注意: 設定オーバーライド コマンドレットを誤って使用すると、Exchange organizationに重大な損害が発生する可能性があります。 この損傷により、Exchange の再インストールが必要になる可能性があります。 これらのコマンドレットは、製品ドキュメントまたは Microsoft カスタマー サービスとサポートの指示に従ってのみ使用してください。
Set-SettingOverride コマンドレットを使用して、サーバー上のテキスト ファイルではなく Active Directory に Exchange のカスタマイズを格納する設定のオーバーライドを変更します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Set-SettingOverride
[-Identity] <SettingOverrideIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-MaxVersion <Version>]
[-MinVersion <Version>]
[-Parameters <MultiValuedProperty>]
[-Reason <String>]
[-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
Set-SettingOverride -Identity "Change OAB Generation" -Server Mailbox01 -Parameters @("WorkCycle=03:00:00")
次の使用例は、OAB 生成間隔を 3 時間に変更することで、Mailbox01 という名前のサーバーで Change OAB Generation という名前の設定オーバーライドを変更します。
パラメーター
-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 2016、Exchange Server 2019
[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Identity パラメーターは、変更する設定上書きを指定します。 その上書きを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
パラメーターのプロパティ
| 型: | SettingOverrideIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | 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 として保存されます。
構成されたバージョン値を削除して、オーバーライドが Exchange 2016 のすべてのバージョンに適用されるようにするには、$null値を使用します。
パラメーターのプロパティ
| 型: | 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 として保存されます。
構成されたバージョン値を削除して、オーバーライドが Exchange 2016 のすべてのバージョンに適用されるようにするには、$null値を使用します。
パラメーターのプロパティ
| 型: | Version |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | 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 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Reason
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Reason パラメーターは、上書きが作成された理由を示すときに使用します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | 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 サーバーに適用されるようにするには、$null値を使用します。
パラメーターのプロパティ
| 型: | 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」を参照してください。