Export-Mailbox
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2010-05-24
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> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-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>]]
export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AllowMerge <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-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>]]
export-Mailbox -Identity <MailboxIdParameter> -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeAssociatedMessages <SwitchParameter>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<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
Acesso total às caixas de correio de origem e destino.
Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.
Para garantir o acesso total a uma caixa de correio, use o cmdlet Add-MailboxPermission e especifique FullAccess no parâmetro AccessRights.
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.
Você pode utilizar o cmdlet Export-Mailbox para exportar dados para uma pasta ou arquivo .pst. As caixas de correio de origem e destino devem estar em um dos itens mencionados a seguir:
Servidor Exchange 2007
Servidor Exchange Server 2003 Service Pack 2 (SP2) (ou versões posteriores)
Servidor Exchange 2000 Server Service Pack 3 (SP3) (ou versões posteriores)
Para exportar os dados de um arquivo .pst, deve-se executar o cmdlet Export-Mailbox de um computador de 32 bits com as configurações a seguir:
A versão de 32 bits das ferramentas de gerenciamento do Exchange
Microsoft Office Outlook 2003 SP2 ou versões posteriores
Dica
Os artigos da Base de Dados de Conhecimento Microsoft 289999 e 813593 descrevem um problema com o uso do Outlook 2003 para excluir vários objetos de uma pasta. Você não pode usar o cmdlet Export-Mailbox para excluir mais de 4.000 objetos de uma pasta. Para exportar mais objetos, você deve utilizar Outlook 2007.
Para obter informações sobre download da versão de 32 bits das ferramentas de gerenciamento, do Exchange 2007, consulte Microsoft Exchange Server 2007 Management Tools (32-Bit) (página em inglês).
Não é possível exportar dados para um arquivo .pst de uma caixa de correio em um grupo de armazenamento de recuperação (RSG).
Não é possível exportar dados de um banco de dados da pasta pública.
O cmdlet Export-Mailbox exporta todas as pastas vazias e pastas especiais para o local de destino. Estas são as pastas especiais:
Caixa de Entrada
Itens Excluídos
Rascunhos
Lixo Eletrônico
Caixa de Saída
Itens Enviados
Diário
Calendário
Contatos
Anotações
Tarefas
O cmdlet Export-Mailbox também exporta as mensagens do dumpster. As mensagens do dumpster são convertidas em itens regulares na pasta ou no arquivo .pst para onde você exporta os dados.
Se você exportar os dados para um outra caixa de correio, usando o parâmetro TargetMailbox, o cmdlet Export-Mailbox também exporta as mensagens do dumpster de Itens excluídos. As mensagens do dumpster são convertidas em mensagens regulares quando exportadas.
Dica
Se você utilizar parâmetros de palavra-chave, o Export-Mailbox exportará todas as mensagens primeiro, inclusive as do dumpster e, em seguida, procurará a caixa de correio de destino para as mensagens que atendam aos critérios de palavra-chave. As mensagens que estavam no dumpster na caixa de correio de origem serão convertidas em mensagens regulares na caixa de correio de destino e também passarão pela busca de palavras-chave. Em seguida, o cmdlet Export-Mailbox excluirá as mensagens na caixa de correio de destino que não correspondem aos critérios da palavra-chave. Se você também usar o parâmetro DeleteContent, a opçãoExport-Mailbox excluirá as mensagens que correspondem aos critérios de palavra-chave da caixa de correio de origem.
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. |
PSTFolderPath |
Necessário |
Microsoft.Exchange.Data.LongPath |
O parâmetro PSTFolderPath indica o caminho do arquivo .pst, para o qual os dados serão exportados. |
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. O buffer do parâmetro AllContentKeywords é 32 quilobytes. 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. |
AllowDuplicates |
Optional |
System.Management.Automation.SwitchParameter |
O parâmetro AllowDuplicates é usado para copiar itens de email sem verificar se eles são duplicatas de itens existentes e sem remover itens duplicados. Recomendamos o uso do parâmetro AllowDuplicates em conjunto com o parâmetro IncludeFolders. |
AllowMerge |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro AllowMerge indica que o conteúdo exportado será mesclado com a pasta de destino para evitar duplicações. Se você especificar o parâmetro AllowMerge, o nome da subpasta para a qual o conteúdo será exportado não incluirá um carimbo de data e hora. É possível exportar dados para a mesma pasta e subpasta de destino diversas vezes, usando o parâmetro AllowMerge. |
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. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm. |
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. |
DeleteAssociatedMessages |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro DeleteAssociatedMessages especifica que as mensagens associadas serão excluídas. As mensagens associadas contêm dados ocultos com informações sobre regras, exibições e formulários. Se você utilizar o parâmetro DeleteAssociatedMessages e não especificar as opções TargetMailbox e TargetFolder, ou a PSTFolderPath, nenhum conteúdo será exportado. |
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. |
IncludeAssociatedMessages |
Optional |
System.Management.Automation.SwitchParameter |
O parâmetro IncludeAssociatedMessages especifica que as mensagens associadas serão incluídas na exportação. As mensagens associadas contêm dados ocultos com informações sobre regras, exibições e formulários. Por padrão, as mensagens associadas não são incluídas na exportação. |
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. O valor padrão é 4. |
RecipientKeywords |
Optional |
System.String[] |
O parâmetro RecipientKeywords especifica endereços de email de destinatários ou nomes de exibição. Se o comando detectar uma mensagem com um destinatário igual à palavra-chave do destinatário especificada, ele exportará a mensagem. Se a palavra-chave do destinatário definida for a mesma do grupo de distribuição destinatário de uma mensagem, essa será exportada. O comando não expande os grupos de distribuição para comparar as palavras-chave de destinatário especificadas com os membros de um grupo de distribuição destinatário de uma mensagem. |
ReportFile |
Opcional |
Microsoft.Exchange.Data.LocalLongFullPath |
O parâmetro ReportFile especifica o caminho e o nome de arquivo do log de relatórios XML. |
SenderKeywords |
Optional |
System.String[] |
O parâmetro SenderKeywords especifica endereços de email de remetentes ou nomes de exibição. Se o comando detectar uma mensagem com um remetente igual à palavra-chave do remetente especificada, ele exportará a mensagem. |
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 oferece a opção para validar a exportação sem exportar os dados. O parâmetro ValidateOnly valida os pré-requisitos para o comando. 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. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar nenhum valor com o parâmetro WhatIf. |
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.
O quinto exemplo mostra como exportar o conteúdo da caixa de correio do usuário paulo@contoso.com para um arquivo .pst, denominado paulo.pst e localizado em C:\PSTFiles.
O sexto exemplo mostra como exportar os dados de todas as caixas de correio de usuários na unidade organizacional Marketing. Os dados de cada caixa de correio serão exportados para um arquivo .pst separado, localizado em C:\PSTFiles. O nome de cada arquivo .pst será <alias>.pst. As mensagens que serão exportadas são aquelas cujos destinatários incluem luís@fabrikam.com ou susana@fabrikam.com.
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"
Export-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Get-Mailbox -OrganizationalUnit Marketing | Export-Mailbox -PSTFolderPath C:\PSTFiles -RecipientKeywords "tony@fabrikam.com","christine@fabrikam.com"