Move-Mailbox
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Tópico modificado em: 2009-05-11
Use o cmdlet Move-Mailbox para mover caixas de correio na organização ou entre organizações diferentes.
Sintaxe
move-Mailbox -Identity <MailboxIdParameter> -TargetDatabase <DatabaseIdParameter> [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-GlobalCatalog <Fqdn>] [-IgnorePolicyMatch <SwitchParameter>] [-IgnoreRuleLimitErrors <SwitchParameter>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-UseRusServer <String>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
move-Mailbox -Identity <MailboxIdParameter> -TargetDatabase <DatabaseIdParameter> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AllowMerge <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DomainController <Fqdn>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IgnorePolicyMatch <SwitchParameter>] [-IgnoreRuleLimitErrors <SwitchParameter>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-NTAccountOU <OrganizationalUnitIdParameter>] [-PreserveMailboxSizeLimit <SwitchParameter>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-RetryInterval <EnhancedTimeSpan>] [-RetryTimeout <EnhancedTimeSpan>] [-SenderKeywords <String[]>] [-SourceForestCredential <PSCredential>] [-SourceForestGlobalCatalog <Fqdn>] [-SourceMailboxCleanupOptions <None | DeleteSourceMailbox | DeleteSourceNTAccount | MailEnableSourceAccount | CreateSourceContact>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-TargetForestCredential <PSCredential>] [-UseRusServer <String>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
move-Mailbox -Identity <MailboxIdParameter> -ConfigurationOnly <SwitchParameter> -TargetDatabase <DatabaseIdParameter> [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-GlobalCatalog <Fqdn>] [-IgnorePolicyMatch <SwitchParameter>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-UseRusServer <String>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Você pode usar o cmdlet Move-Mailbox para executar as seguintes tarefas:
Mover uma caixa de correio entre servidores em uma organização. Essa movimentação pode ser útil durante atualizações de hardware ou software.
Mover uma caixa de correio entre servidores em organizações diferentes. Essa movimentação pode ser útil quando as organizações mesclam infra-estruturas de rede.
Para executar o cmdlet Move-Mailbox, à conta em uso deve ser delegada as seguintes funções nos servidores de origem e de destino:
Função Administrador do Exchange Server
Função Administrador de Destinatários do Exchange
Grupo Administradores local
Dica
Se você estiver executando o Microsoft Exchange Server 2007 em um computador que também funciona como um controlador de domínio, para mover uma caixa de correio para um banco de dados nesse servidor, a função Administrador de Servidor do Exchange deve ser delegada à conta em uso, mas a função Administrador de Destinatário do Exchange não precisa ser delegada à conta.
Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão.
No Exchange 2007 Service Pack 1 (SP1), se você mover uma caixa de correio para a qual um dispositivo móvel esteja sincronizado usando o Exchange ActiveSync, o estado de sincronização da caixa de correio é atualizado automaticamente durante a movimentação. Não é necessário executar nenhuma etapa adicional, e o usuário não precisa sincronizar novamente o dispositivo após uma movimentação de caixa de correio.
Parâmetros
| Parâmetro | Necessário | Tipo | Descrição |
|---|---|---|---|
ConfigurationOnly |
Necessário |
System.Management.Automation.SwitchParameter |
O parâmetro ConfigurationOnly altera o local do servidor Exchange no serviço de diretório do Active Directory. Use esse parâmetro para direcionar a caixa de correio para um servidor funcional. O conteúdo da caixa de correio não é movido. Para usar esse parâmetro, a caixa de correio de destino deve estar localizada em um servidor Exchange 2007. O parâmetro ConfigurationOnly não permite que você altere um local de caixa de correio do Exchange 2007 para um local de caixa de correio do Exchange 2003 ou Exchange 2000. Além disso, recomendamos que o servidor de Caixa de Correio de origem esteja disponível ao usar esse parâmetro. Se o servidor de Caixa de Correio não estiver disponível, a operação irá demorar mais do que o previsto. |
Identity |
Necessário |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
O parâmetro Identity especifica a identificação do destinatário da única caixa de correio a ser movida. Se o comando Get-Mailbox for canalizado, esse parâmetro não será necessário. |
TargetDatabase |
Necessário |
Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter |
O parâmetro TargetDatabase especifica o banco de dados para o qual a caixa de correio será movida. Se o comando Get-Mailbox for canalizado, esse parâmetro não será necessário. Se você não especificar o nome do servidor, o cmdlet procurará o banco de dados no servidor local. Se você tiver vários bancos de dados com o mesmo nome no mesmo servidor, deverá especificar o grupo de armazenamento. |
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 que você especificar no corpo da mensagem, conteúdo do anexo ou assunto, ele exportará essas mensagens. 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 há duplicatas de itens existentes e sem remover itens duplicados. Recomendamos o uso do parâmetro AllowDuplicates junto com o parâmetro IncludeFolders. |
AllowMerge |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro AllowMerge especifica a mesclagem de caixas de correio, se já houver uma caixa de correio. Você pode usar esse parâmetro para mover uma caixa de correio entre organizações diferentes, mesmo se já houver uma caixa de correio de destino. O conteúdo da caixa de correio está mesclado no destino. Esse parâmetro não poderá ser usado se o parâmetro NTAccountOU for usado. Se você especificar este parâmetro, as regras do usuário não serão movidas para o destino. |
AttachmentFilenames |
Opcional |
System.String[] |
O parâmetro AttachmentFilenames especifica os anexos a serem incluídos na movimentação. Nomes de arquivos podem incluir qualquer tipo de arquivo e caracteres curinga. |
BadItemLimit |
Opcional |
System.Int32 |
O parâmetro BadItemLimit especifica o número de itens incorretos a serem ignorados. Use 0 para não ignorar itens incorretos. O intervalo de entrada válido para esse parâmetro é de 0 a 2.147.483.647. |
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. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController no comando. |
EndDate |
Opcional |
System.DateTime |
O parâmetro EndDate especifica a data de término da filtragem do conteúdo que será movido da caixa de correio de origem. Somente itens da caixa de correio com data anterior ou igual à data de término serão movidos. 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 movimentação. |
GlobalCatalog |
Opcional |
Microsoft.Exchange.Data.Fqdn |
O parâmetro GlobalCatalog especifica o catálogo global no qual serão executadas operações de pesquisa na floresta de destino. |
IgnorePolicyMatch |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro IgnorePolicyMatch especifica se deve haver correspondência a diretivas de destinatário. |
IgnoreRuleLimitErrors |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro IgnoreRuleLimitErrors especifica que o comando não moverá as regras do usuário para a conta de destino do Microsoft Exchange Server 2003 ou do Exchange 2000 Server. Você pode especificar este parâmetro para evitar o limite de regras de 32K do Microsoft Outlook. Por padrão, o cmdlet Move-Mailbox moverá regras, tanto em movimentações de floresta única quanto em movimentações entre florestas. |
IncludeFolders |
Opcional |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
O parâmetro IncludeFolders especifica a lista de pastas a serem incluídas durante a movimentação. |
Locale |
Opcional |
System.Globalization.CultureInfo |
O parâmetro Locale especifica o locale de mensagens a serem movidas. O comando moverá somente mensagens com o locale que você especificar. |
MaxThreads |
Opcional |
System.Int32 |
O parâmetro MaxThreads especifica o número máximo de threads a serem usados. O intervalo de entrada válido para esse parâmetro é de 0 a 30. Dica O intervalo aceitável de threads a ser usado é determinado pelo desempenho do sua organização do Exchange. Recomendamos que você execute os testes de validação para determinar um intervalo aceitável para seu ambiente antes de mover várias caixas de correio ao mesmo tempo. |
NTAccountOU |
Opcional |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
O parâmetro NTAccountOU especifica a unidade organizacional em que as contas do Microsoft Windows NT são criadas. Esse parâmetro não poderá ser usado se o parâmetro AllowMerge for usado. |
PreserveMailboxSizeLimit |
Opcional |
System.Management.Automation.SwitchParameter |
O parâmetro PreserveMailboxSizeLimit especifica se as opções de limite de tamanho da caixa de correio de origem devem ser aplicadas à caixa de correio de destino. |
RecipientKeywords |
Opcional |
System.String[] |
O parâmetro RecipientKeywords especifica endereços de email de destinatários ou nomes de exibição. Se o comando encontrar uma mensagem com destinatário que seja o mesmo que a palavra-chave do destinatário que você especificou, ele moverá a mensagem. Se a palavra-chave especificada for a mesma que um grupo de distribuição que seja o destinatário de uma mensagem, a mensagem será movida. 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. |
RetryInterval |
Opcional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
O parâmetro RetryInterval especifica o intervalo para recuperação do status da movimentação do servidor. |
RetryTimeout |
Opcional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
O parâmetro RetryTimeout especifica o tempo limite de movimentação de uma caixa de correio. |
SenderKeywords |
Optional |
System.String[] |
O parâmetro SenderKeywords especifica endereços de email de remetentes ou nomes de exibição. Se o comando encontrar uma mensagem com remetente que seja o mesmo que a palavra-chave do remetente que você especificou, ele moverá a mensagem. |
SourceForestCredential |
Opcional |
System.Management.Automation.PSCredential |
O parâmetro SourceForestCredential especifica as credenciais utilizadas ao conectar à caixa de correio de origem. |
SourceForestGlobalCatalog |
Opcional |
Microsoft.Exchange.Data.Fqdn |
O parâmetro SourceForestGlobalCatalog especifica o catálogo global no qual serão executadas operações de pesquisa na floresta de origem. |
SourceMailboxCleanupOptions |
Opcional |
Microsoft.Exchange.Management.RecipientTasks.MoveMailboxSourceCleanupType |
O parâmetro SourceMailboxCleanupOptions especifica opções de limpeza para a caixa de correio de origem. Esse parâmetro não poderá ser usado se o parâmetro AllowMerge for usado. Os valores possíveis são:
|
StartDate |
Opcional |
System.DateTime |
O parâmetro StartDate especifica a data de início da filtragem do conteúdo que será movido da caixa de correio de origem. Somente itens da caixa de correio com data posterior à data de início serão movidos. 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. |
TargetForestCredential |
Opcional |
System.Management.Automation.PSCredential |
O parâmetro TargetForestCredential especifica as credenciais utilizadas ao conectar ao banco de dados de destino. |
UseRusServer |
Opcional |
System.String |
O parâmetro UseRusServer instrui o comando a usar o servidor do Serviço de Atualização de Destinatário especificado para obter e definir os atributos de usuário do Active Directory e de caixa de correio. |
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. |
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 um valor com o parâmetro WhatIf. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
|
Exemplo
No primeiro exemplo, o comando Move-Mailbox é usado para mover a caixa de correio de John Peoples (john@contoso.com) para um novo banco de dados de caixa de correio denominado NewMailboxDatabase.
Os últimos quatro exemplos mostram como usar o parâmetro SourceMailboxCleanupOptions ao mover caixas de correio entre florestas. No segundo exemplo, o comando Move-Mailbox é utilizado para mover a caixa de correio de John Peoples (john@contoso.com) para um novo banco de dados de caixa de correio em outra floresta. Neste cenário, as empresas Contoso e Fabrikam foram mescladas e as caixas de correio da floresta contoso estão sendo movidas para a floresta fabrikam. Este exemplo assume que você moveu primeiro a conta de usuário de john da floresta contoso para a floresta fabrikam usando a Ferramenta de Migração versão 3.0 (ADMT v3) do Active Directory.
No terceiro exemplo, você está adicionando o Exchange 2007 Service Pack 1 (SP1) em uma nova floresta e está movendo caixas de correio para o novo servidor. Você planeja usar o agente de gerenciamento de sincronização da GAL (lista de endereços global) no Microsoft Integration Identity Server (MIIS) para sincronizar usuários entre as florestas. Contudo, você está movendo muitos usuários de uma vez e não quer esperar que a sincronização da GAL do MIIS crie contatos para que os usuários da floresta de origem possam enviar email para os usuários movidos da nova floresta. Em vez disso, você usa o valor CreateSourceContact do SourceMailboxCleanupOptions para criar um contato para John na floresta de origem.
No quarto exemplo, você está movendo de uma floresta única para uma floresta de recursos e, então, você move as caixas de correio para a nova floresta do Exchange mas não exclui a conta de usuário de origem. Em vez disso, você habilita a conta de usuário de origem para email para que o usuário possa receber email de usuários da floresta original que você ainda não moveu para a nova floresta do Exchange. Essa é uma situação de floresta híbrida.
O quinto exemplo também é um exemplo de mover de uma floresta única para uma floresta de recursos. Você move as caixas de correio para a nova floresta do Exchange sem excluir a conta de usuário de origem. Nesse exemplo, você está movendo todas as caixas de correio para a nova floresta do Exchange e irá remover completamente o Exchange da floresta de origem. Não é necessário habilitar a conta de usuário de origem para email porque você irá remover o Exchange da floresta de origem e não estará em um cenário de floresta híbrida. Em vez disso, você exclui apenas a caixa de correio de origem após movê-la para a nova floresta do Exchange, deixando a conta de usuário de origem.
Move-Mailbox john@contoso.com -TargetDatabase NewMailboxDatabase
Move-Mailbox -TargetDatabase "Target Server\First Storage Group\Mailbox Database" -Identity john -GlobalCatalog GC01.fabrikam.com -SourceForestGlobalCatalog GC02.contoso.com -NTAccountOU "OU=OrgUnit01,DC=fabrikam,DC=com" -SourceForestCredential $SourceCredential -TargetForestCredential $TargetCredential -SourceMailboxCleanupOptions DeleteSourceNTAccount
Move-Mailbox -TargetDatabase "Target Server\First Storage Group\Mailbox Database" -Identity john -GlobalCatalog GC01.fabrikam.com -SourceForestGlobalCatalog GC02.contoso.com -NTAccountOU "OU=OrgUnit01,DC=fabrikam,DC=com" -SourceForestCredential $SourceCredential -TargetForestCredential $TargetCredential -SourceMailboxCleanupOptions CreateSourceContact
Move-Mailbox -TargetDatabase "Target Server\First Storage Group\Mailbox Database" -Identity john -GlobalCatalog GC01.fabrikam.com -SourceForestGlobalCatalog GC02.contoso.com -NTAccountOU "OU=OrgUnit01,DC=fabrikam,DC=com" -SourceForestCredential $SourceCredential -TargetForestCredential $TargetCredential -SourceMailboxCleanupOptions MailEnableSourceAccount
Move-Mailbox -TargetDatabase "Target Server\First Storage Group\Mailbox Database" -Identity john -GlobalCatalog GC01.fabrikam.com -SourceForestGlobalCatalog GC02.contoso.com -NTAccountOU "OU=OrgUnit01,DC=fabrikam,DC=com" -SourceForestCredential $SourceCredential -TargetForestCredential $TargetCredential -SourceMailboxCleanupOptions DeleteSourceMailbox