Set-MigrationBatch

Questo parametro è disponibile solo in Exchange locale.

Il parametro AllowIncrementalSyncs specifica se abilitare o disabilitare la sincronizzazione incrementale. I valori validi sono:

• $true: la sincronizzazione incrementale è abilitata. Tutti i nuovi messaggi inviati alla cassetta postale di origine vengono copiati nella cassetta postale di destinazione corrispondente una volta ogni 24 ore.
• $false: la sincronizzazione incrementale è disabilitata. Il batch di migrazione passerà allo stato Arrestato al termine della sincronizzazione iniziale. Per completare un batch di migrazione per gli spostamenti locali, gli spostamenti tra foreste o le migrazioni di spostamento remoto, è necessario abilitare la sincronizzazione incrementale.

Il parametro AllowUnknownColumnsInCsv consente di specificare se consentire colonne extra nel file CSV non utilizzate dalla migrazione. I valori validi sono:

• $true: la migrazione ignora (ignora automaticamente) le colonne sconosciute nel file CSV (incluse le colonne facoltative con intestazioni di colonna con errori di ortografia). Tutte le colonne sconosciute vengono considerate come colonne aggiuntive che non vengono usate dalla migrazione.
• $false: la migrazione ha esito negativo se sono presenti colonne sconosciute nel file CSV. Questa impostazione protegge dagli errori di ortografia nelle intestazioni di colonna. Questo è il valore predefinito.

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.

Questo parametro è disponibile solo in Exchange locale.

Il parametro AutoRetryCount consente di specificare il numero di tentativi per riavviare il batch di migrazione per migrare le cassette postali con errori.

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.

Note: questo parametro verrà deprecato nel servizio basato su cloud. In futuro, se non si usa questo parametro, verrà usata la semantica di approvazione di elementi ignorati.

Questo parametro funziona solo nel servizio basato sul cloud.

Il parametro CompleteAfter consente di specificare un ritardo prima del completamento del batch. La migrazione dei dati per il batch verrà avviata, ma il completamento non inizierà 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, usare una delle opzioni seguenti:

• Specificare il valore di data/ora in formato UTC: ad esempio, "7/30/2020 9:00PM Z".
• Specificare il valore di data/ora nel fuso orario locale. Ad esempio, "7/30/2020 9:00PM -700". Il valore verrà convertito in formato UTC se non si usa il parametro TimeZone.

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.

Questo parametro è disponibile solo in Exchange locale.

Il parametro CSVData consente di specificare il file CSV che contiene informazioni sulle cassette postali degli utenti da spostare o migrare. Gli attributi necessari nella riga dell'intestazione del file CSV variano a seconda del tipo di migrazione.

Per un valore valido per questo parametro è necessario leggere il file in un oggetto con codifica byte usando la sintassi seguente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). È possibile usare questo comando come valore del parametro oppure scrivere l'output in una variabile ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usare la variabile come valore del parametro ($data).

Nota: questo parametro non convalida la disponibilità delle cassette postali in base all'ambito del controllo degli accessi in base al ruolo. Verrà eseguita la migrazione di tutte le cassette postali specificate nel file CSV, anche se non rientrano nell'ambito del controllo degli accessi in base al ruolo (ad esempio, un'unità organizzativa) che concede all'amministratore le autorizzazioni per la migrazione delle cassette postali.

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.

Il parametro Identity consente di specificare il batch di migrazione da modificare. È possibile usare qualsiasi valore che identifichi in modo univoco il batch di migrazione. Ad esempio:

• Nome (valore della proprietà Identity)
• GUID (valore della proprietà BatchGuid)

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:

• Exchange 2016: limiti delle dimensioni dei messaggi in Exchange Server
• Exchange Online: Limiti di Exchange Online

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.

Note: questo parametro verrà deprecato nel servizio basato su cloud. In futuro, se non si usa questo parametro, verrà usata la semantica di approvazione di elementi ignorati.

Il parametro MoveOptions consente di specificare le fasi della migrazione che si desidera ignorare a scopo di debug. Non usare il parametro a meno che non venga richiesto dal Servizio Supporto Tecnico Clienti Microsoft o dalla documentazione specifica.

Non utilizzare questo parametro con il parametro SkipMoving.

Il parametro NotificationEmails consente di specificare uno o più indirizzi di posta elettronica a cui vengono inviati i rapporti sullo stato di migrazione.

Se non si utilizza questo parametro, non verrà inviato alcun rapporto di stato.

Per immettere più valori e sovrascrivere le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

Questo parametro è disponibile solamente nel servizio basato su cloud.

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

Il parametro ReportInterval consente di specificare la frequenza con cui i report inviati tramite posta elettronica devono essere inviati agli indirizzi di posta elettronica elencati in NotificationEmails.

Per impostazione predefinita, i report inviati tramite posta elettronica vengono inviati ogni 24 ore per un batch. L'impostazione di questo valore su 0 indica che i report non devono mai essere inviati per questo batch.

Questo parametro deve essere usato solo nel servizio basato sul cloud.

Il parametro SkipMerging consente di specificare le fasi della migrazione da ignorare a scopo di debug. Non usare il parametro a meno che non venga richiesto dal Servizio Supporto Tecnico Clienti Microsoft o dalla documentazione specifica.

Questo parametro è stato sostituito dal parametro MoveOptions.

Il parametro SkipMoving specifica le fasi della migrazione che si desidera ignorare a scopo di debug. Non usare il parametro a meno che non venga richiesto dal Servizio Supporto Tecnico Clienti Microsoft o dalla documentazione specifica.

L'opzione SkipReports specifica che si desidera ignorare la creazione automatica di report per la migrazione. Con questa opzione non è necessario specificare alcun valore.

Questo parametro è disponibile solo in Exchange locale.

Il parametro SourcePublicFolderDatabase consente di specificare il database di cartelle pubbliche di origine usato in una migrazione di cartelle pubbliche. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:

• Nome
• Nome distinto (DN)
• GUID

Il parametro StartAfter specifica un ritardo prima dell'avvio della migrazione dei dati per gli utenti all'interno del batch. La migrazione verrà preparata, ma la migrazione effettiva dei dati per gli utenti all'interno del batch non inizierà 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, usare una delle opzioni seguenti:

• Specificare il valore di data/ora in formato UTC: ad esempio, "7/30/2020 9:00PM Z".
• Specificare il valore di data/ora nel fuso orario locale. Ad esempio, "7/30/2020 9:00PM -700". Il valore verrà convertito in formato UTC se non si usa il parametro TimeZone.

L'opzione SyncNow avvia una sincronizzazione immediata per gli utenti che hanno già raggiunto lo stato Sincronizzato, ma non riprende gli utenti non riusciti. Con questa opzione non è necessario specificare alcun valore.

È possibile usare questo commutatore per velocizzare gli spostamenti di onboarding usando l'interruttore appena prima del completamento dello spostamento. Per le migrazioni IMAP, è possibile usare questa opzione dopo il passaggio al record MX.

L'opzione Update imposta il flag Update nel batch di migrazione. Con questa opzione non è necessario specificare alcun valore.

Il flag Update attiva il Servizio migrazione per riapplicare tutte le impostazioni dall'endpoint, dal batch e dall'utente al processo di migrazione.

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.