Restore-Mailbox
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2009-05-14
Командлет Restore-Mailbox используется для извлечения содержимого почтового ящика из базы данных, восстановленной в группу хранения для восстановления.
Синтаксис
restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
restore-Mailbox -Identity <MailboxIdParameter> -RSGDatabase <DatabaseIdParameter> -RSGMailbox <StoreMailboxIdParameter> -TargetFolder <String> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Подробное описание
Командлет Restore-Mailbox копирует данные конечного пользователя из группы хранения для восстановления на любом сервере, где выполняется Microsoft Exchange Server 2007, в почтовый ящик на любом сервере почтовых ящиков Exchange 2007 в той же организации, имеющем достаточно места на диске и ресурсов для поддержки этого почтового ящика. В командлете Restore-Mailbox в качестве источника данных могут использоваться только отключенные почтовые ящики из группы хранения для восстановления на сервере, а в качестве конечного пункта для данных — только подключенные почтовые ящики.
Для выполнения командлета Restore-Mailbox используемой учетной записи необходимо делегировать роль администратора сервера Exchange и членство в локальной группе администраторов на исходном и целевом серверах. Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
Identity |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Параметр Identity указывает идентификатор нужного почтового ящика. Этот параметр является именем или идентификатором GUID. Если исходный почтовый ящик не определяется при помощи параметра RSGMailbox, предполагается, что он имеет тот же самый идентификатор GUID, что и целевой почтовый ящик. |
RSGDatabase |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
Параметр RSGDatabase определяет базу данных группы хранения для восстановления, из которой производится восстановление почтового ящика. Ниже приведены значения, которые можно использовать.
|
RSGMailbox |
Обязательный |
Microsoft.Exchange.Configuration.Tasks.StoreMailboxIdParameter |
Параметр RSGMailbox определяет почтовый ящик в группе хранения для восстановления, который необходимо использовать в качестве исходного почтового ящика. Этот параметр необходим, если исходный почтовый ящик отличается от конечного. |
TargetFolder |
Обязательный |
System.String |
Параметр TargetFolder указывает папку почтового ящика, которая создается в заданном почтовом ящике. Если восстанавливаемый почтовый ящик отличается от почтового ящика в группе хранения для восстановления, командлет Restore-Mailbox выполнит объединение. |
AllContentKeywords |
Дополнительно |
System.String[] |
Параметр AllContentKeywords позволяет указать фильтры для всех указанных ниже параметров.
Это позволяет выполнить поиск с применением условия Или для всех этих полей. Результаты будут получены, если параметры поиска присутствуют в теме, тексте сообщения или вложении. |
AllowDuplicates |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр AllowDuplicates позволяет копировать элементы почты, не проверяя, дублируют ли они имеющиеся элементы, и не удаляя повторяющиеся элементы. Параметр AllowDuplicates рекомендуется использовать совместно с параметром IncludeFolders. |
AttachmentFilenames |
Дополнительно |
System.String[] |
Параметр AttachmentFilenames указывает фильтр имен вложенных файлов. В строке можно использовать подстановочные знаки. Например, можно использовать выражение «*.txt» для экспорта элементов с расширением TXT. |
BadItemLimit |
Дополнительно |
System.Int32 |
Параметр BadItemLimit задает число поврежденных элементов в почтовом ящике, которые пропускаются, прежде чем произойдет сбой операции экспорта. |
Confirm |
Дополнительно |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует, чтобы администратор подтвердил ее выполнение. По умолчанию он имеет значение «$true». |
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 можно указать максимальное количество используемых потоков. |
RecipientKeywords |
Дополнительно |
System.String[] |
Параметр SubjectKeywords задает фильтры на основе ключевых слов для получателей элементов в исходном почтовом ящике. Данный фильтр позволяет найти строку поиска, даже если это часть слова. Это не поиск по целому слову. |
ReportFile |
Дополнительно |
Microsoft.Exchange.Data.LocalLongFullPath |
Параметр ReportFile задает путь и имя файла журнала отчетов в формате XML. |
SenderKeywords |
Дополнительно |
System.String[] |
Параметр SubjectKeywords задает фильтры на основе ключевых слов для отправителей элементов в исходном почтовом ящике. Данный фильтр позволяет найти строку поиска, даже если это часть слова. Это не поиск по целому слову. |
StartDate |
Дополнительно |
System.DateTime |
Параметр StartDate задает дату начала. Дата начала должна предшествовать дате окончания. |
SubjectKeywords |
Дополнительно |
System.String[] |
Параметр SubjectKeywords задает фильтры по ключевым словам для тем элементов в исходном почтовом ящике. Данный фильтр позволяет найти строку поиска, даже если это часть слова. Это не поиск по целому слову. |
TargetFolder |
Дополнительно |
System.String |
Параметр TargetFolder указывает папку почтового ящика, которая создается для заданного почтового ящика. Этот параметр необходим, если восстановленный почтовый ящик отличается от почтового ящика в группе хранения для восстановления. (Например, значение, указанное для параметра Identity , не является аналогичным значению, указанному для параметра RSGMailbox .) В этом случае командлет Restore-Mailbox выполнит слияние. Если эти значения аналогичны, параметра TargetFolder не требуется. |
ValidateOnly |
Дополнительно |
System.Management.Automation.SwitchParameter |
Параметр ValidateOnly дает указание команде имитировать действия, которые она будет выполнять в отношении объекта. По умолчанию установлено значение «$true». |
WhatIf |
Дополнительно |
System.Management.Automation.SwitchParameter |
Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf администратор может просматривать изменения, которые могли бы произойти, без применения всех этих изменений. По умолчанию он имеет значение «$true». |
Типы входных данных
Типы возвращаемых данных
Ошибки
Исключения
Пример
В следующем примере кода в первом случае почтовый ящик пользователя по имени Скотт восстанавливается из базы данных MyRSGDatabase группы хранения для восстановления.
Во втором примере содержимое почтового ящика пользователя Джон восстанавливается в почтовый ящик Скотта в папку «Восстановленные».
В третьем примере восстанавливаются только почтовые сообщения на тему «Собрание», содержащие слово «бизнес» в теле сообщения и расположенные в папке Входящие или Календарь. В этом примере название почтового ящика приводится на английском языке.
В последнем случае восстанавливаются все почтовые ящики в базе данных почтового ящика «MyDatabase», которые также присутствуют в «MyRSGDatabase».
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase -RSGMailbox John -TargetFolder Recovery
Restore-Mailbox -Identity Scott -RSGDatabase MyRSGDatabase -SubjectKeywords "Meeting" -ContentKeyword "business" -IncludeFolders \Inbox,\Calendar
Get-Mailbox -Database MyDatabase | Restore-Mailbox -RSGDatabase MyRSGDatabase