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


Restore-RecoverableItems

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

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

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

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

Синтаксис

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

Описание

Элементы восстанавливаются в исходную папку, если информация доступна. Если информация недоступна, элемент восстанавливается в папку по умолчанию для типа элемента ("Входящие" для сообщений, "Календарь" для собраний и встреч и т. д.).

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

Примеры

Пример 1

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

После использования командлета Get-RecoverableItems для проверки существования элемента этот пример восстанавливает указанный удаленный элемент из указанного почтового ящика:

  • Почтовых ящиков: laura@contoso.com
  • Тип элемента: электронное сообщение.
  • Тема сообщения: бухгалтерия 18-го финансового года
  • Расположение: "Recoverable Items\Deletions".
  • Диапазон дат: с 1 по 5 февраля 2018 г.

Пример 2

$mailboxes = Import-CSV "C:\My Documents\RestoreMessage.csv"

$mailboxes | foreach {Restore-RecoverableItems -Identity $_.SMTPAddress -SubjectContains "Project X" -SourceFolder DeletedItems -FilterItemType IPM.Note}

В Exchange Server в этом примере восстанавливается удаленное сообщение электронной почты "Project X" для почтовых ящиков, указанных в csv-файле С:\My Documents\RestoreMessage.csv. CSV-файл использует значение заголовка SMTPAddress и содержит адреса электронной почты каждого почтового ящика в отдельной строке следующим образом:

SMTPAddress

chris@contoso.com

michelle@contoso.com

laura@contoso.com

julia@contoso.com

Первая команда считывает CSV-файл в переменную с именем $mailboxes. Вторая команда восстанавливает указанное сообщение из папки "Удаленные" в этих почтовых ящиках.

Пример 3

Restore-RecoverableItems -Identity "malik@contoso.com","lillian@contoso.com" -FilterItemType IPM.Note -SubjectContains "COGS FY17 Review" -FilterStartTime "3/15/2019 12:00:00 AM" -FilterEndTime "3/25/2019 11:59:59 PM" -MaxParallelSize 2

В Exchange Online после использования командлета Get-RecoverableItems для проверки существования элемента в этом примере выполняется восстановление указанных удаленных элементов в указанных почтовых ящиках:

  • Почтовые ящики: malik@contoso.com, lillian@contoso.com
  • Тип элемента: электронное сообщение.
  • Тема сообщения: ОБЗОР COGS FY17
  • Расположение: "Recoverable Items\Deletions".
  • Диапазон дат: 15.03.2019 по 25.03.2019
  • Количество одновременно обработанных почтовых ящиков: 2

Пример 4

Get-RecoverableItems administrator | Restore-RecoverableItems

В этом примере выполняется массовое восстановление всех восстанавливаемых элементов для администратора.

Параметры

-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

ФильтрEndTime указывает конечную дату и время диапазона дат. Этот параметр использует значение 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

-NoOutput

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

Параметр NoOutput восстанавливает удаленные элементы напрямую без выходных данных команды в консоли. Для этого переключателя не требуется указывать значение.

Type:SwitchParameter
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

-RestoreTargetFolder

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

Параметр RestoreTargetFolder указывает папку верхнего уровня, в которой нужно восстановить данные. Если этот параметр не указан, команда восстанавливает папки до самого верха структуры папок в целевом почтовом ящике или архиве. Содержимое существующих папок объединяется, а новые папки добавляются к целевой структуре папок.

Этот параметр является обязательным для архивов и необязательным для основных почтовых ящиков. Конечная папка будет создана, если она не существует. Допустимые пути:

  • /
  • /folder1
  • /folder1/folder2
  • folder1
  • folder1/folder2

Предыдущие или конечные / значения будут игнорироваться. Затем он будет рассматриваться как относительный путь вложенного дерева IPM: /Top Of Information Store.

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
Accepted values:DeletedItems | RecoverableItems | PurgedItems
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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