Set-MigrationBatch

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Set-MigrationBatch para atualizar uma solicitação de migração para um lote de usuários. Para mais informações, consulte New-MigrationBatch.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Set-MigrationBatch
   [-Identity] <MigrationBatchIdParameter>
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-ApproveSkippedItems]
   [-AutoRetryCount <Int32>]
   [-BadItemLimit <Unlimited>]
   [-CSVData <Byte[]>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LargeItemLimit <Unlimited>]
   [-MoveOptions <MultiValuedProperty>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <TimeSpan>]
   [-SkipMerging <MultiValuedProperty>]
   [-SkipMoving <MultiValuedProperty>]
   [-SkipReports <Boolean>]
   [-SourcePublicFolderDatabase <DatabaseIdParameter>]
   [-StartAfter <DateTime>]
   [-SyncNow]
   [-Update]
   [-WhatIf]
   [<CommonParameters>]

Description

O cmdlet Set-MigrationBatch configura seus lotes de migração existentes para migrar caixas de correio e dados de caixa de correio em um destes cenários:

  • Movimentação local
  • Movimentação entre florestas
  • Movimentação remota
  • Migração de substituição do Exchange
  • Migração do Exchange em etapas
  • Migração do IMAP
  • Migração do Google Workspace (anteriormente G Suite)

Algumas configurações podem ser aplicadas tanto ao lote quanto a usuários individuais no lote. É importante observar que, quando uma configuração é aplicada a um usuário, ela substituirá qualquer configuração correspondente no lote.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Set-MigrationBatch -Identity MigrationBatch01 -ApproveSkippedItems

Este exemplo atualiza MigrationBatch01 aprovando todos os itens ignorados para todos os usuários do lote detectados anteriormente.

Parâmetros

-AllowIncrementalSyncs

Este parâmetro está disponível somente no Exchange local.

O parâmetro AllowIncrementalSyncs especifica se é para habilitar ou desabilitar sincronizações incrementais. Os valores válidos são:

  • $true: a sincronização incremental está habilitada. Qualquer mensagem nova que for enviada para a caixa de correio de origem é copiada para a caixa de correio de destino correspondente a cada 24 horas.
  • $false: a sincronização incremental está desabilitada. O lote de migração entrará no estado Parado depois que a sincronização inicial for concluída. Para concluir um lote de migração para movimentos locais, movimentos entre florestas ou migrações remotas, você precisa habilitar a sincronização incremental.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-AllowUnknownColumnsInCsv

O parâmetro AllowUnknownColumnsInCsv especifica se serão permitidas colunas adicionais no arquivo CSV que não serão usadas pela migração. Os valores válidos são:

  • $true: a migração ignora (ignora silenciosamente) colunas desconhecidas no arquivo CSV (incluindo colunas opcionais com cabeçalhos de coluna mal escritos). Todas as colunas desconhecidas são tratadas como colunas adicionais que não são usadas pela migração.
  • $false: a migração falhará se houver colunas desconhecidas no arquivo CSV. Essa configuração protege contra erros ortográficos nos títulos de colunas. Esse é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ApproveSkippedItems

Esse parâmetro só está disponível no serviço baseado em nuvem.

A opção ApproveSkippedItems marca todos os itens ignorados que foram descobertos antes do momento atual, conforme aprovado. Não é preciso especificar um valor com essa opção.

Se a perda de dados detectada durante essa migração for significativa, a migração não poderá ser concluída sem aprovar itens ignorados. Os itens podem ter sido ignorados porque estão corrompidos na caixa de correio de origem e não podem ser copiados para a caixa de correio de destino, são maiores do que o tamanho máximo da mensagem permitido configurado para o locatário ou foram detectados como ausentes da caixa de correio de destino quando a migração está pronta para ser concluída.

Para obter mais informações sobre valores máximos de tamanho de mensagem, consulte o tópico a seguir Exchange Online Limites.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-AutoRetryCount

Este parâmetro está disponível somente no Exchange local.

O parâmetro AutoRetryCount especifica o número de tentativas para reiniciar o lote de migração para migrar as caixas de correio que encontraram erros.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-BadItemLimit

O parâmetro BadItemLimit especifica o número máximo de itens inválidos permitidos antes que a solicitação de migração falhe. Um item inválido é um item corrompido na caixa de correio de origem que não pode ser copiado para a caixa de correio de destino. Os itens ausentes também estão incluídos no limite de itens inválidos. Itens ausentes são itens na caixa de correio de origem que não podem ser encontrados na caixa de correio de destino quando a solicitação de migração está pronta para ser concluída.

Uma entrada válida para esse parâmetro é um número inteiro ou o valor ilimitado. O valor padrão é 0, o que significa que a solicitação de migração falhará se algum item ruim for detectado. Se você estiver bem em deixar alguns itens ruins para trás, poderá definir esse parâmetro como um valor razoável (recomendamos 10 ou menor) para que a solicitação de migração possa continuar. Se muitos itens ruins forem detectados, considere usar o cmdlet New-MailboxRepairRequest para tentar corrigir itens corrompidos na caixa de correio de origem e tente a solicitação de migração novamente.

Observação: esse parâmetro está sendo substituído no serviço baseado em nuvem. No futuro, se você não usar esse parâmetro, será usada a semântica de aprovação de Itens Ignorados.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-CompleteAfter

Esse parâmetro é funcional apenas no serviço baseado em nuvem.

O parâmetro CompleteAfter especifica um atraso antes da conclusão do lote. A migração de dados para o lote será iniciada, mas a conclusão não será iniciada até a data/hora especificada com esse parâmetro.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Em Exchange Online PowerShell, se você especificar um valor de data/hora sem um fuso horário, o valor estará em UTC (Tempo Universal Coordenado). Para especificar um valor, use uma das seguintes opções:

  • Especifique o valor de data/hora em UTC: por exemplo, "7/30/2020 9:00PM Z".
  • Especifique o valor de data/hora no fuso horário local. Por exemplo, "7/30/2020 9:00PM -700". O valor será convertido em UTC se você não usar o parâmetro TimeZone.
Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-CSVData

Este parâmetro está disponível somente no Exchange local.

O parâmetro CSVData especifica o arquivo CSV que contém as informações sobre as caixas de correio do usuário a serem movidas ou migradas. Os atributos necessários no cabeçalho do arquivo CSV variam de acordo com o tipo de migração.

Um valor válido para esse parâmetro exige que você leia o arquivo em um objeto codificado por bytes usando a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Você pode usar esse comando como o valor do parâmetro ou gravar a saída em uma variável ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usar a variável como o valor do parâmetro ($data).

Observação: esse parâmetro não valida a disponibilidade das caixas de correio com base no escopo RBAC. Todas as caixas de correio especificadas no arquivo CSV serão migradas, mesmo que estejam fora do escopo RBAC (por exemplo, uma OU) que fornece permissões de administrador para migrar caixas de correio.

Type:Byte[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identity especifica o lote de migração que você deseja modificar. Você pode usar qualquer valor que identifique exclusivamente o lote de migração. Por exemplo:

  • Nome (o valor da propriedade Identity)
  • GUID (o valor da propriedade BatchGuid)
Type:MigrationBatchIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-LargeItemLimit

O parâmetro LargeItemLimit especifica o número máximo de itens grandes permitidos antes que a solicitação de migração falhe. Um item grande é uma mensagem na caixa de correio de origem que excede o tamanho máximo de mensagem permitido na caixa de correio de destino. Se a caixa de correio de destino não possuir um valor de tamanho de mensagem máximo especificamente configurado, será usado o valor da organização.

Para saber mais sobre valores máximos de tamanho de mensagem, confira os seguintes tópicos:

Uma entrada válida para esse parâmetro é um número inteiro ou o valor ilimitado. O valor padrão é 0, o que significa que a solicitação de migração falhará se algum item grande for detectado. Se você estiver bem ao deixar alguns itens grandes para trás, poderá definir esse parâmetro como um valor razoável (recomendamos 10 ou menor) para que a solicitação de migração possa continuar.

Observação: esse parâmetro está sendo substituído no serviço baseado em nuvem. No futuro, se você não usar esse parâmetro, será usada a semântica de aprovação de Itens Ignorados.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-MoveOptions

O parâmetro MoveOptions especifica as etapas da migração que você deseja ignorar para fins de depuração. Não use esse parâmetro, a menos que você seja orientado a fazer isso pelo Serviço de Suporte e Atendimento ao Cliente Microsoft ou documentação específica.

Não use esse parâmetro com o parâmetro SkipMoving.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-NotificationEmails

O parâmetro NotificationEmails especifica um ou mais endereços de email para os quais são enviados relatórios de status da migração.

Se você não usar esse parâmetro, o relatório de status não será enviado.

Para inserir vários valores e substituir quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Partition

Esse parâmetro só está disponível no serviço baseado em nuvem.

Esse parâmetro está reservado para uso interno da Microsoft.

Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ReportInterval

O parâmetro ReportInterval especifica a frequência com que os relatórios enviados por email devem ser enviados para os endereços de email listados em NotificationEmails.

Por padrão, os relatórios enviados por email são enviados a cada 24 horas para um lote. Definir esse valor como 0 indica que os relatórios nunca devem ser enviados para este lote.

Esse parâmetro só deve ser usado no serviço baseado em nuvem.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SkipMerging

O parâmetro SkipMerging especifica as etapas da migração que você deseja ignorar para fins de depuração. Não use esse parâmetro, a menos que você seja orientado a fazer isso pelo Serviço de Suporte e Atendimento ao Cliente Microsoft ou documentação específica.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SkipMoving

Esse parâmetro foi substituído pelo parâmetro MoveOptions.

O parâmetro SkipMoving especifica as etapas da migração que você deseja ignorar para fins de depuração. Não use esse parâmetro, a menos que você seja orientado a fazer isso pelo Serviço de Suporte e Atendimento ao Cliente Microsoft ou documentação específica.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SkipReports

A opção SkipReports especifica que você deseja ignorar o relatório automático para a migração. Não é preciso especificar um valor com essa opção.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourcePublicFolderDatabase

Este parâmetro está disponível somente no Exchange local.

O parâmetro SourcePublicFolderDatabase especifica o banco de dados de pasta pública de origem usado em uma migração de pasta pública. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • GUID
Type:DatabaseIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-StartAfter

O parâmetro StartAfter especifica um atraso antes que a migração de dados para os usuários no lote seja iniciada. A migração será preparada, mas a migração real de dados para usuários no lote não será iniciada até a data/hora especificada com esse parâmetro.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Em Exchange Online PowerShell, se você especificar um valor de data/hora sem um fuso horário, o valor estará em UTC (Tempo Universal Coordenado). Para especificar um valor, use uma das seguintes opções:

  • Especifique o valor de data/hora em UTC: por exemplo, "7/30/2020 9:00PM Z".
  • Especifique o valor de data/hora no fuso horário local. Por exemplo, "7/30/2020 9:00PM -700". O valor será convertido em UTC se você não usar o parâmetro TimeZone.
Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SyncNow

A opção SyncNow inicia uma sincronização imediata para usuários que já atingiram o status sincronizado, mas não retoma nenhum usuário com falha. Não é preciso especificar um valor com essa opção.

Você pode usar essa opção para acelerar os movimentos de integração usando o comutador pouco antes da conclusão da movimentação. Para migrações IMAP, você pode usar essa opção após a alternância de registro MX.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Update

A opção Atualizar define o sinalizador Atualizar no lote de migração. Não é preciso especificar um valor com essa opção.

O sinalizador De atualização dispara o Serviço de Migração para reaplicar todas as configurações do ponto de extremidade, lote e usuário para o processo de migração.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.