New-ComplianceSearch
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
New-ComplianceSearch コマンドレットを使用して、Exchange Server 2016 以降およびMicrosoft Purview コンプライアンス ポータルでコンプライアンス検索を作成します。 このコマンドレットを使用して検索条件を定義します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
New-ComplianceSearch
[-Name] <String>
[-AllowNotFoundExchangeLocationsEnabled <Boolean>]
[-Case <String>]
[-Confirm]
[-ContentMatchQuery <String>]
[-Description <String>]
[-ExchangeLocation <String[]>]
[-ExchangeLocationExclusion <String[]>]
[-Force]
[-HoldNames <String[]>]
[-IncludeOrgContent <Boolean>]
[-IncludeUserAppContent <Boolean>]
[-Language <CultureInfo>]
[-LogLevel <ComplianceJobLogLevel>]
[-PublicFolderLocation <String[]>]
[-RefinerNames <String[]>]
[-SharePointLocation <String[]>]
[-SharePointLocationExclusion <String[]>]
[-StatusMailRecipients <String[]>]
[-WhatIf]
[<CommonParameters>] 説明
コンプライアンス検索では、少なくとも 1 つの場所が必要です。 たとえば、ExchangeLocation パラメーターを使用するメールボックス、SharePointLocation パラメーターを使用した SharePoint サイトなどです。
New-ComplianceSearch コマンドレットを使用してコンプライアンス検索を作成した後で、Start-ComplianceSearch コマンドレットを使用して検査を実行します。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
オンプレミスの Exchange では、このコマンドレットはメールボックス検索ロールで使用できます。 既定では、このロールは Discovery Management ロール グループにのみ割り当てられます。
セキュリティ & コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可を割り当てる必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。
例
例 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 パラメーターを含めて、検索が非アクティブなメールボックスの存在を検証しないようにする必要もあります。
パラメーター
-AllowNotFoundExchangeLocationsEnabled
AllowNotFoundExchangeLocationsEnabled パラメーターは、コンプライアンス検索に通常のユーザー メールボックス以外のメールボックスを含めるかどうかを指定します。 有効な値は次のとおりです。
- $true: 検索では、先に進む前にメールボックスの存在を検証しようとしません。 この値は、通常のメールボックスとして解決されないメールボックスを検索する場合に必要です。
- $true: 検索の際、続行する前にメールボックスの存在を検証しません。 通常のユーザー メールボックスではないメールボックスを指定した場合、検索は失敗します。 これは既定の値です。
このパラメーターの値の影響を受けるメールボックスの種類は次のとおりです。
- 非アクティブなメールボックス
- Office アプリケーションを使用するExchange Online ライセンスを持たないユーザー
- Microsoft 365 人のゲスト ユーザー
- 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 |
-Case
このパラメーターは、クラウドベースのサービスでのみ使用できます。
Case パラメーターは、新しいコンプライアンス検索を関連付ける電子情報開示標準ケースの名前を指定します。 値にスペースが含まれている場合は、値を引用符で囲んでください。
このパラメーターを使用して、電子情報開示 Premium ケースに関連付けられたコンプライアンス検索を作成することはできません。
Name パラメーターにスペースが含まれている場合、Case パラメーターを使用すると ExchangeLocation パラメーターの値がクリアされます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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。 この値は単体でのみ使用できます。
メールボックスまたは配布グループを指定するには、メール アドレスを使用します。 複数の値をコンマで区切って指定できます。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-ExchangeLocationExclusion
このパラメーターは、オンプレミスの Exchange でのみ使用可能で正常に機能します。
このパラメーターは、ExchangeLocation パラメーターの値 All を使用するときに除外するメールボックスを指定します。 有効な値は次のとおりです。
- ExchangeLocation パラメーターは、ポリシーに含めるメールボックスを指定します。有効な値は次のとおりです。
- メールボックス。
メールボックスまたは配布グループを指定するには、メール アドレスを使用します。 複数の値をコンマで区切って指定できます。
| 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 を使用します。 Case パラメーターを使用して、電子情報開示ケースの名前を指定する必要もあります。
また、コンテンツの場所がクエリベースのケースで保持リストにある場合、このコンプライアンス検索を実行すると、保持リストにあるアイテムだけが検索されます。 たとえば、ユーザーがクエリベースのケースで保持リストに入れられていて、特定の日付以前に送信または作成されたアイテムが保存される場合には、それらのアイテムだけがこのコンプライアンス検索で指定された検索条件を使用して検索されます。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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: ExchangeLocation パラメーターで指定されたユーザーのクラウドベースのストレージの場所が検索に含まれます。 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 |
-LogLevel
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | ComplianceJobLogLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Name
Name パラメーターは、コンプライアンス検索の名前を指定します。 値にスペースが含まれている場合は、値を引用符で囲んでください。
Case パラメーターの使用を計画している場合は、このパラメーターの値にスペースを使用しないでください。 Name パラメーターにスペースが含まれている場合、Case パラメーターを使用すると ExchangeLocation パラメーターの値がクリアされます。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| 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 |
-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 |
-StatusMailRecipients
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
このパラメーターは、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 |
-WhatIf
このパラメーターは、Microsoft の内部使用のために予約されています。
| 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 |