Set-MigrationBatch

Sintaxe

Default (Default)

Set-MigrationBatch
    [-Identity] <MigrationBatchIdParameter>
    [-AddUsers]
    [-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

Exemplos

Exemplo 1

Set-MigrationBatch -Identity MigrationBatch01 -ApproveSkippedItems

Exemplo 2

`Set-MigrationBatch -Identity MigrationBatch01 -AddUsers -CSVData ([System.IO.File]::ReadAllBytes('C:\Data\MigrationBatch01.csv'))`

Parâmetros

-AddUsers

Aplicável: Exchange Online

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

A opção AddUsers especifica se os usuários devem ser adicionados incrementalmente a um lote de migração existente sem recriar ou reenviar o lote inteiro. Não é preciso especificar um valor com essa opção.

Você usa essa opção com o parâmetro CSVData. O arquivo CSV especificado deve ter o mesmo formato do arquivo CSV usado para criar o lote de migração. Somente as novas entradas no arquivo CSV são processadas. Para obter mais informações, consulte o Exemplo 2 na seção Exemplos.

Propriedades do parâmetro

Conjuntos de parâmetros

-AllowIncrementalSyncs

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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 entra no estado Parado após a conclusão da sincronização inicial. Para concluir um lote de migração para movimentações locais, movimentações entre florestas ou migrações de movimentação remota, você precisa habilitar a sincronização incremental.

Propriedades do parâmetro

Conjuntos de parâmetros

-AllowUnknownColumnsInCsv

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 com erros ortográficos). 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 valor é o padrão.

Propriedades do parâmetro

Conjuntos de parâmetros

-ApproveSkippedItems

Aplicável: Exchange Online

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 da hora atual como aprovados. 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 a aprovação dos 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 permitido da mensagem configurado para o locatário ou foram detectados como ausentes na caixa de correio de destino quando a migração está pronta para ser concluída.

Para obter mais informações sobre valores de tamanho máximo de mensagem, consulte Limites do Exchange Online.

Propriedades do parâmetro

Conjuntos de parâmetros

-AutoRetryCount

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-BadItemLimit

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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 localizados 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 inválido for detectado. Se você concordar em deixar alguns itens inválidos para trás, poderá definir esse parâmetro como um valor razoável (recomendamos 10 ou menos) para que a solicitação de migração possa continuar. Se muitos itens defeituosos forem detectados, considere usar o cmdlet New-MailboxRepairRequest para tentar consertar itens corrompidos na caixa de correio de origem e tente a solicitação de migração novamente.

Observação: esse parâmetro foi preterido no serviço baseado em nuvem. Os administradores devem revisar a Pontuação de Consistência de Dados e todos os itens ignorados antes da conclusão da migração.

Propriedades do parâmetro

Conjuntos de parâmetros

-CompleteAfter

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

O parâmetro CompleteAfter especifica um atraso antes que o lote seja concluído. A migração de dados para o lote começa, mas a conclusão não começa 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/aaaa, 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".

No 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 em seu 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.

• Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, 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 reconhecer o comando antes de continuar.

Propriedades do parâmetro

Conjuntos de parâmetros

-CSVData

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 byte usando a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Você pode usar esse comando como o valor do parâmetro ou pode 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 do RBAC. Todas as caixas de correio especificadas no arquivo CSV são migradas, mesmo que estejam fora do escopo do RBAC (por exemplo, uma UO) que concede ao administrador permissões para migrar caixas de correio.

Propriedades do parâmetro

Conjuntos de parâmetros

-DomainController

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-Identity

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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)

Propriedades do parâmetro

Conjuntos de parâmetros

-LargeItemLimit

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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 obter mais informações sobre valores máximos de tamanho de mensagem, consulte Limites de tamanho de mensagem no Exchange Server.

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ê concordar em deixar alguns itens grandes para trás, poderá definir esse parâmetro como um valor razoável (recomendamos 10 ou menos) para que a solicitação de migração possa continuar.

Observação: esse parâmetro foi preterido no serviço baseado em nuvem. Os administradores devem revisar a Pontuação de Consistência de Dados e todos os itens ignorados antes da conclusão da migração.

Propriedades do parâmetro

Conjuntos de parâmetros

-MoveOptions

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-NotificationEmails

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 as 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".

Propriedades do parâmetro

Conjuntos de parâmetros

-Partition

Aplicável: Exchange Online

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

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

Propriedades do parâmetro

Conjuntos de parâmetros

-ReportInterval

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 relatórios nunca devem ser enviados para este lote.

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

Propriedades do parâmetro

Conjuntos de parâmetros

-SkipMerging

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-SkipMoving

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Esse parâmetro é 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-SkipReports

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Propriedades do parâmetro

Conjuntos de parâmetros

-SourcePublicFolderDatabase

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Propriedades do parâmetro

Conjuntos de parâmetros

-StartAfter

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro StartAfter especifica um atraso antes que a migração de dados para os usuários dentro do lote seja iniciada. A migração está preparada, mas a migração de dados real para usuários no lote não começa até a data/hora que você especificar 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/aaaa, 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".

No 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 em seu 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.

Propriedades do parâmetro

Conjuntos de parâmetros

-SyncNow

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O comutador SyncNow inicia uma sincronização imediata para os 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 as movimentações de integração usando a opção imediatamente antes da conclusão da movimentação. Para migrações IMAP, você pode usar essa opção após a alternância do registro MX.

Propriedades do parâmetro

Conjuntos de parâmetros

-Update

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O comutador de atualização define o sinalizador de atualização 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, do lote e do usuário ao processo de migração.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

Input types

Saídas

Output types