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

Get-RecoverableItems

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Server 2016, Exchange Server 2019, Exchange Online

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет Get-RecoverableItems items для просмотра удаленных элементов в почтовых ящиках. Для восстановления удаленных элементов используйте командлет Restore-RecoverableItems.

Этот командлет доступен только в роли экспорта импорта почтовых ящиков, и по умолчанию роль не назначается ни одной группе ролей. Чтобы использовать этот командлет, добавьте роль "Импорт и экспорт почтового ящика" в группу ролей (например, в группу ролей "Управление организацией"). Подробнее см. в разделе Добавление роли в группу ролей.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Get-RecoverableItems
   -Identity <GeneralMailboxOrMailUserIdParameter>
   [-EntryID <String>]
   [-FilterEndTime <DateTime>]
   [-FilterItemType <String>]
   [-FilterStartTime <DateTime>]
   [-LastParentFolderID <String>]
   [-ResultSize <Unlimited>]
   [-SourceFolder <RecoverableItemsFolderType>]
   [-SubjectContains <String>]
   [<CommonParameters>]
Get-RecoverableItems
   -Identity <GeneralMailboxOrMailUserIdParameter[]>
   [-EntryID <String>]
   [-FilterEndTime <DateTime>]
   [-FilterItemType <String>]
   [-FilterStartTime <DateTime>]
   [-LastParentFolderID <String>]
   [-MaxParallelSize <Int32>]
   [-PolicyTag <String[]>]
   [-ResultSize <Unlimited>]
   [-SourceFolder <RecoverableItemsFolderType>]
   [-SubjectContains <String>]
   [<CommonParameters>]

Описание

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-RecoverableItems -Identity laura@contoso.com -SubjectContains "FY17 Accounting" -FilterItemType IPM.Note -FilterStartTime "2/1/2018 12:00:00 AM" -FilterEndTime "2/5/2018 11:59:59 PM"

В этом примере возвращаются все доступные для восстановления удаленные сообщения с указанной темой в почтовом ящике laura@contoso.com для указанного диапазона даты и времени.

Пример 2

Get-RecoverableItems -Identity "malik@contoso.com", "lillian@contoso.com" -FilterItemType IPM.Note -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM"

В этом примере возвращаются все доступные для восстановления удаленные сообщения с указанной темой в почтовых ящиках и malik@contoso.com для указанного диапазона даты и lillian@contoso.com времени.

Параметры

-EntryID

Параметр EntryID указывает удаленный элемент, который требуется восстановить. Значение EntryID для удаленного элемента уникально в почтовом ящике.

Идентификатор entryID для определенных элементов можно найти с помощью других фильтров поиска в командлете Get-RecoverableItems (тема, диапазон дат и т. д.).

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

-FilterEndTime

FilterEndTime указывает дату и время конечного диапазона дат. Этот параметр использует значение LastModifiedTime элемента.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterItemType

Параметр FilterItemType фильтрует результаты по указанному значению свойства MessageClass (ItemClass) удаленного элемента. Например:

  • IPM.Appointment (собрания и встречи)
  • IPM.Contact
  • IPM. Файл
  • IPM.Note
  • IPM.Task
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-FilterStartTime

ФильтрStartTime указывает начальную дату и время диапазона дат. Этот параметр использует значение LastModifiedTime элемента.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Параметр Identity указывает почтовый ящик, содержащий удаленные элементы, которые требуется просмотреть. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя

В Exchange Online можно указать несколько почтовых ящиков, разделенных запятыми. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Type:GeneralMailboxOrMailUserIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-LastParentFolderID

Параметр LastParentFolderID указывает значение FolderID элемента перед удалением. Пример: 53B93149989CA54DBC9702AE619B9CCA000062CE9397.

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

-MaxParallelSize

Этот параметр доступен только в облачной службе.

Параметр MaxParallelSize указывает максимальное число почтовых ящиков, обрабатываемых командой параллельно. Допустимым значением является целое число от 1 до 10. Как правило, более высокое значение уменьшает время, затраченное на выполнение команды в нескольких почтовых ящиках.

Значение этого параметра не влияет, если параметр Identity указывает только один почтовый ящик.

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

-PolicyTag

Этот параметр доступен только в облачной службе.

{{ Fill PolicyTag Description }}

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

-ResultSize

Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceFolder

Параметр SourceFolder указывает, где искать удаленные элементы в почтовом ящике. Допустимые значения:

  • DeletedItems. Папка "Удаленные".

  • RecoverableItems: папка Recoverable Items\Deletions. Эта папка содержит элементы, которые были удалены из папки "Удаленные" (обратимо удаленные элементы).

  • PurgedItems: папка Recoverable Items\Purges. Эта папка содержит элементы, которые были очищены из папки "Элементы с возможностью восстановления" (жестко удаленные элементы).

    Если этот параметр не используется, команда выполнит поиск по этим трем папкам.

  • DiscoveryHoldsItems: папка "Элементы с возможностью восстановления\DiscoveryHolds". Эта папка содержит элементы, которые были очищены из папки "Элементы с возможностью восстановления" (жестко удаленные элементы) и защищены удержанием. Для поиска удаленных элементов в этой папке используйте этот параметр со значением DiscoveryHoldsItems.

Type:RecoverableItemsFolderType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SubjectContains

Параметр SubjectContains фильтрует элементы по указанному текстовому значению в поле Subject. Если значение содержит пробелы, его необходимо заключить в кавычки (").

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