Compartilhar via


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:

  • Alias

  • Endereço SMTP

  • Nome para exibição

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"