Set-MigrationUser
Esse cmdlet é funcional apenas no serviço baseado em nuvem.
Use o cmdlet Set-MigrationUser para modificar as configurações de migração de um usuário em um lote de migração existente.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Set-MigrationUser
[-Identity] <MigrationUserIdParameter>
[-ApproveSkippedItems]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-LargeItemLimit <Unlimited>]
[-Partition <MailboxIdParameter>]
[-StartAfter <DateTime>]
[-SyncNow]
[-WhatIf]
[<CommonParameters>] Description
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-MigrationUser -Identity laura@contoso.com -LargeItemLimit 15 -BadItemLimit 15Este exemplo altera o limite de item grande e o limite de item ruim para o usuário laura@contoso.com em um lote de migração existente.
Exemplo 2
Set-MigrationUser -Identity laura@contoso.com -ApproveSkippedItemsEste exemplo aprova todos os itens ignorados encontrados para o usuário laura@contoso.com em um lote de migração existente.
Parâmetros
-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.
Não é preciso especificar um valor com essa opção.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 preterido. 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 2016, Exchange Server 2019, Exchange Online |
-CompleteAfter
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro CompleteAfter especifica um atraso antes que o usuário seja concluído. A migração de dados para o usuário será iniciada, mas não será concluída 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 de data/hora para este parâmetro, use uma das opções a seguir:
- Especifique o valor de data/hora em UTC: por exemplo, "2021-05-06 14:30:00z".
- Especifique o valor de data/hora como uma fórmula que converte a data/hora no fuso horário local em UTC: Por exemplo,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para mais informações, consulte Get-Date.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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 2016, Exchange Server 2019, Exchange Online |
-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 2016, Exchange Server 2019 |
-Identity
O parâmetro Identity especifica o endereço de email do usuário que está sendo migrado.
Você também pode identificar o usuário pelo valor GUID na propriedade MigrationUser a partir da saída do cmdlet Get-MigrationUser. Esse método de identificação será útil se você enviou acidentalmente o mesmo usuário em vários lotes.
| Type: | MigrationUserIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | 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:
- Exchange 2016: limites de tamanho da mensagem em Exchange Server
- Exchange Online: Limites do Exchange Online
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 preterido. 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 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 |
-StartAfter
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro StartAfter especifica um atraso antes da migração de dados para o usuário ser iniciada. A migração será preparada, mas a migração de dados real para o usuário 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 de data/hora para este parâmetro, use uma das opções a seguir:
- Especifique o valor de data/hora em UTC: por exemplo, "2021-05-06 14:30:00z".
- Especifique o valor de data/hora como uma fórmula que converte a data/hora no fuso horário local em UTC: Por exemplo,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para mais informações, consulte Get-Date.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SyncNow
A opção SyncNow especifica se deve disparar uma sincronização incremental para o usuário migrado. Não é preciso especificar um valor com essa opção.
Uma sincronização incremental copia as alterações recentes da caixa de correio de origem para a caixa de correio de destino. Você pode executar uma sincronização incremental antes de concluir o lote de migração para reduzir o tempo necessário para a conclusã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 2016, Exchange Server 2019, Exchange Online |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de