Compartilhar via


Import-Mailbox

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2011-06-21

Utilize o cmdlet Import-Mailbox para importar os dados da caixa de correio de um arquivo .pst para uma caixa de correio.

Sintaxe

import-Mailbox [-Identity <MailboxIdParameter>] -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-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>]]

Descrição detalhada

Para executar o cmdlet Import-Mailbox, você deve usar uma conta à qual esteja delegado o seguinte:

  • Função de Administrador do Exchange Server e grupo Administradores local para o servidor de destino

  • Acesso completo à caixa de correio de 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.

Para importar dados de um arquivo .pst, é preciso executar o cmdlet Import-Mailbox de um computador de 32 bits que tenha os itens a seguir instalados:

  • Versão de 32 bits das ferramentas de gerenciamento do Exchange 

  • Microsoft Office Outlook 2003 Service Pack 2 (SP2) ou versões posteriores

Para obter informações sobre download da versão de 32 bits das ferramentas de gerenciamento, do Exchange 2007, consulte Ferramentas de gerenciamento do Microsoft Exchange Server 2007 (32 bits) (página em inglês).

É possível utilizar o cmdlet Import-Mailbox para importar dados para uma pasta ou arquivo .pst. Os caixas de correio de origem e de destino devem estar em um computador que esteja executando uma das seguintes versões do Exchange:

  • Exchange Server 2007

  • Servidor do Exchange Server 2003 Service Pack 2 (SP2) ou versões mais recentes

  • Exchange 2000 Server Service Pack 3 (SP3) ou versões mais recentes

Para importar dados de um arquivo .pst para uma caixa de correio em qualquer outra versão do Exchange, é necessário utilizar o Microsoft Exchange Server Mailbox Merge Wizard (ExMerge.exe).

Não é possível importar dados usando o cmdlet Import-Mailbox de um arquivo .pst para uma caixa de correio em um grupo de armazenamento de recuperação (RSG).

Não é possível importar dados usando o cmdlet Import-Mailbox para um banco de dados da pasta pública.

Dica

Não é necessário configurar um perfil MAPI ao usar o cmdlet Import-Mailbox.

Parâmetros

Parâmetro Necessário Tipo Descrição

PSTFolderPath

Necessário

Microsoft.Exchange.Data.LongPath

O parâmetro PSTFolderPath indica o caminho do arquivo .pst, do qual os dados serão importados.

AllContentKeywords

Opcional

System.String[]

O parâmetro AllContentKeywords especifica as palavras-chave do conteúdo a ser incluído na importação. Se o comando localizar uma palavra-chave especificada no corpo da mensagem, no conteúdo do anexo ou no assunto, ele importará essas mensagens.

Dica

Isso é diferente de usar os parâmetros ContentKeywords e SubjectKeywords. Se você usar os parâmetros ContentKeywords e SubjectKeywords, o comando importará 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

Opcional

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.

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 importar itens com a extensão .txt.

BadItemLimit

Opcional

System.Int32

O parâmetro BadItemLimit especifica o número de itens danificados em um arquivo .pst, a serem ignorados antes que ocorra falha na operação de importaçã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 ser incluído na importação. Se o comando localizar uma palavra-chave que você especificar no corpo da mensagem ou no conteúdo do anexo, ele importará essas mensagens.

EndDate

Opcional

System.DateTime

O parâmetro EndDate especifica a data de término da filtragem do conteúdo que será importado para a caixa de correio de destino. Somente itens do arquivo .pst com data anterior ou igual à data de término serão importados. Ao inserir uma data específica, use o formato de data abreviada definido nas configuraçoes de Opçoes Regionais do computador local. Por exemplo, se o seu computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, digite 03/01/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 importaçã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.

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

O parâmetro Identity especifica o objeto da caixa de correio de destino para o qual os dados serão importados. Você pode usar um dos seguintes valores:

  • ADObjectID

  • DN (nome distinto)

  • DN Herdado do Exchange

  • GUID

  • Domínio\Nome da conta

  • Nome UPN

  • Endereço de email

  • Alias

Se o objeto do comando Get-Mailbox for canalizado, esse parâmetro não será necessário.

IncludeFolders

Opcional

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

O parâmetro IncludeFolders especifica a lista de pastas a serem incluídas durante a importação.

Locale

Opcional

System.Globalization.CultureInfo

O parâmetro Locale especifica a localidade das mensagens a serem importadas. O comando importará 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

Opcional

System.String[]

O parâmetro RecipientKeywords especifica as palavras-chave do conteúdo a ser incluído na importação. Se o comando localizar uma palavra-chave especificada na lista de destinatários, ele importará essas mensagens.

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 as palavras-chave do conteúdo a ser incluído na importação. Se o comando localizar uma palavra-chave especificada no remetente, ele importará essas mensagens.

StartDate

Opcional

System.DateTime

O parâmetro StartDate especifica a data de início da filtragem do conteúdo que será importado para a caixa de correio de destino. Somente itens do arquivo .pst com data posterior à data de início serão importados. Ao inserir uma data específica, use o formato de data abreviada definido nas configuraçoes de Opçoes Regionais do computador local. Por exemplo, se o seu computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, digite 03/01/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 do arquivo .pst.

ValidateOnly

Opcional

System.Management.Automation.SwitchParameter

O parâmetro ValidateOnly oferece a opção para validar a importação sem importar os dados. O parâmetro ValidateOnly valida os pré-requisitos para o comando.

Dica

Se você executar o comando Import-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

 

Exemplo

O primeiro exemplo exibe como importar os dados do arquivo C:\PSTFiles\paulo.pst para a caixa de correio existente e conectada de paulo@contoso.com.

O segundo exemplo mostra como importar os dados de todos os arquivos .pst localizados em C:\PSTFiles para as caixas de correio existentes. Os arquivos .pst devem ser nomeados <alias>.pst, onde alias significa o alias da caixa de correio para a qual os dados serão importados. Para cada arquivo .pst file, somente as mensagens recebidas depois de 01/01/2007 serão importadas para a caixa de correio.

O terceiro exemplo mostra como importar os dados de arquivos .pst para as caixas de correio cujos usuários se encontram na unidade organizacional Marketing. Os arquivos .pst devem ser nomeados <alias>.pst, onde alias significa o alias da caixa de correio para a qual os dados serão importados. Somente os arquivos .pst cujos alias correspondem a um usuário na unidade organizacional Marketing serão importados. Se nenhum arquivo .pst existir em C:\PSTFiles para um usuário na unidade organizacional Marketing, será exibido um erro.

Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2007
Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles