Set-MigrationBatch
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Usare il cmdlet Set-MigrationBatch per aggiornare una richiesta di migrazione per un batch di utenti. Per ulteriori informazioni, vedere New-MigrationBatch.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-MigrationBatch
[-Identity] <MigrationBatchIdParameter>
[-AllowIncrementalSyncs <Boolean>]
[-AllowUnknownColumnsInCsv <Boolean>]
[-ApproveSkippedItems]
[-AutoRetryCount <Int32>]
[-BadItemLimit <Unlimited>]
[-CSVData <Byte[]>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-LargeItemLimit <Unlimited>]
[-MoveOptions <MultiValuedProperty>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <TimeSpan>]
[-SkipMerging <MultiValuedProperty>]
[-SkipMoving <MultiValuedProperty>]
[-SkipReports <Boolean>]
[-SourcePublicFolderDatabase <DatabaseIdParameter>]
[-StartAfter <DateTime>]
[-SyncNow]
[-Update]
[-WhatIf]
[<CommonParameters>] Descrizione
Il cmdlet Set-MigrationBatch configura i batch di migrazione esistenti per eseguire la migrazione delle cassette postali e dei relativi dati in uno dei seguenti scenari:
- Spostamento locale
- Spostamento tra foreste
- Spostamento remoto
- Migrazione completa di Exchange
- Migrazione di Exchange in fasi
- Migrazione IMAP
- Migrazione di Google Workspace (in precedenza G Suite)
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-MigrationBatch -Identity MigrationBatch01 -ApproveSkippedItemsQuesto esempio aggiorna MigrationBatch01 approvando tutti gli elementi ignorati per tutti gli utenti del batch rilevati in precedenza.
Parametri
-AllowIncrementalSyncs
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AllowUnknownColumnsInCsv
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AutoRetryCount
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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.
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.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CompleteAfter
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.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CSVData
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.
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
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)
| Type: | MigrationBatchIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, 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:
- 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.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MoveOptions
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.
| Type: | MultiValuedProperty |
| 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 |
-NotificationEmails
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".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, 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 |
-ReportInterval
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.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkipMerging
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.
| Type: | MultiValuedProperty |
| 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 |
-SkipMoving
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.
| Type: | MultiValuedProperty |
| 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 |
-SkipReports
L'opzione SkipReports specifica che si desidera ignorare la creazione automatica di report per la migrazione. Con questa opzione non è necessario specificare alcun valore.
| Type: | Boolean |
| 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 |
-SourcePublicFolderDatabase
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
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-StartAfter
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.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SyncNow
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.
| 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 |
-Update
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.
| 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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di 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 relativo al tipo di output è vuoto, il cmdlet non restituisce dati.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per