Set-MigrationUser
Este cmdlet está funcional apenas no serviço baseado na cloud.
Utilize o cmdlet Set-MigrationUser para modificar as definições de migração de um utilizador num lote de migração existente.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
Set-MigrationUser
[-Identity] <MigrationUserIdParameter>
[-ApproveSkippedItems]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-LargeItemLimit <Unlimited>]
[-Partition <MailboxIdParameter>]
[-StartAfter <DateTime>]
[-SyncNow]
[-WhatIf]
[<CommonParameters>]
Description
Algumas definições podem ser aplicadas tanto ao lote como a utilizadores individuais dentro do lote. Uma definição aplicada a um utilizador substitui qualquer definição correspondente no lote.
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 15
Este exemplo altera o limite de itens grandes e o limite de itens incorretos para o utilizador laura@contoso.com num lote de migração existente.
Exemplo 2
Set-MigrationUser -Identity laura@contoso.com -ApproveSkippedItems
Este exemplo aprova todos os itens ignorados encontrados para o utilizador laura@contoso.com num lote de migração existente.
Parâmetros
-ApproveSkippedItems
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O comutador ApproveSkippedItems marca todos os itens ignorados que foram detetados antes da hora atual, conforme aprovado. Não é preciso especificar um valor com essa opção.
Se a perda de dados detetada durante esta 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 danificados 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 de mensagem permitido configurado para o inquilino ou foram detetados como em falta na caixa de correio de destino quando a migração está pronta para ser concluída.
Para obter mais informações sobre os valores máximos de tamanho da mensagem, veja o seguinte tópico Exchange Online Limites.
Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-BadItemLimit
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Online
O parâmetro BadItemLimit especifica o número máximo de itens incorretos permitidos antes de o pedido de migração falhar. 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. Os itens em falta são itens na caixa de correio de origem que não podem ser encontrados na caixa de correio de destino quando o pedido de migração está pronto para ser concluído.
Uma entrada válida para esse parâmetro é um número inteiro ou o valor ilimitado. O valor predefinido é 0, o que significa que o pedido de migração falhará se forem detetados itens incorretos. Se não se importa de deixar alguns itens incorretos para trás, pode definir este parâmetro para um valor razoável (recomendamos 10 ou inferior) para que o pedido de migração possa prosseguir. Se forem detetados demasiados itens incorretos, considere utilizar o cmdlet New-MailboxRepairRequest para tentar corrigir itens danificados na caixa de correio de origem e tente o pedido de migração novamente.
Nota: este parâmetro está a ser preterido. No futuro, se não utilizar este parâmetro, são utilizadas semânticas de aprovação de Item Ignorado.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CompleteAfter
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro CompleteAfter especifica um atraso antes de o utilizador ser concluído. A migração de dados para o utilizador é iniciada, mas não é concluída até à data/hora que especificar com este 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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 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 especificar um valor de data/hora sem um fuso horário, o valor estará em Hora Universal Coordenada (UTC).
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 para UTC: por exemplo,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para mais informações, consulte Get-Date.
Propriedades do parâmetro
| Tipo: | DateTime |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Online
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, 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 confirmar o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2016, Exchange Server 2019
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
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Online
O parâmetro Identidade especifica o endereço de e-mail do utilizador que está a ser migrado.
Também pode identificar o utilizador pelo valor GUID na propriedade MigrationUser a partir da saída do cmdlet Get-MigrationUser. Este método de identificação é útil se tiver submetido acidentalmente o mesmo utilizador em vários lotes.
Propriedades do parâmetro
| Tipo: | MigrationUserIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-LargeItemLimit
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Online
O parâmetro LargeItemLimit especifica o número máximo de itens grandes permitidos antes de o pedido de migração falhar. 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 de mensagens no 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 predefinido é 0, o que significa que o pedido de migração falhará se forem detetados itens grandes. Se não se importa de deixar alguns itens grandes para trás, pode definir este parâmetro para um valor razoável (recomendamos 10 ou inferior) para que o pedido de migração possa prosseguir.
Nota: este parâmetro está a ser preterido. No futuro, se não utilizar este parâmetro, são utilizadas semânticas de aprovação de Item Ignorado.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-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
| Tipo: | MailboxIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-StartAfter
Aplicável: Exchange Online
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro StartAfter especifica um atraso antes do início da migração de dados para o utilizador. A migração está preparada, mas a migração de dados real para o utilizador só é iniciada na data/hora que especificar com este 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 utilizar o formato de data abreviada MM/dd/aaaa, introduza 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 especificar um valor de data/hora sem um fuso horário, o valor estará em Hora Universal Coordenada (UTC).
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 para UTC: por exemplo,
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para mais informações, consulte Get-Date.
Propriedades do parâmetro
| Tipo: | DateTime |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SyncNow
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Online
O comutador SyncNow especifica se pretende acionar uma sincronização incremental para o utilizador 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. Pode efetuar uma sincronização incremental antes de concluir o lote de migração para reduzir o tempo necessário para a conclusão.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.