Get-ComplianceSearchAction

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Server 2016, Exchange Server 2019, Security & Compliance

cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.

Get-ComplianceSearchAction cmdlet을 사용하여 규정 준수 검색 작업에 대한 정보를 볼 수 있습니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

Syntax

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>]

Description

New-ComplianceSearch cmdlet을 사용하여 규정 준수 검색을 만들고 실행하고 Start-ComplianceSearch cmdlet을 사용하여 검색을 시작한 후에는 New-ComplianceSearchAction cmdlet을 사용하여 검색 작업을 할당합니다. Get-ComplianceSearchAction cmdlet을 사용하여 규정 준수 검색 작업의 진행률을 추적합니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

온-프레미스 Exchange에서 이 cmdlet은 사서함 검색 역할에서 사용할 수 있습니다. 기본적으로 이 역할은 검색 관리 역할 그룹에만 할당됩니다.

보안 & 준수 PowerShell에서 이 cmdlet을 사용하려면 권한이 할당되어야 합니다. 자세한 내용은 Microsoft Purview 규정 준수 포털의 사용 권한을 참조하세요.

예제

예 1

Get-ComplianceSearchAction

이 예제에서는 모든 준수 검색 작업의 요약 목록을 보여 줍니다.

예 2

Get-ComplianceSearchAction -Identity "Case 1234_Preview" | Format-List

이 예제에서는 "사례 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에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. 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 매개 변수를 사용하면 결과에 자세한 내용이 반환됩니다. 예를 들면

결과 줄에서 항목 수, 총 크기 및 세부 정보 속성의 값이 채워집니다.
결과에 위치 줄이 추가됩니다.
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