Get-ReviewItems

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Online

이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.

Get-ReviewItems 사용하여 검토 보류 중이거나 특정 보존 레이블에 대해 이미 삭제된 처리 검토 항목 목록을 검색합니다. 특정 레코드 레이블에 대해 삭제된 항목 목록을 검색하는 데 사용할 수도 있습니다.

이 cmdlet은 사서함 가져오기 내보내기 역할에서만 사용할 수 있으며 기본적으로 역할은 역할 그룹에 할당되지 않습니다. 이러한 cmdlet을 사용하려면 역할 그룹(예: Organization Management 역할 그룹)에 사서함 가져오기 내보내기 역할을 추가해야 합니다. 자세한 내용은 역할 그룹에 역할 추가를 참조하세요.

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

Syntax

Get-ReviewItems
   -TargetLabelId <String>
   [-Disposed <Boolean>]
   [-IncludeHeaders <Boolean>]
   [-PagingCookie <String>]
   [<CommonParameters>]

Description

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

cmdlet을 Get-ReviewItems 사용하여 처리 검토에서 보류 중 또는 삭제된 항목 목록을 내보낼 수 있습니다. 처리 검토에 대한 자세한 내용은 콘텐츠 처리를 참조하세요.

예제

예 1

$itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true

$formattedExportItems = $itemsPendingDisposition.ExportItems | ConvertFrom-Csv -Header $itemsPendingDisposition.Headers

$formattedExportItems

다음은 변경할 수 없는 ID 값 a8cbeaac-e7aa-42ed-8dba-54200537c9c9이 인 레이블에 대한 처리 보류 중인 항목의 첫 번째 페이지를 검색하는 예제입니다. 결과는 각 항목에 대한 PSObject 형식으로 변환된 다음 화면에 출력됩니다.

예 2

$itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true -Disposed $true

$formattedExportItems = $itemsPendingDisposition.ExportItems | ConvertFrom-Csv -Header $itemsPendingDisposition.Headers

$formattedExportItems | Select Subject,Location,ReviewAction,Comment,DeletedBy,DeletedDate

다음은 변경할 수 없는 ID a8cbeaac-e7aa-42ed-8dba-54200537c9c9 가 인 레이블에 대해 삭제된 모든 항목을 검색하고 화면에 출력할 특정 열을 선택하는 예제입니다.

예 3

$itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true

$exportItems = $itemsPendingDisposition.ExportItems

While (![string]::IsNullOrEmpty($itemsPendingDisposition.PaginationCookie))
{
    $itemsPendingDisposition = Get-ReviewItems -TargetLabelId a8cbeaac-e7aa-42ed-8dba-54200537c9c9 -IncludeHeaders $true -PagingCookie $itemsPendingDisposition.PaginationCookie
    $exportItems += $itemsPendingDisposition.ExportItems
}

$exportItems | ConvertFrom-Csv -Header $itemsPendingDisposition.Headers | Export-Csv C:\temp\ItemsPendingDisposition.csv -NoTypeInformation

다음은 변경할 수 없는 ID 값을 a8cbeaac-e7aa-42ed-8dba-54200537c9c9사용하여 레이블에 대해 처리 보류 중인 모든 항목을 검색하는 예제입니다. 항목의 페이지가 여러 개 있는 경우 명령은 더 이상 페이지가 없을 때까지 계속됩니다. 결과는 지정된 CSV 파일로 내보내집니다.

참고: cmdlet은 검색할 수 있는 항목/페이지 수에 제한을 두지 않지만 다른 제한이 발생할 수 있습니다. 많은 수의 항목을 검색하는 동안 제한을 방지하려면 스크립트에 중단을 포함하는 것이 좋습니다. PagingCookie 매개 변수를 사용하여 중단 후 스크립트가 중단된 위치를 선택할 수 있습니다.

매개 변수

-Disposed

Disposed 매개 변수는 처리 보류 중인 항목 대신 삭제된 항목을 반환할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 삭제된 항목을 반환합니다.
$false: 처리 보류 중인 항목을 반환합니다. 이 값은 기본값입니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-IncludeHeaders

IncludeHeaders 매개 변수는 헤더가 검토 항목이 있는 속성으로 반환되는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$true: 헤더는 검토 항목이 있는 속성으로 반환됩니다. 이 옵션은 출력을 PowerShell에서 PSObject로 변환하거나 CSV로 내보낼 때 유용합니다.
$false: 헤더는 검토 항목이 있는 속성으로 반환되지 않습니다. 이 값은 기본값입니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-PagingCookie

PagingCookie 매개 변수는 검색할 페이지를 식별합니다. 이 매개 변수는 다음 시나리오에서 유용합니다.

많은 수의 항목을 검색하는 동안 제한을 방지합니다.
마지막 작업이 중단된 위치를 시작하는 메서드입니다.

PagingCookie 값은 cmdlet이 성공적으로 실행될 때마다 PaginationCookie 속성에 반환됩니다. PaginationCookie가 비어 있는 경우(null) 검색할 항목이 더 이상 없습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-TargetLabelId

TargetLabelId 매개 변수는 검토 항목을 검색할 레이블을 지정합니다. 이 매개 변수의 유효한 값은 레이블의 변경할 수 없는 ID입니다.

레이블<의 변경할 수 없는 ID 값을 가져오려면 RetentionLabelName>을 레이블 이름으로 바꾼 다음 powerShellGet-ComplianceTag -Identity "<RetentionLabelName>" | select ImmutableId에서 Exchange Online 명령을 실행합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online