Get-ReviewItems

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Online

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

Get-ReviewItemsを使用して、保留中のレビューまたは特定の保持ラベルに対して既に破棄されている廃棄レビュー項目の一覧を取得します。また、特定のレコードラベルの破棄された項目の一覧を取得するためにも使用できます。

このコマンドレットはメールボックスインポートエクスポートロールでのみ使用でき、既定ではロールはどの役割グループにも割り当てられません。このコマンドレットを使用するには、役割グループ (組織の管理役割グループなど) にメールボックスインポートエクスポートロールを追加する必要があります。詳細については、「役割グループへ役割を追加する」を参照してください。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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

説明

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange 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 ファイルにエクスポートされます。

注: コマンドレットは、取得できる項目/ページ数に制限を課しませんが、他の調整が発生する可能性があります。多数の項目を取得するときに調整を防ぐために、スクリプトに中断を含めることをお勧めします。 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 値は、コマンドレットが正常に実行されるたびに 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 を>ラベルの名前に置き換え<、PowerShell で次のコマンドExchange Online実行します。 Get-ComplianceTag -Identity "<RetentionLabelName>" | select ImmutableId

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