Complete-MigrationBatch
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi di un ambiente o dell'altro.
Usare il cmdlet Complete-MigrationBatch per finalizzare un batch di migrazione che ha completato la sincronizzazione iniziale.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
Complete-MigrationBatch
[[-Identity] <MigrationBatchIdParameter>]
[-CompletePublicFolderMigrationWithDataLoss]
[-Confirm]
[-DomainController <Fqdn>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-SyncAndComplete]
[-WhatIf]
[<CommonParameters>]
Descrizione
Dopo che un batch di migrazione è stato eseguito correttamente e lo stato è Synced o SyncedWithErrors, usare il cmdlet Complete-MigrationBatch per finalizzare il batch di migrazione. Durante la finalizzazione di un batch di migrazione, il cmdlet esegue le seguenti operazioni per ogni cassetta postale nel batch di migrazione:
- Viene eseguita una sincronizzazione incrementale finale.
- Configura il profilo di Microsoft Outlook dell'utente in modo che punti al nuovo dominio di destinazione.
- La cassetta postale di origine viene convertita in un utente abilitato alla posta elettronica nel dominio di origine.
Nel servizio basato su cloud, questo cmdlet imposta il valore CompleteAfter sull'ora UTC corrente, che segnala al servizio di migrazione di completare il batch il prima possibile. Ciò equivale nell'intento all'esecuzione Set-MigrationBatch -CompleteAfter (Get-Date)di , ma senza ambiguità nella conversione del fuso orario.
Si noti il comportamento seguente quando si usa questo cmdlet in Exchange Online:
- Qualsiasi impostazione CompleteAfter applicata ai singoli utenti all'interno del batch sostituisce l'impostazione a livello di batch, pertanto il completamento per alcuni utenti potrebbe essere ritardato fino all'ora di configurazione.
- Se si esegue questo cmdlet più volte entro 8 ore dopo che il batch è già stato segnalato per il completamento, il servizio di migrazione potrebbe non rielaborare la richiesta. Questo comportamento è stato progettato per impedire che chiamate ripetute mettano a dura prova il servizio. Se il batch si blocca dopo l'esecuzione del cmdlet, verificare la presenza di elementi ignorati non approvati (utilizzare
Set-MigrationUser -ApproveSkippedItems).
Al termine del processo di finalizzazione è possibile rimuovere il batch utilizzando il cmdlet Remove-MigrationBatch.
Se lo stato di un batch di migrazione è Completato con errori, è possibile riprovare a finalizzare gli utenti non riusciti. In Exchange Online, usare il cmdlet Start-MigrationBatch per riprovare la migrazione per gli utenti non riusciti. In Exchange 2013 o versioni successive, utilizzare il Complete-MigrationBatch per riprovare gli utenti non riusciti.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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
Complete-MigrationBatch -Identity LocalMove1 -NotificationEmails admin@contoso.com,lucio@contoso.com
In questo esempio viene completato il batch di migrazione LocalMove1 e viene inviato un messaggio di posta elettronica di notifica agli utenti specificati.
Parametri
-CompletePublicFolderMigrationWithDataLoss
Applicabile: Exchange Online
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.
- I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.
Questo cmdlet ha una pausa incorporata, quindi è consigliabile usare -Confirm:$false per ignorare la conferma.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DomainController
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Proprietà dei parametri
| Tipo: | Fqdn |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Il parametro Identity consente di specificare il nome del batch di migrazione che si desidera completare. Il valore per tale parametro è specificato dal parametro Name per il cmdlet New-MigrationBatch. Utilizzare il cmdlet Get-MigrationBatch per determinare il valore di questo parametro per il batch di migrazione.
Proprietà dei parametri
| Tipo: | MigrationBatchIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-NotificationEmails
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Questo parametro è disponibile solo in Exchange locale.
Il parametro NotificationEmails consente di specificare uno o più indirizzi di posta elettronica a cui inviare i report di stato una volta completato il batch di migrazione. È possibile indicare più indirizzi di posta elettronica separati da virgole.
Se non si utilizza questo parametro, il report di stato finale viene inviato all'amministratore che esegue il cmdlet Complete-MigrationBatch.
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Partition
Applicabile: Exchange Online
Questo parametro è disponibile solamente nel servizio basato su cloud.
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | MailboxIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-SyncAndComplete
Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
L'opzione SyncAndComplete specifica se attivare una sincronizzazione incrementale finale immediatamente seguita dal completamento del batch di migrazione se la sincronizzazione ha avuto esito positivo. Con questa opzione non è necessario specificare alcun valore.
Quando si utilizza questo interruttore, il batch deve avere zero elementi non riusciti, danneggiati o interrotti; In caso contrario, il cmdlet restituisce un errore.
Nota: Per i batch di migrazione delle cartelle pubbliche, questa opzione è abilitata per impostazione predefinita, a meno che non venga specificata anche l'opzione CompletePublicFolderMigrationWithDataLoss.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo Tipo di input per un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo Tipo di output è vuoto, il cmdlet non restituisce dati.
Note
In Exchange Online questo cmdlet è supportato per i tipi di migrazione seguenti:
- Spostamento locale di Exchange
- Spostamento remoto di Exchange
- Gmail
- Google Resource
- Trasferimento locale
- Spostamento cartella
- Importazione PST
- cartella pubblica
- Cartella pubblica in un gruppo unificato
In Exchange Online questo cmdlet non è supportato per le migrazioni IMAP, Exchange Outlook via Internet (cutover) o Bulk Provisioning, che non hanno un passaggio di finalizzazione.