Get-ComplianceSearch
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターと設定は、1 つの環境または他の環境に限定される場合があります。
Get-ComplianceSearch コマンドレットを使用して、Exchange Server 2016 以降およびMicrosoft Purview コンプライアンス ポータルの推定コンプライアンス検索を表示します。 New-ComplianceSearchAction コマンドレットを使用してコンプライアンス検索のプレビュー アクションを定義した後で、Get-ComplianceSearchAction コマンドレットを使用して、コンプライアンス検索の結果を表示します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-ComplianceSearch
[[-Identity] <ComplianceSearchIdParameter>]
[-Case <String>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
オンプレミスの Exchange では、このコマンドレットはメールボックス検索ロールで使用できます。 既定では、このロールは Discovery Management ロール グループにのみ割り当てられます。
セキュリティ/コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可が割り当てられている必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。
例
例 1
Get-ComplianceSearch
この例では、すべてのコンプライアンス検索の要約リストを示します。
例 2
Get-ComplianceSearch -Identity "Case 1234" | Format-List
この例では、Case 1234 という名前のコンプライアンス検索の詳細を表示します。
パラメーター
-Case
適用対象: セキュリティ & コンプライアンス
このパラメーターは、クラウドベースのサービスでのみ使用できます。
Case パラメーターは、コンプライアンス検索が関連付けられている電子情報開示Standardケースの名前で結果をフィルター処理します。 値にスペースが含まれている場合は、値を引用符で囲んでください。
このパラメーターを使用して、電子情報開示 Premium ケースに関連付けられているコンプライアンス検索を表示することはできません。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、セキュリティ & コンプライアンス
Identity パラメーターは、表示するコンプライアンス検索を指定します。
このパラメーターを使用する場合、Identity パラメーターは必要ですが、値は無視されます。 たとえば、Identity パラメーターに 000 の値を使用します。
- Name
- JobRunId (GUID)
JobRunId (GUID)
コンプライアンス検索の ID を指定しなかった場合は、このコマンドレットのパフォーマンスを向上させるために、一部のコンプライアンス検索プロパティが返されません。 そのプロパティは次のとおりです。
- アイテム
- Size
- SuccessResults
- NumBindings
- ExchangeLocation
- SharePointLocation
- OneDriveLocation
これらのプロパティを表示するには、コマンドで Identity パラメーターを使用する必要があります。
注: NumBindings プロパティには、プライマリ メールボックス、メイン アーカイブ、および検索に含まれるユーザーの追加アーカイブが含まれます。 NumBindings は検索に含まれるユーザーの数ではありません。含まれる各ユーザーは、プライマリ メールボックス、メイン アーカイブ、および追加のアーカイブの組み合わせを持っている場合と組み合わせられない可能性があるためです。
注意: Identity パラメーターの値$null値または存在しない値は、Identity パラメーターなしで Get- コマンドを実行したかのように 、すべての オブジェクトを返します。 Identity パラメーターの値の一覧が正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | ComplianceSearchIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ResultSize
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、セキュリティ & コンプライアンス
ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。