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:
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