New-ComplianceSearch

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

New-compliancesearch コマンドレットを使用して、Exchange Server 2016 および Office 365 セキュリティ & コンプライアンスセンターでコンプライアンス検索を作成します。 このコマンドレットを使用して検索条件を定義します。

以下の構文セクションのパラメーター セットの詳細については、「 Exchangeのコマンドレット構文 (https://docs.microsoft.com/powershell/exchange/exchange-server/exchange-cmdlet-syntax)」を参照してください。

Syntax

New-ComplianceSearch
   [-Name] <String>
   [-AllowNotFoundExchangeLocationsEnabled <Boolean>]
   [-Case <String>]
   [-Confirm]
   [-ContentMatchQuery <String>]
   [-Description <String>]
   [-ExchangeLocation <String[]>]
   [-ExchangeLocationExclusion <String[]>]
   [-Force]
   [-HoldNames <String[]>]
   [-IncludeUserAppContent <Boolean>]
   [-Language <CultureInfo>]
   [-LogLevel <ComplianceJobLogLevel>]
   [-OneDriveLocation <String[]>]
   [-OneDriveLocationExclusion <String[]>]
   [-PublicFolderLocation <String[]>]
   [-PublicFolderLocationExclusion <String[]>]
   [-RefinerNames <String[]>]
   [-SearchNames <String[]>]
   [-SharePointLocation <String[]>]
   [-SharePointLocationExclusion <String[]>]
   [-StatusMailRecipients <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

コンプライアンス検索では、少なくとも 1 つの場所が必要です。 たとえば、ExchangeLocation パラメーターを使用するメールボックス、または SharePointLocation パラメーターを使用して SharePoint サイトを指定します。

New-ComplianceSearch コマンドレットを使用してコンプライアンス検索を作成した後で、Start-ComplianceSearch コマンドレットを使用して検査を実行します。

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

このコマンドレットは、メールボックス検索の役割で使用できます。既定では、この役割は証拠開示管理の役割グループにのみ割り当てられ、Organization Management 役割グループには割り当てられません。

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

Examples

例 1

New-ComplianceSearch -Name "Hold Project X" -ExchangeLocation "Finance Department"

この例では、Finance Department という名前の配布グループのすべてのメンバーを検索する、Hold-Project X という名前の新しいコンプライアンス検索を作成します。 検索は ContentMatchQuery パラメーターを使用しないので、メールボックス内のすべてのアイテムが検索されます。

例 2

New-ComplianceSearch -Name "Hold-Tailspin Toys" -ExchangeLocation "Research Department" -ContentMatchQuery "'Patent' AND 'Project Tailspin Toys'"

この例では、Research Department という名前の配布グループのすべてのメンバーを検索する、Hold-Tailspin Toys という名前の新しいコンプライアンス検索を作成します。 検索は ContentMatchQuery パラメーターを使用するので、クエリに一致するメッセージのみが検索されます。

例 3

New-ComplianceSearch -Name "AnnBeebe-InactiveMailbox" -ExchangeLocation .annb@contoso.onmicrosoft.com -AllowNotFoundExchangeLocationsEnabled $true

この例では、非アクティブなメールボックスを検索し、メールボックス内のすべての項目を返す AnnBeebe-InactiveMailbox という新しいコンプライアンス検索を作成します。 非アクティブなメールボックスを検索するには、ピリオド (".") が先頭に追加された、非アクティブなメールボックスのプライマリ SMTP アドレスを使用する必要があります。 また、検索で非アクティブなメールボックスの存在を確認しないように、AllowNotFoundExchangeLocationsEnabled パラメーターを含める必要があります。

Parameters

-AllowNotFoundExchangeLocationsEnabled

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

  • $true: 検索では、続行する前にメールボックスが存在するかどうかの検証は試行されません。 この値は、通常のメールボックスとして解決されないメールボックスを検索する場合に必要です。

  • $true: 検索の際、続行する前にメールボックスの存在を検証しません。 通常のユーザーメールボックスではないメールボックスを指定すると、検索は失敗します。 これは既定の値です。

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

  • 非アクティブなメールボックス

  • Office アプリケーションを使用する Exchange Online ライセンスを持たないユーザー

  • Office 365 ゲストユーザー

  • Id が Office 365 組織と同期されているオンプレミスのユーザー

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Office 365 Security & Compliance Center
-Confirm

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

  • データを破壊するコマンドレット (たとえば、Remove-* コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、この構文 (-Confirm:$false) を正しくを使用すると確認のメッセージを省略できます。

  • 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Office 365 Security & Compliance Center
-ContentMatchQuery

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

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

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

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

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

  • メールボックス。

  • すべてのメールボックスの値。 この値は単体でのみ使用できます。

メールボックスまたは配布グループを指定するには、電子メールアドレスを使用します。 SPO: exSharePointOnline2ndMen

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Office 365 Security & Compliance Center
-ExchangeLocationExclusion

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

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

  • メールボックス。

メールボックスまたは配布グループを指定するには、電子メールアドレスを使用します。 SPO: exSharePointOnline2ndMen

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

Force スイッチは、警告や確認のメッセージを抑制するかどうかを指定します。 管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。 このスイッチで値を指定する必要はありません。

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

HoldNames パラメーターは、指定した電子情報開示ケースで保持リストにあるコンテンツの場所を検索することを指定します。 このパラメーターに値 All を使用します。 Case パラメーターを使用して、電子情報開示ケースの名前を指定する必要もあります。

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

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

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

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

  • $true: ExchangeLocation パラメーターで指定したユーザーのクラウドベースのストレージの場所が検索に含まれます。 ExchangeLocation パラメーターに値 All を使用すると、ゲストまたは社内ユーザーのクラウドベースの保存場所が検索に含まれます。

  • $false: ExchangeLocation パラメーターで指定されたユーザーのクラウドベースのストレージの場所は、検索に含まれません。 これは既定の値です。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Office 365 Security & Compliance Center
-LogLevel

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

Type:ComplianceJobLogLevel
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Office 365 Security & Compliance Center
-Name

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

Case パラメーターの使用を計画する場合は、このパラメーターの値にスペースを使用しないでください。 Name パラメーターにスペースが含まれている場合は、Case パラメーターを使用すると ExchangeLocation パラメーターの値がクリアされます。

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Office 365 Security & Compliance Center
-OneDriveLocationExclusion

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

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Office 365 Security & Compliance Center
-Onedrive の場所

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

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

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

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

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

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

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

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

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

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

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

複数の値を入力するには、次<の>構文<を>使用します。 value1、value2,...<valuex> 値にスペースが含まれている場合や、それ以外の場合は引用符<が>必要な場合<は>、次の<構文を>使用します。 "value1"、"value2",... "valuex"。

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

このパラメーターは、SharePointLocation パラメーターに値 All を使用する場合に、除外する SharePoint Online サイトを指定します。 サイトは URL 値で指定します。

複数の値を入力するには、次<の>構文<を>使用します。 value1、value2,...<valuex> 値にスペースが含まれている場合や、それ以外の場合は引用符<が>必要な場合<は>、次の<構文を>使用します。 "value1"、"value2",... "valuex"。

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

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

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

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Office 365 Security & Compliance Center
-ケース

Case パラメーターは、新しいコンプライアンス検索が関連付けられる電子情報開示ケースの名前を指定します。 値にスペースが含まれている場合は、値を引用符で囲んでください。

Name パラメーターにスペースが含まれている場合は、Case パラメーターを使用すると ExchangeLocation パラメーターの値がクリアされます。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Office 365 Security & Compliance Center
-言語

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

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

Type:CultureInfo
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Office 365 Security & Compliance Center
-説明

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

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

Inputs

Outputs