Import-Mailbox
Aplica-se a: Exchange Server 2010
Tópico modificado em: 2009-07-12
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>] [-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 |
|---|---|---|---|
PSTFolderPath |
Necessário |
Microsoft.Exchange.Data.LongPath |
O parâmetro PSTFolderPath especifica o caminho do arquivo .pst, do qual os dados sã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 importa essas mensagens. .gif "Bb629586.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 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 |
A opção AllowDuplicates especifica se os itens de email devem ser copiados sem que se verifique se são duplicatas de itens existentes. Recomendamos o uso do parâmetro AllowDuplicates 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 |
A opção Confirm pode ser usada para suprimir o prompt de confirmação exibido por padrão quando esse cmdlet é executado. Para suprimir o prompt de confirmação, use a sintaxe |
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çõ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 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 conectado, esse parâmetro não será obrigatório. |
IncludeAssociatedMessages |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro IncludeAssociatedMessages especifica que as mensagens associadas devem ser incluídas na importaçã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 importação. |
IncludeFolders |
Opcional |
Microsoft.Exchange.Data.MapiFolderPath[] |
O parâmetro IncludeFolders especifica a lista de pastas a serem incluídas durante a importação. Ao usar esse parâmetro, apenas as pastas na lista de parâmetros são incluídos na 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. |
SenderKeywords |
Opcional |
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çõ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 do arquivo .pst. |
ValidateOnly |
Opcional |
System.Management.Automation.SwitchParameter |
A opção ValidateOnly solicita ao cmdlet a avaliação das condições e dos requisitos necessários à execução da operação e, em seguida, informa se haverá êxito ou falha na operação. Nenhuma alteração é feita quando a opção ValidateOnly é usada. Observação:
Se você executar o comando Import-Mailbox com essa opção, 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
Para importar dados de um arquivo .pst, é preciso executar o cmdlet Import-Mailbox de um computador executando o Microsoft Exchange Server 2010 e que tenha a versão de 64 bits do Microsoft Outlook 2010 instalado. Recomendamos que você execute o comando em um servidor do Exchange dedicado que não tenha nenhuma caixa de correio.
É possível importar dados de um arquivo .pst apenas para uma caixa de correio em um servidor do Exchange 2010 que tenha a função de servidor de Caixa de Correio instalada usando o cmdlet Import-Mailbox. Para importar dados de um arquivo .pst para uma caixa de correio em um servidor do Exchange Server 2007, use a versão do Exchange 2007 do cmdlet Import-Mailbox. Para importar dados de um arquivo .pst para uma caixa de correio em um servidor do Exchange Server 2003, use o Assistente de Mesclagem de Caixa de Correio de Servidor do Microsoft Exchange (ExMerge.exe).
Não é possível importar dados usando o cmdlet Import-Mailbox de um arquivo .pst para uma caixa de correio em um banco de dados de recuperação.
Não é possível importar dados usando o cmdlet Import-Mailbox para um banco de dados de pasta pública.
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 |
|---|---|
|
Exemplos
EXEMPLO 1
Este exemplo importa os dados do arquivo C:\PSTFiles\john.pst para a caixa de correio existente e conectada de john@contoso.com.
Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
EXEMPLO 2
Este exemplo importa os dados de todos os arquivos .pst localizados em C:\PSTFiles para 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, somente as mensagens recebidas depois de 01/01/2010 serão importadas para a caixa de correio.
Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2010
EXEMPLO 3
Este exemplo importa 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.
Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles