Get-ComplianceSearchAction
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
Get-ComplianceSearchAction コマンドレットを使用して、コンプライアンス検索アクションに関する情報を表示します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Get-ComplianceSearchAction
[[-Identity] <ComplianceSearchActionIdParameter>]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-ComplianceSearchAction
[-Preview]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-ComplianceSearchAction
[-Purge]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-ComplianceSearchAction
[-Export]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>] 説明
New-ComplianceSearch コマンドレットを使用してコンプライアンス検索を作成して実行し、Start-ComplianceSearch コマンドレットを使用して検索を開始したら、New-ComplianceSearchAction コマンドレットを使用して検索アクションを割り当てます。 Get-ComplianceSearchAction コマンドレットを使用して、コンプライアンス検索アクションの進行状況を追跡します。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
オンプレミスの Exchange では、このコマンドレットはメールボックス検索ロールで使用できます。 既定では、このロールは Discovery Management ロール グループにのみ割り当てられます。
セキュリティ & コンプライアンス PowerShell でこのコマンドレットを使用するには、アクセス許可を割り当てる必要があります。 詳細については、「Microsoft Purview コンプライアンス センターのアクセス許可」 を参照してください。
例
例 1
Get-ComplianceSearchActionこの例では、すべてのコンプライアンス検索アクションの概要リストを示します。
例 2
Get-ComplianceSearchAction -Identity "Case 1234_Preview" | Format-Listこの例では、"Case 1234_Preview" という名前のコンプライアンス検索アクションの詳細を示します
パラメーター
-Case
このパラメーターは、クラウドベースのサービスでのみ使用できます。
Case パラメーターは、指定したケースの名前で結果をフィルター処理します。 値にスペースが含まれている場合は、値を引用符で囲んでください。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Details
[詳細] スイッチは、結果に詳細情報を含めるかどうかを指定します。 このスイッチで値を指定する必要はありません。
| 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 |
-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 |
-Export
[エクスポート] スイッチは、コンプライアンス検索アクションのエクスポートによって結果をフィルター処理します。 このスイッチで値を指定する必要はありません。
ID、プレビュー、または消去パラメーターでは、このスイッチを使用できません。
| 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 |
-Identity
Identity パラメーターは、表示するコンプライアンス検索アクションを指定します。 コンプライアンス検索アクションを一意に識別する任意の値を使用できます。 例:
- 名前: コンプライアンス検索アクション名では、 構文
"Compliance Search Name_Action"が使用されます。 たとえば、「"Case 1234_Preview"」のように入力します。 - JobRunId (GUID)
このパラメーターは、エクスポート、プレビュー、または消去パラメーターでは使用できません。
Identity パラメーターを使用すると、結果に詳細が返されます。 例:
- [結果] 行には、Item count、Total size、Details プロパティの値が設定されます。
- 場所の行が結果に追加されます。
- NumBinding プロパティの値が設定されます。
- 影響を受ける場所のプロパティ (ExchangeLocation など) が設定されます。
- CaseName プロパティの値が設定されます。
| Type: | ComplianceSearchActionIdParameter |
| 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 |
-IncludeCredential
IncludeCredential スイッチは、結果に資格情報を含めるかどうかを指定します。 このスイッチで値を指定する必要はありません。
| 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 |
-Preview
プレビュー スイッチは、プレビュー コンプライアンス検索アクションによって結果をフィルター処理します。 このスイッチで値を指定する必要はありません。
このスイッチは、エクスポート、ID、または消去の各パラメーターでは使用できません。
| 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 |
-Purge
注: セキュリティ & コンプライアンス PowerShell では、このパラメーターは検索および消去ロールでのみ使用できます。 既定では、このロールは組織の管理ロール グループとデータ調査担当者ロール グループにのみ割り当てられます。
[消去] スイッチは、コンプライアンス検索アクションの消去によって結果をフィルター処理します。 このスイッチで値を指定する必要はありません。
エクスポート、ID、またはプレビュー パラメーターでは、このスイッチを使用できません。
| 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 |
-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 |