Compartilhar via


Move-Mailbox (RTM)

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-05

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>] [-DomainController <Fqdn>] [-GlobalCatalog <Fqdn>] [-IgnorePolicyMatch <SwitchParameter>] [-IgnoreRuleLimitErrors <SwitchParameter>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-ValidateOnly <SwitchParameter>]

move-Mailbox -Identity <MailboxIdParameter> -TargetDatabase <DatabaseIdParameter> [-AllContentKeywords <String[]>] [-AllowMerge <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-DomainController <Fqdn>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IgnorePolicyMatch <SwitchParameter>] [-IgnoreRuleLimitErrors <SwitchParameter>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-NTAccountOU <OrganizationalUnitIdParameter>] [-PreserveMailboxSizeLimit <SwitchParameter>] [-ReportFile <LocalLongFullPath>] [-RetryInterval <EnhancedTimeSpan>] [-RetryTimeout <EnhancedTimeSpan>] [-SourceForestCredential <PSCredential>] [-SourceForestGlobalCatalog <Fqdn>] [-SourceMailboxCleanupOptions <None | DeleteSourceMailbox | DeleteSourceNTAccount>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-TargetForestCredential <PSCredential>] [-ValidateOnly <SwitchParameter>]

move-Mailbox -Identity <MailboxIdParameter> -ConfigurationOnly <SwitchParameter> -TargetDatabase <DatabaseIdParameter> [-BadItemLimit <Int32>] [-DomainController <Fqdn>] [-GlobalCatalog <Fqdn>] [-IgnorePolicyMatch <SwitchParameter>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-ValidateOnly <SwitchParameter>]

move-Mailbox -Identity <MailboxIdParameter> -TargetDatabase <DatabaseIdParameter> [-BadItemLimit <Int32>] [-DomainController <Fqdn>] [-GlobalCatalog <Fqdn>] [-IgnorePolicyMatch <SwitchParameter>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-ValidateOnly <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 Exchange 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 Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

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.

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 especificada no corpo da mensagem, no conteúdo do anexo ou no 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.

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.

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.

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 se as regras do usuário devem ser movidas para o Microsoft Exchange Server 2003 de destino ou conta do Exchange 2000 Server para evitar o limite de regras de 32K do Microsoft Outlook.

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.

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.

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 SourcMailboxCleanupOptions 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.

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.

ValidateOnly

Opcional

System.Management.Automation.SwitchParameter

O parâmetro ValidateOnly oferece a opção para validar a movimentação sem mover a caixa de correio.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

  

  

Exceções

Exceções Descrição

  

  

Exemplo

Neste 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.

Move-Mailbox john@contoso.com -TargetDatabase NewMailboxDatabase