Get-ComplianceSearch
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
Get-ComplianceSearch コマンドレットを使用して、Exchange Server 2016 以降およびMicrosoft Purview コンプライアンス ポータルの推定コンプライアンス検索を表示します。 New-ComplianceSearchAction コマンドレットを使用してコンプライアンス検索のプレビュー アクションを定義した後で、Get-ComplianceSearchAction コマンドレットを使用して、コンプライアンス検索の結果を表示します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
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 パラメーターは、コンプライアンス検索が関連付けられている電子情報開示標準ケースの名前で結果をフィルター処理します。 値にスペースが含まれている場合は、値を引用符で囲んでください。
このパラメーターを使用して、電子情報開示 Premium ケースに関連付けられているコンプライアンス検索を表示することはできません。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-DomainController
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity パラメーターは、表示するコンプライアンス検索を指定します。
このパラメーターを使用する場合、Identity パラメーターは必要ですが、値は無視されます。 たとえば、Identity パラメーターに 000 の値を使用します。
- 名前
- JobRunId (GUID)
JobRunId (GUID)
コンプライアンス検索の ID を指定しなかった場合は、このコマンドレットのパフォーマンスを向上させるために、一部のコンプライアンス検索プロパティが返されません。 そのプロパティは次のとおりです。
- アイテム
- Size
- SuccessResults
- NumBindings
- ExchangeLocation
- SharePointLocation
- OneDriveLocation
これらのプロパティを表示するには、コマンドで Identity パラメーターを使用する必要があります。
Type: | ComplianceSearchIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-ResultSize
ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。
Type: | Unlimited |
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 |