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

Командлет Restore-Mailbox (окончательная первоначальная версия)

  • Статья

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-05

Командлет Restore-Mailbox используется для извлечения содержимого почтового ящика из базы данных, восстановленной в группу хранения для восстановления.

Синтаксис

restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]

restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> -RSGMailbox <StoreMailboxIdParameter> -TargetFolder <String> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]

Подробное описание

Командлет Restore-Mailbox копирует данные конечного пользователя из группы хранения для восстановления на любом сервере, где выполняется Microsoft Exchange Server 2007, в почтовый ящик на любом сервере почтовых ящиков Exchange 2007 в той же организации, имеющем достаточно места на диске и ресурсов для поддержки этого почтового ящика.

Группа хранения для восстановления позволяет восстанавливать данные из резервной копии базы данных без ограничения доступа пользователя к текущим данным. Она может также использоваться для извлечения данных в случае их потери. Сервер может содержать только одну группу хранения для восстановления.

Для выполнения командлета Restore-Mailbox используемой учетной записи необходимо делегировать следующие роли:

  • роль администратора сервера Exchange и членство в локальной группе администраторов на исходном и целевом серверах.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Серверы входят в состав одиночного леса или лесов ресурсов. Данные из почтового ящика могут экспортироваться только в почтовые ящики, находящиеся в том же лесу. Учетные записи в службе каталогов Active Directory, связанные с почтовым ящиком, могут находиться во внешнем лесу, но данные из почтового ящика не могут экспортироваться на серверы, находящиеся в других лесах.

Как восстановленную, так и исходную базы данных необходимо взять с сервера Exchange 2007.

В командлете Restore-Mailbox в качестве источника данных могут использоваться только отключенные почтовые ящики из группы хранения для восстановления на сервере, а в качестве конечного пункта для данных — только подключенные почтовые ящики.

Параметры

Параметр Обязательность Тип Описание

Идентификатор

Обязательность

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Параметр Identity указывает идентификатор нужного почтового ящика. Этот параметр является именем или идентификатором GUID. Если исходный почтовый ящик не определяется при помощи параметра RSGMailbox, предполагается, что он имеет тот же самый идентификатор GUID, что и конечный почтовый ящик.

RSGDatabase

Обязательность

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Параметр RSGDatabase определяет базу данных группы хранения для восстановления, из которой производится восстановление почтового ящика. Можно использовать следующие значения:

  • идентификатор GUID базы данных

  • имя базы данных

  • имя сервера\имя базы данных

  • имя сервера\группа хранения\имя базы данных

RSGMailbox

Обязательность

Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter

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

TargetFolder

Обязательность

System.String

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

AllContentKeywords

Дополнительно

System.String[]

Параметр AllContentKeywords позволяет указать фильтры для всех указанных ниже параметров.

  • Тема

  • Текст сообщения

  • Содержимое вложения

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

AttachmentFilenames

Дополнительно

System.String[]

Параметр AttachmentFilenames указывает фильтр имен вложенных файлов. В строке можно использовать подстановочные знаки. Например, можно использовать выражение «*.txt» для экспорта элементов с расширением TXT.

BadItemLimit

Дополнительно

System.Int32

Параметр BadItemLimit задает количество поврежденных элементов в почтовом ящике, которое допускается пропустить перед сбоем операции экспорта.

ContentKeywords

Дополнительно

System.String[]

Параметр ContentKeywords устанавливает фильтры по ключевым словам для текста сообщения и содержимого вложений в исходном почтовом ящике.

EndDate

Дополнительно

System.DateTime

Параметр EndDate задает конечную дату для фильтрации содержимого, которое экспортируется из исходного почтового ящика. Экспортируются только те элементы в почтовом ящике, дата которых предшествует конечной дате. При вводе конкретной даты используйте краткий формат даты, определенный настроенными на локальном компьютере параметрами Язык и региональные стандарты. Например, если компьютер настроен на использование краткого формата даты мм/дд/гггг, чтобы указать 1 марта 2006 г., введите 03/01/2006.

ExcludeFolders

Дополнительно

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

Параметр ExcludeFolders позволяет указать список папок, которые следует исключить из экспорта. Папки исключаются по мере ввода. Они не локализуются. Например, исключение параметра calendar приведет к исключению календаря только на английском языке, поскольку в других языках слово «календарь» переводится по-другому.

GlobalCatalog

Дополнительно

Microsoft.Exchange.Data.Fqdn

Параметр GlobalCatalog задает глобальныо каталог, который необходимо использовать для поиска целевого почтового ящика.

IncludeFolders

Дополнительно

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

Параметр IncludeFolders задает список папок, которые следует включить в экспорт. Папки включаются по мере ввода. Они не локализуются. Например, включение параметра calendar включит календарь только на английском языке, поскольку в других языках слово «календарь» переводится по-другому.

Locale

Дополнительно

System.Globalization.CultureInfo

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

MaxThreads

Дополнительно

System.Int32

С помощью параметра MaxThreads можно указать максимальное количество используемых потоков.

ReportFile

Дополнительно

Microsoft.Exchange.Data.LocalLongFullPath

Параметр ReportFile используется для указания пути и имени файла журнала отчетов в формате XML.

StartDate

Дополнительно

System.DateTime

Параметр StartDate задает дату начала. Дата начала должна предшествовать дате окончания.

SubjectKeywords

Дополнительно

System.String[]

Параметр SubjectKeywords задает фильтры на основе ключевых слов для тем элементов в исходном почтовом ящике. Данный фильтр позволяет найти строку поиска, даже если это часть слова. Это не поиск по целому слову.

ValidateOnly

Дополнительно

System.Management.Automation.SwitchParameter

Параметр ValidateOnly заставляет команду имитировать действия, которые она будет выполнять над объектом. По умолчанию он имеет значение «$true».

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка

Описание

 

 

Исключения

Исключения

Описание

 

 

Пример

В следующем примере кода в первом случае почтовый ящик пользователя по имени Крис восстанавливается из базы данных MyRSGDatabase группы хранения для восстановления. Во втором примере содержимое почтового ящика пользователя Рикардо восстанавливается в почтовый ящик Криса в папку «Восстановленные». В третьем примере восстанавливаются только почтовые сообщения на тему «Собрание», содержащие слово «бизнес» в теле сообщения И расположенные в папке Входящие или Календарь. В этом примере название почтового ящика приводится на английском языке. В последнем случае восстанавливаются все почтовые ящики в базе данных почтового ящика «MyDatabase», которые также присутствуют в «MyRSGDatabase».

Restore-Mailbox -Identity chris -RSGDatabase MyRSGDatabase
Restore-Mailbox -Identity Chris -RSGDatabase MyRSGDatabase -RSGMailbox Ricardo -TargetFolder Recovery
Restore-Mailbox -Identity Chris -RSGDatabase MyRSGDatabase -SubjectKeywords "Meeting" -ContentKeyword "business" -IncludeFolders \Inbox,\Calendar
Get-mailbox -Database MyDatabase | Restore-Mailbox -RSGDatabase MyRSGDatabase