Get-ReviewItems

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

Get-ReviewItems を使用して、レビューが保留されているか、特定の保持ラベルに対して既に廃棄されている廃棄レビュー アイテムのリストを取得します。 また、特定のレコード レーベルの廃棄されたアイテムのリストを取得するためにも使用できます。

このコマンドレットは、Mailbox Import Export 役割でのみ使用でき、既定では、この役割はどの役割グループにも割り当てられていません。 このコマンドレットを使用するには、Mailbox Import Export 役割を役割グループ (たとえば、Organization Management 役割グループ) に追加する必要があります。 詳細については、「役割グループへ役割を追加する」を参照してください。

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

構文

Default (既定)

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

適用対象: Exchange Online

Disposed パラメーターは、棄棄保留中のアイテムではなく破棄されたアイテムを返すかどうかを指定します。 有効な値は次のとおりです。

  • $true: 廃棄されたアイテムを返します。
  • $false: 保留中の破棄アイテムを返します。 この値が既定値です。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IncludeHeaders

適用対象: Exchange Online

IncludeHeaders パラメーターは、レビュー項目のプロパティとしてヘッダーを返すかどうかを指定します。 有効な値は次のとおりです。

  • $true: ヘッダーは、レビュー項目と共にプロパティとして返されます。 このオプションは、PowerShell で出力を PSObject に変換する場合、または CSV にエクスポートする場合に便利です。
  • $false: ヘッダーは、レビュー項目と共にプロパティとして返されません。 この値が既定値です。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PagingCookie

適用対象: Exchange Online

PagingCookie パラメーターは、取得するページを識別します。 このパラメーターは、次の場合に役立ちます。

  • 多数のアイテムを取得する際にスロットリングを回避するには。
  • 最後の操作が中断されたところから開始する方法として。

PagingCookie 値は、コマンドレットが正常に実行されるたびに PaginationCookie プロパティで返されます。 PaginationCookie が空白 (null) の場合、取得するアイテムはありません。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TargetLabelId

適用対象: Exchange Online

TargetLabelId パラメーターは、レビュー アイテムを取得するラベルを指定します。 このパラメーターの有効な値は、ラベルの不変 ID です。

ラベルの不変 ID 値を取得するには、<RetentionLabelName> をラベルの名前に置き換え、PowerShell で次のコマンドExchange Online実行します: Get-ComplianceTag -Identity "<RetentionLabelName>" | select ImmutableId。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。