Export-Mailbox (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-06-05
Use o cmdlet Export-Mailbox para mover o conteúdo de uma caixa de correio para uma pasta de caixa de correio especificada.
Sintaxe
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>]
Descrição detalhada
Para executar o cmdlet Export-Mailbox, você deve usar a conta à qual estejam delegadas as seguintes funções:
- Função de Administrador do Exchange Server e grupo Administradores local para o servidor de destino
Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange Server 2007, consulte Considerações sobre permissão.
Você não pode exportar dados da caixa de correio de uma floresta para a caixa de correio de outra floresta. As caixas de correio de origem e de destino precisam estar na mesma floresta.
O cmdlet Export-Mailbox exporta todas as pastas vazias e pastas especiais para o local de destino. Estas são as pastas especiais:
Inbox
Itens Excluídos
Drafts
Lixo eletrônico
Outbox
Itens Enviados
Journal
Calendar
Contatos
Anotações
Tarefas
O cmdlet Export-Mailbox também exporta as mensagens do dumpster. Para obter mais informações sobre as mensagens no dumpster, consulte Como recuperar um item excluído.
Parâmetros
| Parâmetro | Necessário | Tipo | Descrição |
|---|---|---|---|
Identity |
Necessário |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
O parâmetro Identity especifica a caixa de correio da qual o conteúdo será exportado. É possível usar os seguintes valores:
Se o objeto do comando Get-Mailbox for canalizado, esse parâmetro não será necessário. |
TargetFolder |
Necessário |
System.String |
O parâmetro TargetFolder especifica a pasta de caixa de correio de nível mais alto que será criada na caixa de correio especificada pelo parâmetro TargetMailbox. Essa pasta conterá uma subpasta denominada Dados Recuperados - <alias da caixa de correio de origem> - <carimbo de data e hora>. A subpasta contém os dados exportados. Se a pasta de destino especificada já existir na caixa de correio de destino, os dados exportados serão adicionados à pasta existente. Se não existir, a pasta de destino será criada. |
TargetMailbox |
Necessário |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
O parâmetro TargetMailbox especifica a caixa de correio em que a pasta de destino será criada. A caixa de correio especificada deverá existir para que o comando seja concluído com êxito. |
AllContentKeywords |
Opcional |
System.String[] |
O parâmetro AllContentKeywords especifica as palavras-chave do conteúdo a serem incluídas na movimentação. Se o comando localizar uma palavra-chave especificada no corpo da mensagem, no conteúdo do anexo ou no assunto, ele exportará essas mensagens. Dica Isso é diferente de usar os parâmetros ContentKeywords e SubjectKeywords. Se você usar os parâmetros ContentKeywords e SubjectKeywords, o comando exportará apenas as mensagens que tenham tanto a palavra-chave que você especificar para o parâmetro ContentKeywords no corpo da mensagem ou conteúdo de anexo quanto a palavra-chave que você especificar para o parâmetro SubjectKeywords no assunto. |
AttachmentFilenames |
Opcional |
System.String[] |
O parâmetro AttachmentFilenames especifica o filtro para anexos. Você pode usar caracteres curinga na cadeia de caracteres. Por exemplo, é possível usar "*.txt" para exportar itens com a extensão .txt. |
BadItemLimit |
Opcional |
System.Int32 |
O parâmetro BadItemLimit especifica o número de itens danificados em uma caixa de correio a serem ignorados para que ocorra falha na operação de exportação. |
ContentKeywords |
Opcional |
System.String[] |
O parâmetro ContentKeywords especifica as palavras-chave do conteúdo a serem incluídas na movimentação. Se o comando localizar uma palavra-chave que você especificar no corpo da mensagem ou no conteúdo do anexo, ele exportará essas mensagens. |
DeleteContent |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro DeleteContent especifica a opção de excluir o conteúdo da caixa de correio de origem depois que ela for exportada para uma pasta. A pasta de origem não será excluída. |
EndDate |
Opcional |
System.DateTime |
O parâmetro EndDate especifica a data de término da filtragem do conteúdo que será exportado da caixa de correio de origem. Somente itens da caixa de correio com data anterior ou igual à data de término serão exportados. Ao inserir uma data específica, use o formato de data abreviada definido nas configurações de Opções Regionais do computador local. Por exemplo, se o seu computador estiver configurado para usar o formato de data abreviada dd/mm/aaaa, digite 01/03/2006 para especificar 1º de março de 2006. |
ExcludeFolders |
Opcional |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
O parâmetro ExcludeFolders especifica a lista de pastas a serem excluídas durante a exportação. |
GlobalCatalog |
Opcional |
Microsoft.Exchange.Data.Fqdn |
O parâmetro GlobalCatalog especifica o catálogo global a ser usado para pesquisar a caixa de correio de destino. |
IncludeFolders |
Opcional |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
O parâmetro IncludeFolders especifica a lista de pastas a serem incluídas durante a exportação. |
Locale |
Opcional |
System.Globalization.CultureInfo |
O parâmetro Locale especifica a localidade das mensagens a serem exportadas. O comando exportará somente as mensagens com a localidade especificada. |
MaxThreads |
Opcional |
System.Int32 |
O parâmetro MaxThreads especifica o número máximo de threads a serem usados. |
ReportFile |
Opcional |
Microsoft.Exchange.Data.LocalLongFullPath |
O parâmetro ReportFile especifica o caminho e o nome de arquivo do log de relatórios XML. |
StartDate |
Opcional |
System.DateTime |
O parâmetro StartDate especifica a data de início da filtragem do conteúdo que será exportado da caixa de correio de origem. Somente itens da caixa de correio com data posterior à data de início serão exportados. Ao inserir uma data específica, use o formato de data abreviada definido nas configurações de Opções Regionais do computador local. Por exemplo, se o seu computador estiver configurado para usar o formato de data abreviada dd/mm/aaaa, digite 01/03/2006 para especificar 1º de março de 2006. |
SubjectKeywords |
Opcional |
System.String[] |
O parâmetro SubjectKeywords especifica os filtros de palavra-chave para assuntos de itens da caixa de correio de origem. |
ValidateOnly |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro ValidateOnly instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro ValidateOnly, o administrador poderá visualizar quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Dica Se você executar o comando Export-Mailbox com esse parâmetro, o comando não aplicará nenhum filtro às mensagens. Ele apenas verificará se as caixas de correio de origem e de destino existem. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
Exceções
| Exceções | Descrição |
|---|---|
|
Exemplo
O primeiro exemplo mostra como exportar o conteúdo da caixa de correio do usuário john@contoso.com para a pasta MyData na caixa de correio ExportMailbox.
O segundo exemplo mostra como usar filtros para especificar quais itens da caixa de correio de origem serão incluídos na exportação. Esse exemplo exportará todos os itens da caixa de correio do usuário contoso\john que tiverem a palavra-chave "merger" no corpo da mensagem ou no conteúdo de um anexo, tiverem um anexo chamado *orgchart* e uma data posterior a 01/03/2006 à 0h01m.
O terceiro exemplo mostra como localizar e excluir itens de uma caixa de correio. Esse exemplo usa primeiro todas as caixas de correio do banco de dados DB1 e procura itens que contenham "Virus message" no assunto. Ele exportará os itens para outra caixa de correio e excluirá esses itens da caixa de correio de origem.
O quarto exemplo mostra que você pode canalizar a saída do comando Get-User para o comando Export-Mailbox. Esse exemplo exclui também duas pastas da exportação. Os itens das pastas Lixo Eletrônico e Contatos da caixa de correio do usuário John não serão exportados para ExportMailbox.
Dica
Você também pode canalizar a saída do comando Get-Recipient ou Get-Mailbox para o comando 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"