Export-Mailbox
Aplica-se a: Exchange Server 2010
Tópico modificado em: 2009-07-07
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[]>] [-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[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-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[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
export-Mailbox -Identity <MailboxIdParameter> -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-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[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
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 conectado, esse parâmetro não será obrigatório. |
PSTFolderPath |
Necessário |
Microsoft.Exchange.Data.LongPath |
O parâmetro PSTFolderPath especifica o caminho do arquivo .pst para o qual os dados são exportados. |
TargetFolder |
Necessário |
System.String |
O parâmetro TargetFolder especifica a pasta de caixa de correio de nível mais alto criada na caixa de correio especificada pelo parâmetro TargetMailbox. Essa pasta contém uma subpasta chamada Dados Recuperados - <alias_da_caixa_de_correio_de_origem> - <marca_de_data_e_hora>. A subpasta contém os dados exportados. Se a pasta de destino especificada já estiver na caixa de correio de destino, os dados exportados serão adicionados à pasta existente. Se não houver a pasta de destino, ela será criada. |
TargetMailbox |
Necessário |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
O parâmetro TargetMailbox especifica a caixa de correio na qual a pasta de destino é 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. .gif "Aa998579.note(pt-br,EXCHG.140).gif") Observação:
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 a palavra-chave que você especificar para o parâmetro ContentKeywords no corpo da mensagem ou conteúdo de anexo e a palavra-chave que você especificar para o parâmetro SubjectKeywords no assunto.
|
AllowMerge |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro AllowMerge especifica que o conteúdo exportado é 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á uma marca 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 |
A opção 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 a opção 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 são excluídas. As mensagens associadas contêm dados ocultos com informações sobre regras, exibições e formulários. Se você usar o parâmetro DeleteAssociatedMessages e não especificar os parâmetros TargetMailbox e TargetFolder , ou o parâmetro 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 é excluída. |
EndDate |
Opcional |
System.DateTime |
O parâmetro EndDate especifica a data de término da filtragem do conteúdo exportado da caixa de correio de origem. Somente itens da caixa de correio com data anterior ou igual à data de término sã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 computador estiver configurado para usar o formato de data abreviado, dd/mm/aaaa, digite 01/03/2010 para especificar 1º de março de 2010. |
ExcludeFolders |
Opcional |
Microsoft.Exchange.Data.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 |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro IncludeAssociatedMessages especifica que as mensagens associadas sã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 em uma exportação. |
IncludeFolders |
Opcional |
Microsoft.Exchange.Data.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 só exporta 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 |
Opcional |
System.String[] |
O parâmetro RecipientKeywords especifica endereços de email de destinatários ou nomes de exibição. Se o comando localizar 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. |
SenderKeywords |
Opcional |
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 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 computador estiver configurado para usar o formato de data abreviado, dd/mm/aaaa, digite 01/03/2010 para especificar 1º de março de 2010. |
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. Observação:
Se você executar o comando Export-Mailbox com esse parâmetro, o comando não aplicará nenhum filtro às mensagens. Ele só verifica se há caixas de correio de origem e de destino.
|
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
A opção WhatIf instrui o comando a simular as ações que ele executaria no objeto. Usando-se a opção WhatIf, é possível exibir que alterações ocorreriam sem que seja necessário aplicar nenhuma dessas alterações. Você não precisa especificar um valor com a opção WhatIf. |
Descrição detalhada
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 de destino devem estar em um servidor no qual o Microsoft Exchange Server 2010 é executado.
Para exportar dados de um arquivo .pst, você deve executar o cmdlet Export-Mailbox em um servidor do Exchange que tem a versão 64 bits do Microsoft Outlook 2010 instalada. Recomendamos que você execute o comando em um servidor do Exchange dedicado que não tenha nenhuma caixa de correio.
O cmdlet Export-Mailbox exporta todas as pastas vazias e pastas especiais para o local de destino. Estas são as pastas especiais:
- Inbox
- Deleted Items
- Drafts
- Junk E-mail
- Outbox
- Sent Items
- Journal
- Calendar
- Contacts
- Notes
- Tasks
Dica
O Exchange 2010 não exporta dados de dumpster.
Dica
Se você usar parâmetros de palavra-chave, o cmdlet Export-Mailbox exportará primeiro todas as mensagens e, em seguida, pesquisará 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 haverá a procura de palavras-chave. Em seguida, o cmdlet Export-Mailbox exclui mensagens da caixa de correio de destino que não correspondem aos critérios das palavras-chave. Se você usar o parâmetro DeleteContent, o cmdlet Export-Mailbox excluirá as mensagens correspondentes aos critérios de palavra-chave da caixa de correio de origem.
Para executar esse cmdlet, você precisa ter permissões. Embora todos os parâmetros para este cmdlet estejam listados neste tópico, talvez você não tenha acesso a alguns parâmetros, caso eles não estejam incluídos nas permissões atribuídas a você. Para ver de que permissões você precisa, consulte o Entrada "Importar/Exportar caixa de correio" no tópico Permissões de caixa de correio.
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
Exceções
| Exceções | Descrição |
|---|---|
|
Exemplos
EXEMPLO 1
Este exemplo exporta o conteúdo da caixa de correio do usuário john@contoso.com para a pasta MyData na caixa de correio ExportMailbox.
Export-Mailbox -Identity john@contoso.com -TargetMailbox ExportMailbox -TargetFolder MyData
EXEMPLO 2
Este exemplo usa filtros para especifica que itens na caixa de correio de origem devem ser 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 a cadeia de caracteres "orgchart" dentro do nome de arquivo do anexo e tiverem uma data posterior a 1º de março de 2010 às 12:01:00 P.M.
Export-Mailbox -Identity contoso\john -TargetMailbox ExportMailbox -TargetFolder MyData -ContentKeywords "merger" -AttachmentFilenames "*orgchart*" -StartDate "03/01/2010 12:01:00"
EXEMPLO 3
Este exemplo localiza e exclui 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 exporta os itens para outra caixa de correio e exclui esses itens da caixa de correio de origem.
Get-Mailbox -Database DB1 | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder VirusData -SubjectKeywords "Virus message" -DeleteContent
EXEMPLO 4
Este exemplo liga a saída do comando Get-User ao comando Export-Mailbox. Esse exemplo exclui também duas pastas da exportação. Os itens das pastas Junk E-mail e Contacts da caixa de correio do usuário John não são exportados para a caixa de correio de destino ExportMailbox.
Dica
Também é possível produzir a saída dos cmdlets Get-Recipient ou Get-Mailbox para o cmdlet Export-Mailbox.
Get-User john | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder MyData -ExcludeFolders "\Junk E-mail","\Contacts"
EXEMPLO 5
Este exemplo exporta o conteúdo da caixa de correio do usuário john@contoso.com para um arquivo .pst chamado john.pst e localizado em C:\PSTFiles.
Export-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
EXEMPLO 6
Este exemplo exporta dados de todas as caixas de correio de usuários na unidade organizacional Marketing. Os dados de cada caixa de correio são exportados para um arquivo .pst separado localizado em C:\PSTFiles. O nome de cada arquivo .pst é <alias>.pst. As mensagens exportadas são aquelas cujos destinatários incluem tony@fabrikam.com ou christine@fabrikam.com.
Get-Mailbox -OrganizationalUnit Marketing | Export-Mailbox -PSTFolderPath C:\PSTFiles -RecipientKeywords "tony@fabrikam.com","christine@fabrikam.com"