Set-ComplianceSearch

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2016, Exchange Server 2019, Security & Compliance

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

Set-ComplianceSearch コマンドレットを使用して、Exchange Server 2016 以降およびMicrosoft Purview コンプライアンス ポータルで実行されていないコンプライアンス検索を変更します。

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

構文

Set-ComplianceSearch
   [-Identity] <ComplianceSearchIdParameter>
   [-AddExchangeLocation <String[]>]
   [-AddExchangeLocationExclusion <String[]>]
   [-AddSharePointLocation <String[]>]
   [-AddSharePointLocationExclusion <String[]>]
   [-AllowNotFoundExchangeLocationsEnabled <Boolean>]
   [-Confirm]
   [-ContentMatchQuery <String>]
   [-Description <String>]
   [-ExchangeLocation <String[]>]
   [-ExchangeLocationExclusion <String[]>]
   [-Force]
   [-HoldNames <String[]>]
   [-IncludeOrgContent <Boolean>]
   [-IncludeUserAppContent <Boolean>]
   [-Language <CultureInfo>]
   [-Name <String>]
   [-PublicFolderLocation <String[]>]
   [-RefinerNames <String[]>]
   [-RemoveExchangeLocation <String[]>]
   [-RemoveExchangeLocationExclusion <String[]>]
   [-RemovePublicFolderLocation <String[]>]
   [-RemoveSharePointLocation <String[]>]
   [-RemoveSharePointLocationExclusion <String[]>]
   [-SharePointLocation <String[]>]
   [-SharePointLocationExclusion <String[]>]
   [-WhatIf]
   [<CommonParameters>]

説明

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

オンプレミスの Exchange では、このコマンドレットはメールボックス検索ロールで使用できます。 既定では、このロールは Discovery Management ロール グループにのみ割り当てられます。

セキュリティ & コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可を割り当てる必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。

例

例 1

Set-ComplianceSearch -Identity "Project X" -ExchangeLocation All

次の使用例は、Project X という名前の既存のコンプライアンス検索を変更します。Exchange 検索のスコープは、すべてのメールボックスに変更されます。

例 2

Set-ComplianceSearch -Identity "Contoso Case Search 1" -HoldNames All -ExchangeLocation $null -SharePointLocation $null

この例では、Microsoft Purview コンプライアンス ポータルの電子情報開示ケースに関連付けられている既存のコンプライアンス検索を変更します。 検索の範囲は、選択したメールボックスと SharePoint サイトの検索から、電子情報開示ケースで保留されているすべてのコンテンツの場所の検索に変更されます。

例 3

Set-ComplianceSearch -Identity "China Subsidiary Search" -Language zh-CN

次の使用例は、既存のコンプライアンス検索の言語設定を中国語に変更します。

検索クエリで英語以外のキーワード (ContentMatchQuery パラメーターで指定されている) を使用している場合は、言語設定を変更する必要がある場合があります。

パラメーター

-AddExchangeLocation

AddExchangeLocation パラメーターは、ExchangeLocation パラメーターの値 All を使用していない場合に含まれるメールボックスの一覧に追加するメールボックスを指定します。 有効な値は次のとおりです。

  • 通常のユーザー メールボックス。 他の種類のメールボックス (非アクティブなメールボックスやMicrosoft 365 ゲスト ユーザーなど) を含めることは、AllowNotFoundExchangeLocationsEnabled パラメーターによって制御されます。
  • メールボックス。

メールボックスまたは配布グループを指定するには、メール アドレスを使用します。 複数の値をコンマで区切って指定できます。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-AddExchangeLocationExclusion

このパラメーターは、オンプレミスの Exchange でのみ使用可能で正常に機能します。

このパラメーターは、ExchangeLocation パラメーターの値 All を使用するときに除外されたメールボックスの一覧に追加するメールボックスを指定します。 有効な値は次のとおりです。

  • 通常のユーザー メールボックス。 他の種類のメールボックス (非アクティブなメールボックスやMicrosoft 365 ゲスト ユーザーなど) を含めることは、AllowNotFoundExchangeLocationsEnabled パラメーターによって制御されます。
  • メールボックス。

メールボックスまたは配布グループを指定するには、メール アドレスを使用します。 複数の値をコンマで区切って指定できます。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-AddSharePointLocation

このパラメーターは、クラウドベースのサービスでのみ使用できます。

AddSharePointLocation パラメーターは、SharePointLocation パラメーターの値 All を使用していない場合に含まれるサイトの一覧に追加する SharePoint Online サイトを指定します。 サイトは URL 値で指定します。

Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddSharePointLocationExclusion

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AllowNotFoundExchangeLocationsEnabled

AllowNotFoundExchangeLocationsEnabled パラメーターは、コンプライアンス検索に通常のユーザー メールボックス以外のメールボックスを含めるかどうかを指定します。 有効な値は次のとおりです。

  • $true: 検索では、先に進む前にメールボックスの存在を検証しようとしません。 この値は、通常のメールボックスとして解決されないメールボックスを検索する場合に必要です。
  • $true: 検索の際、続行する前にメールボックスの存在を検証しません。 通常のユーザー メールボックスではないメールボックスを指定した場合、検索は失敗します。 これは既定の値です。

このパラメーターの値の影響を受けるメールボックスの種類は次のとおりです。

  • 非アクティブなメールボックス
  • Office アプリケーションを使用するExchange Online ライセンスを持たないユーザー
  • ゲスト ユーザー
  • Microsoft 365 組織と同期される ID を持つオンプレミス ユーザー
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Confirm

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

  • 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
  • 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-ContentMatchQuery

ContentMatchQuery パラメーターは、コンテンツの検索フィルターを指定します。

このパラメーターには、テキストの検索文字列、またはキーワード クエリ言語 (KQL) によって書式設定されたクエリを使用します。 詳細については、「 キーワード クエリ言語 (KQL) 構文リファレンス」 および「 電子情報開示のキーワード クエリと検索条件」を参照してください。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Description

Description パラメーターは、コンプライアンス検索の説明を指定します。 値にスペースが含まれている場合は、値を引用符で囲んでください。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-ExchangeLocation

ExchangeLocation パラメーターは、含めるメールボックスを指定します。 有効な値は次のとおりです。

  • 通常のユーザー メールボックス。 他の種類のメールボックス (非アクティブなメールボックスやMicrosoft 365 ゲスト ユーザーなど) を含めることは、AllowNotFoundExchangeLocationsEnabled パラメーターによって制御されます。
  • メールボックス。
  • すべてのメールボックスの値 All。 この値は単体でのみ使用できます。

メールボックスまたは配布グループを指定するには、メール アドレスを使用します。 複数の値をコンマで区切って指定できます。

Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-ExchangeLocationExclusion

このパラメーターは、オンプレミスの Exchange でのみ使用可能で正常に機能します。

このパラメーターは、ExchangeLocation パラメーターの値 All を使用するときに除外するメールボックスを指定します。 有効な値は次のとおりです。

  • 通常のユーザー メールボックス。 他の種類のメールボックス (非アクティブなメールボックスやMicrosoft 365 ゲスト ユーザーなど) を含めることは、AllowNotFoundExchangeLocationsEnabled パラメーターによって制御されます。
  • メールボックス。

メールボックスまたは配布グループを指定するには、メール アドレスを使用します。 複数の値をコンマで区切って指定できます。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Force

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-HoldNames

このパラメーターは、クラウドベースのサービスでのみ使用できます。

HoldNames パラメーターは、電子情報開示ケースで保留にされたコンテンツの場所を検索することを指定します。 このパラメーターには、値 All を使用します。 このパラメーターは、電子情報開示ケースに関連するコンプライアンス検索にのみ使用できます。

コンプライアンス検索のコンテンツの場所にメールボックスが含まれている場合は、ExchangeLocation パラメーターを$null値と共に使用する必要もあります。 同様に、コンプライアンス検索に SharePoint サイトが含まれている場合は、値が $null の SharePointLocation パラメーターも使用する必要があります。

また、コンテンツの場所がクエリベースのケースで保持リストにある場合、このコンプライアンス検索を再開すると、保持リストにあるアイテムだけが検索されます。 たとえば、ユーザーがクエリベースのケースで保持リストに入れられていて、特定の日付以前に送信または作成されたアイテムが保存される場合には、それらのアイテムだけがこのコンプライアンス検索で指定された検索条件を使用して検索されます。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Identity

Identity パラメーターは、変更するコンプライアンス検索を指定します。

このパラメーターを使用する場合、Identity パラメーターは必要ですが、値は無視されます。 たとえば、Identity パラメーターに 000 の値を使用します。

  • 名前
  • JobRunId (GUID)

JobRunId (GUID)

Type:ComplianceSearchIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-IncludeOrgContent

{{ Fill IncludeOrgContent Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-IncludeUserAppContent

このパラメーターは、クラウドベースのサービスでのみ使用できます。

IncludeUserAppContent パラメーターは、組織内に通常の Microsoft 365 ユーザー アカウントを持たないユーザーに対してクラウドベースのストレージの場所を検索することを指定します。 これらの種類のユーザーには、Office アプリケーションを使用するExchange Online ライセンスを持たないユーザー、Microsoft 365 ゲスト ユーザー、ID が Microsoft 365 組織と同期されているオンプレミス ユーザーが含まれます。 有効な値は次のとおりです。

  • $true: Exchange の場所パラメーターのいずれかで指定されたユーザーのクラウドベースのストレージの場所が検索に含まれます。 ExchangeLocation パラメーターの値 All を使用すると、任意のゲストまたはオンプレミス ユーザーのクラウドベースのストレージの場所が検索に含まれます。
  • $false: ExchangeLocation パラメーターで指定されたユーザーのクラウドベースのストレージの場所は、検索に含まれません。 これは既定の値です。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Language

Language パラメーターは、コンプライアンス検索の言語を指定します。

このパラメーターの正しい入力は、Microsoft .NET Framework CultureInfo クラスでサポートされているカルチャ コード値です。 たとえば、デンマーク語の場合には da-DK、日本語の場合には ja-JP となります。 詳細については、「CultureInfo クラス」を参照してください。

Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Name

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-PublicFolderLocation

このパラメーターは、クラウドベースのサービスでのみ使用できます。

PublicFolderLocation パラメーターは、すべてのパブリック フォルダーを検索に含めることを指定します。 このパラメーターに値 All を使用します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RefinerNames

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveExchangeLocation

RemoveExchangeLocation パラメーターは、ExchangeLocation パラメーターの値 All を使用していない場合に含まれるメールボックスの一覧から削除するメールボックスを指定します。 有効な値は次のとおりです。

  • このパラメーターは、ExchangeLocation パラメーターに値 All を使用するときに、除外する一覧から削除するメールボックスを指定します。有効な値は次のとおりです。
  • メールボックス。

メールボックスまたは配布グループを指定するには、メール アドレスを使用します。 複数の値をコンマで区切って指定できます。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-RemoveExchangeLocationExclusion

このパラメーターは、オンプレミスの Exchange でのみ使用可能で正常に機能します。

このパラメーターは、ExchangeLocation パラメーターの値 All を使用するときに、除外されたメールボックスの一覧から削除するメールボックスを指定します。 有効な値は次のとおりです。

  • このパラメーターは、ExchangeLocation パラメーターに値 All を使用するときに、除外する一覧から削除するメールボックスを指定します。有効な値は次のとおりです。
  • メールボックス。

メールボックスまたは配布グループを指定するには、メール アドレスを使用します。 複数の値をコンマで区切って指定できます。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-RemovePublicFolderLocation

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocation

このパラメーターは、クラウドベースのサービスでのみ使用できます。

RemoveSharePointLocation パラメーターは、SharePointLocation パラメーターの値 All を使用していない場合に含まれるサイトの一覧から削除する SharePoint Online サイトを指定します。 サイトは URL 値で指定します。

Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocationExclusion

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SharePointLocation

このパラメーターは、クラウドベースのサービスでのみ使用できます。

SharePointLocation パラメーターは、含める SharePoint Online サイトを指定します。 サイトを URL 値で指定することも、値 All を使用してすべてのサイトを含めることもできます。

Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SharePointLocationExclusion

このパラメーターは、クラウドベースのサービスでのみ使用できます。

このパラメーターは、Microsoft の内部使用のために予約されています。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-WhatIf

WhatIf スイッチは、セキュリティ & コンプライアンス PowerShell では機能しません。

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance