Командлет Export-Mailbox (окончательная первоначальная версия)
Применимо к: Exchange Server 2007
Последнее изменение раздела: 2007-06-05
Командлет Export-Mailbox используется для перемещения содержимого почтового ящика в указанную папку почтового ящика.
Синтаксис
export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-DeleteContent <SwitchParameter>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>]
Подробное описание
Для выполнения командлета Export-Mailbox используемой учетной записи необходимо делегировать следующее:
- роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Невозможно экспортировать данные из почтового ящика в одном лесу в почтовый ящик в другом лесу. Исходный и целевой почтовые ящики должны находиться в одном и том же лесу.
Командлет Export-Mailbox экспортирует все пустые папки и специальные папки в целевое расположение. Специальные папки перечислены ниже:
Inbox
Удаленные
Drafts
Нежелательная почта
Outbox
Отправленные
Journal
Календарь
контакты;
Notes
Задачи
Командлет Export-Mailbox также экспортирует сообщения из корзины. Дополнительные сведения о сообщениях в корзине см. в разделе Указания по восстановлению удаленного элемента.
Параметры
| Параметр | Обязательность | Тип | Описание | ||
|---|---|---|---|---|---|
Идентификатор |
Обязательность |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Параметр Identity задает почтовый ящик, из которого экспортируется содержимое. Можно использовать следующие значения:
Если объект команды Get-Mailbox передается другой команде по конвейеру, этот параметр не является обязательным. |
||
TargetFolder |
Обязательность |
System.String |
Параметр TargetFolder задает папку почтового ящика верхнего уровня, которая создается в почтовом ящике, указанном в параметре TargetMailbox. Эта папка содержит вложенную папку Recovered Data — <псевдоним исходного почтового ящика> — <отметка даты и времени>. В этой вложенной папке содержатся экспортированные данные. Если указанная целевая папка уже существует в целевом почтовом ящике, экспортируемые данные будут добавлены в нее. Если целевая папка отсутствует, она будет создана. |
||
TargetMailbox |
Обязательность |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Параметр TargetMailbox задает почтовый ящик, в котором будет создана целевая папка. Для успешного выполнения команды необходимо указать существующий почтовый ящик. |
||
AllContentKeywords |
Дополнительно |
System.String[] |
Параметр AllContentKeywords используется для указания ключевых слов для содержимого, которое необходимо переместить. При обнаружении заданного ключевого слова в тексте сообщения, вложении или поле «Тема» команда экспортирует соответствующие сообщения.
|
||
AttachmentFilenames |
Дополнительно |
System.String[] |
Параметр AttachmentFilenames используется для указания фильтра для вложений. В строке можно использовать подстановочные знаки. Например, можно использовать выражение «*.txt» для экспорта элементов с расширением TXT. |
||
BadItemLimit |
Дополнительно |
System.Int32 |
Параметр BadItemLimit задает количество поврежденных элементов в почтовом ящике, которое допускается пропустить перед сбоем операции экспорта. |
||
ContentKeywords |
Дополнительно |
System.String[] |
Параметр ContentKeywords используется для указания ключевых слов для содержимого, которое следует переместить. При обнаружении заданного ключевого слова в тексте сообщения или вложении команда экспортирует соответствующие сообщения. |
||
DeleteContent |
Дополнительно |
System.Management.Automation.SwitchParameter |
Параметр DeleteContent позволяет удалить содержимое из исходного почтового ящика после его экспорта в папку. Исходная папка не удаляется. |
||
EndDate |
Дополнительно |
System.DateTime |
Параметр EndDate задает конечную дату для фильтрации содержимого, которое экспортируется из исходного почтового ящика. Экспортируются только те элементы в почтовом ящике, дата которых предшествует или равна конечной дате. При вводе конкретной даты используйте краткий формат даты, определенный настроенными на локальном компьютере параметрами Язык и региональные стандарты. Например, если компьютер настроен на использование краткого формата даты мм/дд/гггг, чтобы указать 1 марта 2006 г., введите 03/01/2006. |
||
ExcludeFolders |
Дополнительно |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
Параметр ExcludeFolders позволяет указать список папок, которые следует исключить из экспорта. |
||
GlobalCatalog |
Дополнительно |
Microsoft.Exchange.Data.Fqdn |
Параметр GlobalCatalog задает глобальныо каталог, который необходимо использовать для поиска целевого почтового ящика. |
||
IncludeFolders |
Дополнительно |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
Параметр IncludeFolders задает список папок, которые следует включить в экспорт. |
||
Locale |
Дополнительно |
System.Globalization.CultureInfo |
Параметр Locale задает язык экспортируемых сообщений. Команда экспортирует только сообщения с указанными языковыми стандартами. |
||
MaxThreads |
Дополнительно |
System.Int32 |
С помощью параметра MaxThreads можно указать максимальное количество используемых потоков. |
||
ReportFile |
Дополнительно |
Microsoft.Exchange.Data.LocalLongFullPath |
Параметр ReportFile используется для указания пути и имени файла журнала отчетов в формате XML. |
||
StartDate |
Дополнительно |
System.DateTime |
Параметр StartDate используется для указания начальной даты для фильтрации содержимого, которое экспортируется из исходного почтового ящика. Экспортируются только те элементы в почтовом ящике, дата которых позднее начальной даты. При вводе конкретной даты используйте краткий формат даты, определенный настроенными на локальном компьютере параметрами Язык и региональные стандарты. Например, если компьютер настроен на использование краткого формата даты мм/дд/гггг, чтобы указать 1 марта 2006 г., введите 03/01/2006. |
||
SubjectKeywords |
Дополнительно |
System.String[] |
Параметр SubjectKeywords задает фильтры на основе ключевых слов для тем элементов в исходном почтовом ящике. |
||
ValidateOnly |
Дополнительно |
System.Management.Automation.SwitchParameter |
Параметр ValidateOnly заставляет команду имитировать действия, которые она будет выполнять над объектом. Используя параметр ValidateOnly, администратор может просматривать изменения, которые произойдут при выполнении команды, без применения всех этих изменений.
|
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
Исключения
| Исключения | Описание |
|---|---|
|
Пример
В первом примере показано, как экспортировать содержимое почтового ящика пользователя «john@contoso.com» в папку «MyData» почтового ящика «ExportMailbox».
Во втором примере показано использование фильтров для задания в исходном почтовом ящике элементов, которые будут экспортироваться. В этом примере экспортируются из почтового ящика пользователя «contoso\john» все элементы, которые имеют ключевое слово «merger» (слияние) в тексте сообщения или вложении, имеют вложение с именем «*orgchart*» и дату позднее 12:01:00, 03/01/2006.
В третьем примере продемонстрирован поиск и удаление элементов из почтового ящика. В этом примере сначала находятся все почтовые ящики в базе данных DB1 и выполняется поиск элементов, содержащих в теме строку «Virus message». Элементы экспортируются в другой почтовый ящик и удаляются из исходного почтового ящика.
В четвертом примере демонстрируется возможность передачи результатов команды Get-User команде Export-Mailbox. Также в этом примере из экспорта исключаются две папки. Элементы в папках «Нежелательная почта» и «Контакты» в почтовом ящике Джона (John) не экспортируются в почтовый ящик ExportMailbox.
.gif "note") Примечание. |
|---|
| Также можно передать результаты выполнения команды Get-Recipient или Get-Mailbox команде Export-Mailbox. |
Export-Mailbox -Identity john@contoso.com -TargetMailbox ExportMailbox -TargetFolder MyData
Export-Mailbox -Identity contoso\john -TargetMailbox ExportMailbox -TargetFolder MyData -ContentKeywords "merger" -AttachmentFilenames "*orgchart*" -StartDate "03/01/2006 12:01:00"
Get-Mailbox -Database DB1 | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder VirusData -SubjectKeywords "Virus message" -DeleteContent
Get-User john | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder MyData -ExcludeFolders "\Junk E-Mail","\Contacts"