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」を参照してください。