Set-MigrationUser

Questo cmdlet funziona solo nel servizio basato sul cloud.

Utilizzare il cmdlet Set-MigrationUser per modificare le impostazioni di migrazione relative a un utente di un batch di migrazione esistente.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Set-MigrationUser
   [-Identity] <MigrationUserIdParameter>
   [-ApproveSkippedItems]
   [-BadItemLimit <Unlimited>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LargeItemLimit <Unlimited>]
   [-Partition <MailboxIdParameter>]
   [-StartAfter <DateTime>]
   [-SyncNow]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Alcune impostazioni possono essere applicate sia al batch che ai singoli utenti all'interno del batch. È importante notare che quando un'impostazione viene applicata a un utente, sostituisce qualsiasi impostazione corrispondente nel batch.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-MigrationUser -Identity laura@contoso.com -LargeItemLimit 15 -BadItemLimit 15

In questo esempio vengono modificati il limite di elementi di grandi dimensioni e il limite di elementi non valido per l'utente laura@contoso.com in un batch di migrazione esistente.

Esempio 2

Set-MigrationUser -Identity laura@contoso.com -ApproveSkippedItems

Questo esempio approva tutti gli elementi ignorati rilevati per l'utente laura@contoso.com in un batch di migrazione esistente.

Parametri

-ApproveSkippedItems

Questo parametro è disponibile solamente nel servizio basato su cloud.

L'opzione ApproveSkippedItems contrassegna tutti gli elementi ignorati individuati prima dell'ora corrente come approvati. Con questa opzione non è necessario specificare alcun valore.

Se la perdita di dati rilevata durante questa migrazione è significativa, la migrazione non potrà essere completata senza approvare gli elementi ignorati. Gli elementi potrebbero essere stati ignorati perché sono danneggiati nella cassetta postale di origine e non possono essere copiati nella cassetta postale di destinazione, sono maggiori delle dimensioni massime consentite dei messaggi configurati per il tenant oppure sono stati rilevati come mancanti nella cassetta postale di destinazione quando la migrazione è pronta per il completamento.

Per altre informazioni sui valori delle dimensioni massime dei messaggi, vedere l'argomento seguente Exchange Online Limiti.

Con questa opzione non è necessario specificare alcun valore.

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

-BadItemLimit

Il parametro BadItemLimit consente di specificare il numero massimo di elementi non validi consentiti prima che la richiesta di migrazione abbia un esito negativo. Un elemento non valido è un elemento danneggiato nella cassetta postale di origine che non è possibile copiare nella cassetta postale di destinazione. Rientrano negli elementi non validi anche gli elementi mancanti. Gli elementi mancanti sono elementi nella cassetta postale di origine che non è possibile rilevare nella cassetta postale di destinazione quando la richiesta di migrazione è pronta per essere completata.

L'input valido per questo parametro è un numero intero o il valore Unlimited. Il valore predefinito è 0, che indica che la richiesta di migrazione avrà esito negativo se vengono rilevati elementi non validi. Se si è d'accordo nel lasciare indietro alcuni elementi non validi, è possibile impostare questo parametro su un valore ragionevole (si consiglia 10 o inferiore) in modo che la richiesta di migrazione possa continuare. In caso di rilevamento di un numero eccessivo di elementi non validi, provare a utilizzare il cmdlet New-MailboxRepairRequest per tentare di correggere gli elementi corrotti nella cassetta postale di origine e procedere di nuovo con la richiesta di migrazione.

Nota: questo parametro è deprecato. In futuro, se non si usa questo parametro, verrà usata la semantica di approvazione di elementi ignorati.

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

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro CompleteAfter consente di specificare un ritardo prima del completamento dell'utente. La migrazione dei dati per l'utente verrà avviata, ma non verrà completata fino alla data/ora specificata con questo parametro.

Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 1° settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".

In Exchange Online PowerShell, se si specifica un valore di data/ora senza un fuso orario, il valore si trova nell'ora UTC (Coordinated Universal Time).

Per specificare un valore data/ora per questo parametro, utilizzare una delle opzioni seguenti:

  • Specificare il valore di data/ora in formato UTC: ad esempio, "2021-05-06 14:30:00z".
  • Specificare il valore di data/ora come formula che converte la data/ora nel fuso orario locale in formato UTC: ad esempio, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Per altre informazioni, vedere Get-Date.
Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
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

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, 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

Il parametro Identity consente di specificare l'indirizzo di posta elettronica oggetto della migrazione.

È anche possibile identificare l'utente per il valore GUID nella proprietà MigrationUser dell'output del cmdlet Get-MigrationUser. Questo metodo di identificazione è utile se lo stesso utente è stato incluso accidentalmente in più batch.

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

Il parametro LargeItemLimit consente di specificare il numero massimo di elementi di grandi dimensioni consentiti prima che la richiesta di migrazione abbia un esito negativo. Un elemento di grandi dimensioni è un messaggio nella cassetta postale di origine che supera la dimensione massima dei messaggi consentita nella cassetta postale di destinazione. Se la cassetta postale di destinazione non dispone di un valore di dimensione massima dei messaggi configurato in modo specifico, viene utilizzato il valore al livello dell'organizzazione.

Per ulteriori informazioni sui valori della dimensione massima dei messaggi, vedere i seguenti argomenti:

L'input valido per questo parametro è un numero intero o il valore Unlimited. Il valore predefinito è 0, che indica che la richiesta di migrazione avrà esito negativo se vengono rilevati elementi di grandi dimensioni. Se si decide di lasciare alcuni elementi di grandi dimensioni, è possibile impostare questo parametro su un valore ragionevole (si consiglia 10 o un valore inferiore) in modo da consentire l'elaborazione della richiesta di migrazione.

Nota: questo parametro è deprecato. In futuro, se non si usa questo parametro, verrà usata la semantica di approvazione di elementi ignorati.

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

Questo parametro è disponibile solamente nel servizio basato su cloud.

Questo parametro è riservato all'uso interno da parte di Microsoft.

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

-StartAfter

Questo parametro è disponibile solamente nel servizio basato su cloud.

Il parametro StartAfter specifica un ritardo prima dell'avvio della migrazione dei dati per l'utente. La migrazione verrà preparata, ma la migrazione effettiva dei dati per l'utente non verrà avviata fino alla data/ora specificata con questo parametro.

Usare il formato data breve definito nelle impostazioni Opzioni internazionali nel computer in cui viene eseguito il comando. Ad esempio, se il computer è configurato per l'utilizzo del formato di data breve mm/dd/yyyy, immettere 01/09/2018 per specificare il 1° settembre 2018. È possibile immettere solo la data oppure specificare la data e l'ora del giorno. In quest'ultimo caso, racchiudere il valore tra virgolette ("), ad esempio, "01/09/2018 17:00".

In Exchange Online PowerShell, se si specifica un valore di data/ora senza un fuso orario, il valore si trova nell'ora UTC (Coordinated Universal Time).

Per specificare un valore data/ora per questo parametro, utilizzare una delle opzioni seguenti:

  • Specificare il valore di data/ora in formato UTC: ad esempio, "2021-05-06 14:30:00z".
  • Specificare il valore di data/ora come formula che converte la data/ora nel fuso orario locale in formato UTC: ad esempio, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Per altre informazioni, vedere Get-Date.
Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SyncNow

L'opzione SyncNow consente di specificare se avviare una sincronizzazione incrementale per l'utente migrato. Con questa opzione non è necessario specificare alcun valore.

La sincronizzazione incrementale copia le modifiche recenti dalla cassetta postale di origine alla cassetta postale di destinazione. È possibile eseguire una sincronizzazione incrementale prima di completare il batch di migrazione per ridurre il tempo necessario per il completamento.

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

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

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