Set-ExchangeSettings

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

New-ExchangeSettings コマンドレットを使用して作成した Exchange 設定オブジェクトを構成するには、Set-ExchangeSettings コマンドレットを使用します。

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

構文

ClearHistory

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-ClearHistory]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

UpdateSetting

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ConfigName <String>
    -ConfigValue <String>
    -Reason <String>
    [-UpdateSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-WhatIf]
    [<CommonParameters>]

RemoveSetting

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ConfigName <String>
    -Reason <String>
    [-RemoveSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ExpirationDate <DateTime>
    -Reason <String>
    [-ConfigPairs <String[]>]
    [-Confirm]
    [-CreateSettingsGroup]
    [-Disable]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-MaxVersion <String>]
    [-MinVersion <String>]
    [-NameMatch <String>]
    [-Priority <Int32>]
    [-Scope <ExchangeSettingsScope>]
    [-ScopeFilter <String>]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroupGuid

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ExpirationDate <DateTime>
    -GuidMatch <Guid>
    -Reason <String>
    [-ConfigPairs <String[]>]
    [-Confirm]
    [-CreateSettingsGroup]
    [-Disable]
    [-DomainController <Fqdn>]
    [-Force]
    [-GroupName <String>]
    [-Priority <Int32>]
    [-Scope <ExchangeSettingsScope>]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroupAdvanced

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -SettingsGroup <String>
    [-CreateSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

CreateSettingsGroupGeneric

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -ExpirationDate <DateTime>
    -Reason <String>
    [-CreateSettingsGroup]
    [-ConfigPairs <String[]>]
    [-GenericScopeName <String>]
    [-GenericScopeValue <String>]
    [-GroupName <String>]
    [-Confirm]
    [-Disable]
    [-DomainController <Fqdn>]
    [-Force]
    [-Priority <Int32>]
    [-Scope <ExchangeSettingsScope>]
    [-WhatIf]
    [<CommonParameters>]

UpdateSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-ExpirationDate <DateTime>]
    [-GroupName <String>]
    [-UpdateSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-Priority <Int32>]
    [-ScopeFilter <String>]
    [-WhatIf]
    [<CommonParameters>]

RemoveMultipleSettings

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -ConfigPairs <String[]>
    [-GroupName <String>]
    [-RemoveSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

RemoveSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-GroupName <String>]
    [-RemoveSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

UpdateSettingsGroupAdvanced

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -SettingsGroup <String>
    [-UpdateSettingsGroup]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

UpdateMultipleSettings

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    -ConfigPairs <String[]>
    [-GroupName <String>]
    [-UpdateSetting]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

EnableSettingsGroup

Set-ExchangeSettings
    [-Identity] <ExchangeSettingsIdParameter>
    -Reason <String>
    [-EnableGroup <String>]
    [-DisableGroup <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Force]
    [-WhatIf]
    [<CommonParameters>]

説明

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例 1

Set-ExchangeSettings Audit -UpdateSetting -ConfigName AuditLogPumperEnabled -ConfigValue $true -Reason "Enable Unified Audit Logging"

この例では、統合監査ログの結果を表示することができます。 この例では、-Name Audit コマンドを実行して、監査構成スキーマの Exchange 設定オブジェクト New-ExchangeSettings 作成済みであることを前提としています。

パラメーター

-ClearHistory

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

ClearHistory スイッチは、Exchange 設定オブジェクトの変更履歴のエントリをクリアすることを指定します。 このスイッチで値を指定する必要はありません。

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

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

パラメーター セット

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

-ConfigName

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

ConfigName パラメーターは、Exchange 設定オブジェクトで追加、削除、または更新する使用可能な Exchange 設定を指定します。 このパラメーターの有効な値は、New-ExchangeSettings コマンドレットの Name パラメーターで指定された構成スキーマによって決まります。

追加および更新の操作については、ConfigValue パラメーターも使用して設定の実際の値を指定する必要があります。 ConfigName パラメーターは ConfigPairs パラメーターと併用できません。

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

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

パラメーター セット

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

-ConfigPairs

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

ConfigName パラメーターは、Exchange 設定オブジェクトで追加、削除、または更新する使用可能な Exchange 設定を指定します。 このパラメーターの有効な値は、New-ExchangeSettings コマンドレットの Name パラメーターで指定された構成スキーマによって決まります。 値の構文は <Key>=<Value>。 複数の値をコンマで区切って指定できます。

ConfigPairs パラメーターは、ConfigName または ConfigValue パラメーターと併用できません。

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

型:

String[]

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

パラメーター セット

CreateSettingsGroup
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
CreateSettingsGroupGuid
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
CreateSettingsGroupGeneric
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
RemoveMultipleSettings
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateMultipleSettings
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ConfigValue

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

ConfigValue パラメーターは、ConfigName パラメーターで指定した Exchange 設定の値を指定します。 値は設定の種類 (数値、期間、$true、$false など) によって決まります。

ConfigValue パラメーターは ConfigPairs パラメーターと併用できません。

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

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

パラメーター セット

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

-Confirm

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

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

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

このコマンドレットには一時停止が組み込まれているため、 -Confirm:$false を使用して確認をスキップします。

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

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

パラメーター セット

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

-CreateSettingsGroup

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

CreateSettingsGroup スイッチは、関連する Exchange 設定のグループである Exchange 設定グループを作成することを指定します。 このスイッチで値を指定する必要はありません。

設定グループの構成方法に応じて、GroupName パラメーターまたは SettingsGroup パラメーターを使用して、Exchange 設定グループの名前を指定します。 既存の設定グループの名前は変更できないため、慎重に選択してください。

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

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

パラメーター セット

CreateSettingsGroup
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
CreateSettingsGroupGuid
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
CreateSettingsGroupAdvanced
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
CreateSettingsGroupGeneric
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Disable

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

[無効] スイッチは、Exchange 設定グループが無効になっていることを指定します。 このスイッチで値を指定する必要はありません。

このスイッチは CreateSettingsGroup スイッチのみと併用できます。

このスイッチを使用して Exchange 設定グループを有効にするには、この正確な構文 -Disable:$falseを使用します。

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

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

パラメーター セット

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

-DisableGroup

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

DisableGroup パラメーターは、無効にする有効な Exchange 設定グループの名前を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

DisableGroup パラメーターと EnableGroup パラメーターを同じコマンドで同時に使用して、異なる Exchange 設定グループを同時に有効または無効にすることができます。

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

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

パラメーター セット

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

-DomainController

適用対象: 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

-EnableGroup

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

EnableGroup パラメーターは、有効にする無効な Exchange 設定グループの名前を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

DisableGroup パラメーターと EnableGroup パラメーターを同じコマンドで同時に使用して、異なる Exchange 設定グループを同時に有効または無効にすることができます。

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

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

パラメーター セット

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

-ExpirationDate

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

ExpirationDate パラメーターは、指定した Exchange 設定グループによって定義される Exchange 設定の終了日時を指定します。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、コンピューターが短い日付形式 MM/dd/yyyy を使用するように構成されている場合は、「2018 年 9 月 1 日」と入力して、2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

ExpirationDate パラメーターは、CreateSettingsGroup または UpdateSettings グループ パラメーターでのみ使用できます。

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

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

パラメーター セット

CreateSettingsGroup
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
CreateSettingsGroupGuid
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
CreateSettingsGroupGeneric
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateSettingsGroup
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Force

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

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

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

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

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

パラメーター セット

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

-GenericScopeName

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

GenericScopeName パラメーターは、スコープの名前を指定します。 使用可能な値は、Exchange 設定オブジェクトのスキーマによって決まります。

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

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

パラメーター セット

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

-GenericScopeValue

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

GenericScopeValue パラメーターは、GenericScopeName パラメーターで指定されたスコープの値を指定します。 使用可能な値は、Exchange 設定オブジェクトのスキーマによって決まります。

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

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

パラメーター セット

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

-GroupName

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

GroupName パラメーターは、グループ操作の Exchange 設定グループの名前を指定します。 例:

  • Exchange 設定グループを作成し、グループのスコープと優先度を同時に構成します。
  • 既存の Exchange 設定グループの ExpirationDate、Priority、ScopeFilter の値を変更します。
  • 既存の Exchange 設定グループを削除します。
  • 既存の Exchange 設定グループの Exchange 設定オブジェクトを追加、削除、または更新します。

値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

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

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

パラメーター セット

UpdateSetting
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
RemoveSetting
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
CreateSettingsGroup
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
CreateSettingsGroupGuid
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
CreateSettingsGroupGeneric
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateSettingsGroup
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
RemoveMultipleSettings
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
RemoveSettingsGroup
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateMultipleSettings
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-GuidMatch

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

GuidMatch パラメーターは、オブジェクトの GUID (メールボックス データベースの GUID など) に基づいて Exchange 設定グループのスコープを指定します。 このパラメーターは、Forest を除くすべての Scope パラメーター値で使用できます。

GuidMatch パラメーターは、GroupName パラメーターで CreateSettingsGroup スイッチを使用して Exchange 設定グループを作成する場合にのみ使用します。

このパラメーターは、GenericScopeName、GenericScopeValue、MaxVersion、MinVersion、NameMatch パラメーターと併用できません。

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

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

パラメーター セット

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

-Identity

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

Identity パラメーターは、構成する Exchange 設定を含む既存の Exchange 設定オブジェクトの名前を指定します。

このパラメーターの値は、Exchange 設定オブジェクトの作成時に、New-ExchangeSetting コマンドレットの Name パラメーターの値です。

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

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

パラメーター セット

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

-MaxVersion

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

MaxVersion パラメーターは、オブジェクトのバージョン (たとえば、サーバーにインストールされている Exchange のバージョン) に基づいて Exchange 設定グループのスコープを指定します。 このパラメーターは、Forest を除くすべての Scope パラメーター値で使用できます。

MaxVersion パラメーターは、CreateSettingsGroup スイッチと GroupName パラメーターを使用して Exchange 設定グループを作成する場合にのみ、MinVersion パラメーターと共に使用します。

このパラメーターは GuidMatch、GenericScopeName、GenericScopeValue パラメーターと併用できません。

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

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

パラメーター セット

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

-MinVersion

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

MinVersion パラメーターは、オブジェクトのバージョン (たとえば、サーバーにインストールされている Exchange のバージョン) に基づいて Exchange 設定グループのスコープを指定します。 このパラメーターは、Forest を除くすべての Scope パラメーター値で使用できます。

MinVersion パラメーターは、CreateSettingsGroup スイッチと GroupName パラメーターを使用して Exchange 設定グループを作成する場合にのみ、MaxVersion パラメーターと共に使用します。

このパラメーターは GuidMatch、GenericScopeName、GenericScopeValue パラメーターと併用できません。

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

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

パラメーター セット

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

-NameMatch

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

NameMatch パラメーターは、オブジェクトの名前 (プロセス名など) に基づいて Exchange 設定グループのスコープを指定します。 このパラメーターは、Forest を除くすべての Scope パラメーター値で使用できます。

NameMatch パラメーターは、CreateSettingsGroup スイッチと GroupName パラメーターを使用して Exchange 設定グループを作成する場合にのみ使用します。

このパラメーターは GuidMatch、GenericScopeName、GenericScopeValue パラメーターと併用できません。

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

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

パラメーター セット

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

-Priority

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

Priority パラメーターは、Exchange 設定グループの優先順位を指定します。 すべてのグループの優先順位の値は一意である必要があります。 優先順位の値が低いほど、優先順位が高いことを意味します。

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

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

パラメーター セット

CreateSettingsGroup
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
CreateSettingsGroupGuid
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
CreateSettingsGroupGeneric
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateSettingsGroup
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Reason

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

Reason パラメーターは、Exchange 設定または設定グループが作成または変更された理由の説明を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

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

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

パラメーター セット

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

-RemoveSetting

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

RemoveSetting スイッチは、Exchange 設定オブジェクトから既存の Exchange 設定を削除することを指定します。 このスイッチで値を指定する必要はありません。

削除する設定を指定するには、ConfigPairs パラメーターまたは ConfigName パラメーターを使用します。

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

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

パラメーター セット

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

-RemoveSettingsGroup

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

RemoveSettingsGroup スイッチは、Exchange 設定グループを削除することを指定します。 このスイッチで値を指定する必要はありません。

GroupName パラメーターを使用して、削除する Exchange 設定グループを指定します。

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

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

パラメーター セット

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

-Scope

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

Scope パラメーターは、Exchange 設定オブジェクトのスコープを指定します。 有効な値は次のとおりです。

  • Dag
  • Database
  • Forest
  • Generic
  • 組織
  • プロセス
  • サーバー
  • User

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

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

パラメーター セット

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

-ScopeFilter

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

ScopeFilter パラメーターは、OPATH フィルター構文を使用して、Exchange 設定グループのスコープを基に指定します。 構文は "Property -ComparisonOperator 'Value'" です (たとえば、 "ServerRole -like 'Mailbox*'")。

  • OPATH フィルター全体を二重引用符 " " で囲みます。 フィルターにシステム値 (例えば、$true$false、または $null) が含まれている場合は、代わりに単一引用符 ' ' を使用します。 このパラメーターは文字列 (システム ブロックではありません) ですが、波かっこ { } を使用することもできますが、これはフィルターに変数が含まれていない場合のみです。
  • Property はフィルタリング可能なプロパティです。
  • ComparisonOperator は OPATH 比較演算子です (たとえば、文字列比較の場合は等号と-like-eq)。 比較演算子の詳細については、「about_Comparison_Operators」を参照してください。
  • Value は、検索するプロパティ値です。 テキスト値と変数を一重引用符 ('Value'または'$Variable') で囲みます。 変数値に一重引用符が含まれている場合、変数を正しく展開するには、一重引用符を識別する (エスケープする) 必要があります。 たとえば、'$User'の代わりに'$($User -Replace "'","''")'を使用します。 整数またはシステム値を引用符で囲まないでください (たとえば、代わりに 500$true$false、または $null を使用します)。

論理演算子 -and および -or を使用すると、複数の検索条件を連結することができます。 たとえば、"Criteria1 -and Criteria2" または "(Criteria1 -and Criteria2) -or Criteria3" です。

Exchange の OPATH フィルターの詳細については、「 その他の OPATH 構文情報」を参照してください。

Scope パラメーターと値 Forest またはその他のスコープ関連パラメーターでは、このパラメーターを使用できません。

このパラメーターは、UpdateSettingsGroup スイッチと GroupName パラメーターを使用して Exchange 設定グループを更新する場合にのみ使用します。

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

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

パラメーター セット

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

-SettingsGroup

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

SettingsGroup パラメーターは、新しい設定グループの作成または既存の設定グループの変更に使用される既存の Exchange 設定グループを指定します。

SettingsGroup パラメーターは GroupName パラメーターと併用できません。

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

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

パラメーター セット

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

-UpdateSetting

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

UpdateSetting スイッチは、既存の Exchange 設定オブジェクトの Exchange 設定を更新することを指定します。 このスイッチで値を指定する必要はありません。

ConfigPairs パラメーターまたは ConfigName パラメーターと ConfigValue パラメーターを使用して、Exchange 設定を構成します。

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

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

パラメーター セット

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

-UpdateSettingsGroup

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

UpdateSettingsGroup スイッチは、Exchange 設定グループを変更することを指定します。 このスイッチで値を指定する必要はありません。

設定グループの構成方法に応じて、GroupName パラメーターまたは SettingsGroup パラメーターを使用して、変更する Exchange 設定グループを指定します。

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

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

パラメーター セット

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

-WhatIf

適用対象: 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」を参照してください。