Get-ComplianceSearchAction
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 |