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/folder2folder1folder1/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 |