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

В этом примере извлекается первая страница элементов, ожидающих ликвидации метки с неизменяемым значением 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

В этом примере извлекаются все удаленные элементы для метки с неизменяемым идентификатором 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

В этом примере извлекаются все элементы, ожидающие ликвидации метки с неизменяемым значением 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. Заголовки возвращаются как свойство с элементами проверки. Этот параметр полезен при преобразовании выходных данных в PSObject в PowerShell или при экспорте в 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 указывает метку, для которой требуется извлечь элементы проверки. Допустимым значением для этого параметра является неизменяемый идентификатор метки.

Чтобы получить неизменяемое значение идентификатора метки, замените <RetentionLabelName> именем метки, а затем выполните следующую команду в Exchange Online PowerShell: 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

Поделиться через