New-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 New-MigrationBatch per inviare una nuova richiesta di migrazione per un batch di utenti.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-MigrationBatch
-Name <String>
[-CSVData <Byte[]>]
[-DisallowExistingUsers]
[-WorkflowControlFlags <MigrationWorkflowControlFlags>]
[-AdoptPreexisting]
[-AllowIncrementalSyncs <Boolean>]
[-AllowUnknownColumnsInCsv <Boolean>]
[-ArchiveDomain <String>]
[-ArchiveOnly]
[-AutoComplete]
[-AutoRetryCount <Int32>]
[-AutoStart]
[-AvoidMergeOverlap]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <DateTime>]
[-ContentFilter <String>]
[-ContentFilterLanguage <CultureInfo>]
[-Confirm]
[-DomainController <Fqdn>]
[-ExcludeDumpsters]
[-ExcludeFolders <MultiValuedProperty>]
[-ForwardingDisposition <GmailForwardingDisposition>]
[-IncludeFolders <MultiValuedProperty>]
[-LargeItemLimit <Unlimited>]
[-Locale <CultureInfo>]
[-MoveOptions <MultiValuedProperty>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-PrimaryOnly]
[-RemoveOnCopy]
[-RenamePrimaryCalendar]
[-ReportInterval <Timespan>]
[-Restore]
[-SkipCalendar]
[-SkipContacts]
[-SkipMail]
[-SkipMerging <MultiValuedProperty>]
[-SkipMoving <MultiValuedProperty>]
[-SkipReports]
[-SkipRules]
[-SkipSteps <SkippableMigrationSteps[]>]
[-SourceEndpoint <MigrationEndpointIdParameter>]
[-SourcePFPrimaryMailboxGuid <Guid>]
[-StartAfter <DateTime>]
[-TargetArchiveDatabases <MultiValuedProperty>]
[-TargetDatabases <MultiValuedProperty>]
[-TargetDeliveryDomain <String>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[<CommonParameters>]
New-MigrationBatch
-Name <String>
-CSVData <Byte[]>
[-DisallowExistingUsers]
[-AdoptPreexisting]
[-AllowIncrementalSyncs <Boolean>]
[-AllowUnknownColumnsInCsv <Boolean>]
[-ArchiveDomain <String>]
[-ArchiveOnly]
[-AutoComplete]
[-AutoRetryCount <Int32>]
[-AutoStart]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-LargeItemLimit <Unlimited>]
[-Locale <CultureInfo>]
[-MoveOptions <MultiValuedProperty>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-PrimaryOnly]
[-RemoveOnCopy]
[-ReportInterval <Timespan>]
[-SkipMerging <MultiValuedProperty>]
[-SkipMoving <MultiValuedProperty>]
[-SkipReports]
[-SkipSteps <SkippableMigrationSteps[]>]
[-StartAfter <DateTime>]
[-TargetArchiveDatabases <MultiValuedProperty>]
[-TargetDatabases <MultiValuedProperty>]
[-TargetDeliveryDomain <String>]
[-TargetEndpoint <MigrationEndpointIdParameter>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[<CommonParameters>]
New-MigrationBatch
[-Local]
-Name <String>
-CSVData <Byte[]>
[-DisallowExistingUsers]
[-WorkloadType <RequestWorkloadType>]
[-WorkflowControlFlags <MigrationWorkflowControlFlags>]
[-AdoptPreexisting]
[-AllowIncrementalSyncs <Boolean>]
[-AllowUnknownColumnsInCsv <Boolean>]
[-ArchiveOnly]
[-AutoComplete]
[-AutoRetryCount <Int32>]
[-AutoStart]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-Locale <CultureInfo>]
[-MoveOptions <MultiValuedProperty>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-PrimaryOnly]
[-RemoveOnCopy]
[-ReportInterval <Timespan>]
[-SkipMoving <MultiValuedProperty>]
[-SkipReports]
[-SkipSteps <SkippableMigrationSteps[]>]
[-StartAfter <DateTime>]
[-TargetArchiveDatabases <MultiValuedProperty>]
[-TargetDatabases <MultiValuedProperty>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[<CommonParameters>]
New-MigrationBatch
-Name <String>
-CSVData <Byte[]>
-SourcePublicFolderDatabase <DatabaseIdParameter>
[-AllowIncrementalSyncs <Boolean>]
[-AllowUnknownColumnsInCsv <Boolean>]
[-AutoComplete]
[-AutoRetryCount <Int32>]
[-AutoStart]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-LargeItemLimit <Unlimited>]
[-Locale <CultureInfo>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <Timespan>]
[-SkipMerging <MultiValuedProperty>]
[-SkipReports]
[-SkipSteps <SkippableMigrationSteps[]>]
[-StartAfter <DateTime>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[<CommonParameters>]
New-MigrationBatch
-Name <String>
[-UserIds] <MultiValuedProperty>
[-AllowIncrementalSyncs <Boolean>]
[-AllowUnknownColumnsInCsv <Boolean>]
[-AutoComplete]
[-AutoRetryCount <Int32>]
[-AutoStart]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DisableOnCopy]
[-DomainController <Fqdn>]
[-Locale <CultureInfo>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <Timespan>]
[-SkipReports]
[-SkipSteps <SkippableMigrationSteps[]>]
[-StartAfter <DateTime>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[<CommonParameters>]
New-MigrationBatch
-Name <String>
[-Users] <MultiValuedProperty>
[-AllowIncrementalSyncs <Boolean>]
[-AutoComplete]
[-AutoRetryCount <Int32>]
[-AutoStart]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DisableOnCopy]
[-DomainController <Fqdn>]
[-Locale <CultureInfo>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <Timespan>]
[-SkipReports]
[-SkipSteps <SkippableMigrationSteps[]>]
[-StartAfter <DateTime>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[<CommonParameters>]
New-MigrationBatch
-Name <String>
-CSVData <Byte[]>
[-PublicFolderToUnifiedGroup]
[-AllowIncrementalSyncs <Boolean>]
[-AllowUnknownColumnsInCsv <Boolean>]
[-AutoComplete]
[-AutoRetryCount <Int32>]
[-AutoStart]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-LargeItemLimit <Unlimited>]
[-Locale <CultureInfo>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <Timespan>]
[-SkipReports]
[-SkipSteps <SkippableMigrationSteps[]>]
[-SourceEndpoint <MigrationEndpointIdParameter>]
[-StartAfter <DateTime>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[<CommonParameters>]
New-MigrationBatch
-Name <String>
[-WorkflowTemplate <String>]
[-AllowIncrementalSyncs <Boolean>]
[-AllowUnknownColumnsInCsv <Boolean>]
[-AutoComplete]
[-AutoRetryCount <Int32>]
[-AutoStart]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-Locale <CultureInfo>]
[-NotificationEmails <MultiValuedProperty>]
[-Partition <MailboxIdParameter>]
[-ReportInterval <Timespan>]
[-SkipReports]
[-SkipSteps <SkippableMigrationSteps[]>]
[-StartAfter <DateTime>]
[-TimeZone <ExTimeZoneValue>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Usare il cmdlet New-MigrationBatch per creare un batch di migrazione per eseguire la migrazione dei dati delle cassette postali e delle cassette postali in uno degli scenari di migrazione seguenti.
Si sposta nelle organizzazioni di Exchange locali
- Spostamento locale: uno spostamento locale è il percorso in cui si spostano le cassette postali da un database di cassette postali a un altro. Uno spostamento locale avviene all'interno di una singola foresta. Per altre informazioni, vedere l'esempio 1.
- Spostamento tra foreste aziendali: in uno spostamento tra foreste aziendali, le cassette postali vengono spostate in una foresta diversa. Gli spostamenti tra foreste iniziano dalla foresta di destinazione, ossia la foresta in cui si intende spostare le cassette postali, o dalla foresta di origine, ossia quella in cui si trovano le cassette postali. Per ulteriori informazioni, vedere Esempio 2.
Onboarding e offboarding in Exchange Online
Onboarding della migrazione dello spostamento remoto: in una distribuzione ibrida è possibile spostare le cassette postali da un'organizzazione di Exchange locale a Exchange Online. Questa operazione è nota anche come migrazione dello spostamento remoto di onboarding perché le cassette postali di bordo vengono Exchange Online. Per altre informazioni, vedere l'esempio 3.
Migrazione di spostamento remoto offboarding: è anche possibile eseguire una migrazione di spostamento remoto offboarding, in cui si esegue la migrazione delle cassette postali Exchange Online all'organizzazione di Exchange locale. Per altre informazioni, vedere l'esempio 4.
Sia l'onboarding che l'offboarding delle migrazioni di spostamento remoto vengono avviate dall'organizzazione Exchange Online.
Migrazione completa di Exchange: si tratta di un altro tipo di migrazione di onboarding e viene usato per eseguire la migrazione di tutte le cassette postali in un'organizzazione di Exchange locale a Exchange Online. È possibile eseguire la migrazione di un massimo di 1.000 Exchange Server 2003, Exchange Server 2007 o Exchange Server 2010 cassette postali usando una migrazione completa. Il provisioning delle cassette postali verrà eseguito automaticamente in Exchange Online quando si esegue una migrazione completa di Exchange. Per altre informazioni, vedere l'esempio 5.
Migrazione a fasi di Exchange: è anche possibile eseguire la migrazione di un subset di cassette postali da un'organizzazione di Exchange locale a Exchange Online. Si tratta di un altro tipo di migrazione onboarding. La migrazione delle cassette postali da Exchange 2010 o versioni successive di Exchange non è supportata tramite una migrazione a fasi. Prima di eseguire una migrazione a fasi, è necessario usare la sincronizzazione della directory o un altro metodo per effettuare il provisioning degli utenti di posta elettronica nell'organizzazione Exchange Online. Per altre informazioni, vedere l'esempio 6.
Migrazione IMAP: questo tipo di migrazione di onboarding esegue la migrazione dei dati delle cassette postali da un server IMAP (incluso Exchange) a Exchange Online. Per una migrazione IMAP, è prima necessario effettuare il provisioning delle cassette postali in Exchange Online prima di poter eseguire la migrazione dei dati delle cassette postali. Per altre informazioni, vedere l'esempio 7.
Migrazione di Google Workspace (in precedenza G Suite): questo tipo di migrazione di onboarding esegue la migrazione dei dati delle cassette postali da un'organizzazione di Google Workspace a Exchange Online. Per una migrazione di Google Workspace, è prima necessario effettuare il provisioning di utenti di posta elettronica (o cassette postali) in Exchange Online prima di poter eseguire la migrazione dei dati delle cassette postali. Per altre informazioni, vedere l'esempio 10.
È 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
New-MigrationBatch -Local -Name LocalMove1 -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\LocalMove1.csv")) -TargetDatabases MBXDB2
Start-MigrationBatch -Identity LocalMove1
In questo esempio viene creato un batch di migrazione per uno spostamento locale, in cui le cassette postali nel file CSV specificato vengono spostate in un database di cassette postali diverso. Questo file CSV contiene una singola colonna con l'indirizzo di posta elettronica per le cassette postali che verranno spostate. L'intestazione per questa colonna deve essere denominata EmailAddress. Il batch di migrazione in questo esempio deve essere avviato manualmente usando il cmdlet Start-MigrationBatch o l'interfaccia di amministrazione di Exchange. In alternativa, è possibile usare il parametro Avvio automatico per avviare automaticamente il batch di migrazione.
Esempio 2
$Credentials = Get-Credential
$MigrationEndpointSource = New-MigrationEndpoint -ExchangeRemoteMove -Name Forest1Endpoint -Autodiscover -EmailAddress administrator@forest1.contoso.com -Credentials $Credentials
$CrossForestBatch = New-MigrationBatch -Name CrossForestBatch1 -SourceEndpoint $MigrationEndpointSource.Identity -TargetDeliveryDomain forest2.contoso.com -TargetDatabases MBXDB1 -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\CrossForestBatch1.csv"))
Start-MigrationBatch -Identity $CrossForestBatch.Identity
In questo esempio viene creato un batch di migrazione per uno spostamento aziendale tra foreste, in cui le cassette postali per gli utenti di posta elettronica specificati nel file CSV vengono spostate in una foresta diversa. Viene creato un nuovo endpoint di migrazione che identifica il dominio in cui si trovano attualmente le cassette postali. L'endpoint viene usato per creare il batch di migrazione. Il batch di migrazione viene quindi avviato con il cmdlet Start-MigrationBatch. Si noti che gli spostamenti tra foreste vengono avviati dalla foresta di destinazione, ovvero dalla foresta in cui si desidera spostare le cassette postali.
Esempio 3
$Credentials = Get-Credential
$MigrationEndpointOnPrem = New-MigrationEndpoint -ExchangeRemoteMove -Name OnpremEndpoint -Autodiscover -EmailAddress administrator@onprem.contoso.com -Credentials $Credentials
$OnboardingBatch = New-MigrationBatch -Name RemoteOnBoarding1 -SourceEndpoint $MigrationEndpointOnprem.Identity -TargetDeliveryDomain contoso.mail.onmicrosoft.com -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\RemoteOnBoarding1.csv"))
Start-MigrationBatch -Identity $OnboardingBatch.Identity.Name
In questo esempio viene creato un batch di migrazione per una migrazione di spostamento remoto di onboarding da un'organizzazione di Exchange locale a Exchange Online. La sintassi è simile a quella di uno spostamento tra foreste, ma viene avviata dall'organizzazione Exchange Online. Viene creato un nuovo endpoint di migrazione, che punta all'organizzazione locale come percorso di origine delle cassette postali di cui verrà eseguita la migrazione. Questo endpoint viene usato per creare il batch di migrazione. Il batch di migrazione viene quindi avviato con il cmdlet Start-MigrationBatch.
Esempio 4
$Credentials = Get-Credential
$MigrationEndpointOnPrem = New-MigrationEndpoint -ExchangeRemoteMove -Name OnpremEndpoint -Autodiscover -EmailAddress administrator@onprem.contoso.com -Credentials $Credentials
$OffboardingBatch = New-MigrationBatch -Name RemoteOffBoarding1 -TargetEndpoint $MigrationEndpointOnprem.Identity -TargetDeliveryDomain onprem.contoso.com -TargetDatabases @(MBXDB01,MBXDB02,MBXDB03) -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\RemoteOffBoarding1.csv"))
Start-MigrationBatch -Identity $OffboardingBatch.Identity
In questo esempio viene creato un batch di migrazione per una migrazione di spostamento remoto offboarding da Exchange Online a un'organizzazione di Exchange locale. Analogamente a uno spostamento remoto di onboarding, viene avviato dall'organizzazione Exchange Online. Viene innanzitutto creato un endpoint di migrazione che contiene informazioni su come connettersi all'organizzazione locale. L'endpoint viene usato come TargetEndpoint durante la creazione del batch di migrazione, che viene quindi avviato con il cmdlet Start-MigrationBatch. Il parametro TargetDatabases consente di specificare più database locali che il servizio di migrazione può selezionare come database di destinazione in cui spostare la cassetta postale.
Esempio 5
$credentials = Get-Credential
$SourceEndpoint = New-MigrationEndpoint -ExchangeOutlookAnywhere -Autodiscover -Name SourceEndpoint -EmailAddress administrator@contoso.com -Credentials $credentials
New-MigrationBatch -Name CutoverBatch -SourceEndpoint $SourceEndpoint.Identity -TimeZone "Pacific Standard Time" -AutoStart
In questo esempio viene creato un batch di migrazione per il cutoverbatch di migrazione di Exchange che viene avviato automaticamente. L'esempio ottiene le impostazioni di connessione al server Exchange locale e quindi le usa per creare un endpoint di migrazione. L'endpoint viene quindi usato per creare il batch di migrazione. Questo esempio include anche il parametro Facoltativo TimeZone.
Esempio 6
$Credentials = Get-Credential
$MigrationEndpoint = New-MigrationEndpoint -ExchangeOutlookAnywhere -Name ContosoEndpoint -Autodiscover -EmailAddress administrator@contoso.com -Credentials $Credentials
$StagedBatch1 = New-MigrationBatch -Name StagedBatch1 -SourceEndpoint $MigrationEndpoint.Identity -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\StagedBatch1.csv"))
Start-MigrationBatch -Identity $StagedBatch1.Identity
In questo esempio viene creato e avviato un batch di migrazione per una migrazione a fasi di Exchange. L'esempio usa il cmdlet New-MigrationEndpoint per creare un endpoint di migrazione per il server Exchange locale e quindi usa tale endpoint per creare il batch di migrazione. Il batch di migrazione viene avviato con il cmdlet Start-MigrationBatch.
Esempio 7
New-MigrationEndpoint -IMAP -Name IMAPEndpoint1 -RemoteServer imap.contoso.com -Port 993
New-MigrationBatch -Name IMAPbatch1 -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\IMAPmigration_1.csv")) -SourceEndpoint IMAPEndpoint1 -ExcludeFolders "Deleted Items","Junk Email"
In questo esempio viene creato un endpoint di migrazione per le impostazioni di connessione al server IMAP. Viene quindi creato un batch di migrazione IMAP che usa il file di migrazione CSV IMAPmigration_1.csv ed esclude il contenuto delle cartelle Posta eliminata e Email Posta indesiderata. Questo batch di migrazione è in sospeso fino a quando non viene avviato con il cmdlet Start-MigrationBatch.
Esempio 8
$Credentials = Get-Credential
$MigrationEndpointOnPrem = New-MigrationEndpoint -ExchangeRemoteMove -Name OnpremEndpoint -Autodiscover -EmailAddress administrator@onprem.contoso.com -Credentials $Credentials
$OnboardingBatch = New-MigrationBatch -Name RemoteOnBoarding1 -SourceEndpoint $MigrationEndpointOnprem.Identity -TargetDeliveryDomain contoso.mail.onmicrosoft.com -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\RemoteOnBoarding1.csv")) -CompleteAfter "09/01/2018 7:00 PM"
Start-MigrationBatch -Identity $OnboardingBatch.Identity
Questo esempio è uguale all'esempio 3, ma viene usato anche il parametro CompleteAfter. La migrazione dei dati per il batch verrà avviata, ma non verrà completata fino al 01/09/2018 19:00 (UTC). Questo metodo consente di avviare una migrazione e quindi lasciarla completa dopo l'orario di ufficio se il fuso orario è Coordinated Universal Time.
Esempio 9
$Credentials = Get-Credential
$MigrationEndpointOnPrem = New-MigrationEndpoint -ExchangeRemoteMove -Name OnpremEndpoint -Autodiscover -EmailAddress administrator@onprem.contoso.com -Credentials $Credentials
$OnboardingBatch = New-MigrationBatch -Name RemoteOnBoarding1 -SourceEndpoint $MigrationEndpointOnprem.Identity -TargetDeliveryDomain contoso.mail.onmicrosoft.com -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\RemoteOnBoarding1.csv")) -CompleteAfter "09/01/2018 7:00 PM" -TimeZone "Pacific Standard Time"
Start-MigrationBatch -Identity $OnboardingBatch.Identity
Questo esempio è uguale all'esempio 8, ma viene usato anche il parametro TimeZone. La migrazione dei dati per il batch verrà avviata, ma non verrà completata fino al 01/09/2018 19:00 (PST). Questo metodo consente di avviare una migrazione e quindi lasciarla completa dopo l'orario di ufficio se il fuso orario è Pacific Standard Time.
Esempio 10
$MigrationEndpointGmail = New-MigrationEndpoint -Gmail -ServiceAccountKeyFileData $([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\gmailonboarding.json")) -EmailAddress admin@contoso.com -Name GmailEndpoint
$OnboardingBatch = New-MigrationBatch -SourceEndpoint $MigrationEndpointGmail.Identity -Name GmailBatch1 -CSVData $([System.IO.File]::ReadAll
Bytes("C:\Users\Administrator\Desktop\gmail.csv")) -TargetDeliveryDomain "o365.contoso.com" -ContentFilter "Received -ge '2019/4/30'" -Inc
ludeFolders "Payment"
Start-MigrationBatch -Identity $OnboardingBatch.Identity
Viene creato un batch di migrazione di Google Workspace che usa il file di migrazione CSV gmail.csv e include il contenuto dell'etichetta Pagamento ed esegue la migrazione solo dei messaggi ricevuti dopo l'ora del sistema locale "2019/4/30 00:00". Questo batch di migrazione è in sospeso fino a quando non viene avviato con il cmdlet Start-MigrationBatch.
Parametri
-AdoptPreexisting
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Fill AdoptPreexisting Description }}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-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. Questo è il valore predefinito.
- $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 usando il cmdlet Set-MigrationBatch.
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 |
-ArchiveDomain
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Fill ArchiveDomain Description }}
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ArchiveOnly
L'opzione ArchiveOnly specifica che viene eseguita la migrazione solo delle cassette postali di archiviazione per gli utenti nel batch di migrazione (non viene eseguita la migrazione delle cassette postali primarie). Con questa opzione non è necessario specificare alcun valore.
È possibile usare questa opzione solo per le migrazioni di spostamento locale e remoto.
È possibile usare il parametro TargetArchiveDatabases per specificare il database in cui eseguire la migrazione delle cassette postali di archiviazione. È anche possibile specificare il database di archivio di destinazione nel file CSV. Se non si specifica il database di archivio di destinazione, il cmdlet usa la logica di distribuzione automatica delle cassette postali per selezionare il database.
Type: | SwitchParameter |
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 |
-AutoComplete
L'opzione Completamento automatico forza la finalizzazione delle singole cassette postali non appena la cassetta postale ha completato la sincronizzazione iniziale. Con questa opzione non è necessario specificare alcun valore.
È possibile usare questa opzione solo per le migrazioni di spostamento locale e remoto.
Se non si usa questa opzione, è necessario eseguire il cmdlet Complete-MigrationBatch per finalizzare un batch di migrazione.
Type: | SwitchParameter |
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 |
-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 |
-AutoStart
L'opzione Avvio automatico avvia immediatamente l'elaborazione del nuovo batch di migrazione. Con questa opzione non è necessario specificare alcun valore.
Se non si usa questa opzione, è necessario avviare manualmente il batch di migrazione usando il cmdlet Start-MigrationBatch.
Type: | SwitchParameter |
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 |
-AvoidMergeOverlap
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Fill AvoidMergeOverlap Description }}
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.
Note: questo parametro verrà deprecato nel servizio basato su cloud. In futuro, se non vengono specificati né i parametri BadItemLimit né LargeItemLimit, la migrazione userà la semantica di approvazione dell'elemento ignorata anziché la semantica BadItemLimit.
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 |
-ContentFilter
Questo parametro è disponibile solo nel servizio basato sul cloud per la migrazione IMAP e google workspace.
Il parametro ContentFilter usa la sintassi del filtro OPATH per filtrare i messaggi in base all'ora di ricezione. Solo il contenuto che corrisponde al parametro ContentFilter verrà spostato in Exchange Online. Ad esempio:
"Received -gt '8/23/2020'"
"Received -le '2019/01/01'"
"Received -gt '8/23/2015' -and Received -lt '8/23/2020'"
È possibile specificare la lingua usando il parametro ContentFilterLanguage.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ContentFilterLanguage
Questo parametro è disponibile solo nel servizio basato sul cloud per la migrazione IMAP e google workspace.
Il parametro ContentFilterLanguage consente di specificare la lingua utilizzata nel parametro ContentFilter per eseguire le ricerche di stringhe.
L'input valido per questo parametro è un valore di codice delle impostazioni cultura supportato dalla classe CultureInfo di Microsoft .NET Framework. Ad esempio, da-DK per il danese o ja-JP per il giapponese. Per altre informazioni, vedere Classe CultureInfo.
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-CSVData
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 altre informazioni, vedere File CSV per la migrazione delle cassette postali.
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: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DisableOnCopy
L'opzione DisableOnCopy disabilita l'elemento del processo di migrazione originale per un utente se si copiano utenti da un batch esistente a un nuovo batch usando i parametri UserIds o Users. 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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DisallowExistingUsers
Questo parametro è disponibile solo in Exchange locale.
L'opzione DisallowExistingUsers impedisce la migrazione delle cassette postali attualmente definite in un batch di migrazione diverso. Con questa opzione non è necessario specificare alcun valore.
Viene visualizzato un avviso di convalida per qualsiasi cassetta postale preesistente nella destinazione di destinazione.
Type: | SwitchParameter |
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 |
-ExcludeDumpsters
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione ExcludeDumpsters specifica se eseguire la migrazione delle cassette postali delle cartelle pubbliche senza includere il contenuto della cartella Elementi ripristinabili (in precedenza noto come dumpster). Con questa opzione non è necessario specificare alcun valore.
Questa opzione viene usata solo nelle migrazioni di cartelle pubbliche da Exchange 2013 o versioni successive a Exchange Online.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ExcludeFolders
Questo parametro è disponibile solamente nel servizio basato su cloud.
Per una migrazione IMAP o google workspace, il parametro ExcludeFolders specifica le cartelle delle cassette postali di cui non si vuole eseguire la migrazione dal sistema di posta elettronica di origine alle cassette postali basate sul cloud. Specificare il valore come matrice di stringhe e separare più nomi di cartelle con virgole.
Per la migrazione IMAP, usare i nomi di cartella relativi alla radice IMAP nel server di posta elettronica di origine. Per la migrazione di Google Workspace, usare i nomi delle etichette nel server di posta elettronica di origine.
I nomi delle cartelle non fanno distinzione tra maiuscole e minuscole e non sono previste limitazioni sui caratteri. Usare la seguente sintassi:
<FolderName>/*
: utilizzare questa sintassi per indicare una cartella personale nella cartella specificata nel parametro SourceRootFolder, ad esempio MyProjects
o MyProjects/FY2010
.
#<FolderName>#/*
: utilizzare questa sintassi per indicare una cartella nota indipendentemente dal nome della cartella in un'altra lingua. Ad esempio, #Inbox# indica la cartella Inbox, anche se questa viene localizzata in italiano (Posta in arrivo). Le cartelle note includono i seguenti tipi:
- Radice
- Posta in arrivo
- SentItems
- Outbox
- DeletedItems
- Calendario
- Contatti
- Bozze
- Diario
- Attività
- Note
- AllItems
- JunkEmail
- Archiviare
Se l'utente crea una cartella personale con lo stesso nome di una cartella nota e il #
simbolo che la circonda, è possibile usare una barra rovesciata (\
) come carattere di escape per specificare tale cartella. Ad esempio, se un utente crea una cartella denominata #Notes#
e si desidera specificare tale cartella anziché la cartella note nota, utilizzare la sintassi seguente: \#Notes\#
.
Non è possibile usare i caratteri jolly nei nomi delle cartelle.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ForwardingDisposition
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Fill Forwarding DescriptionDisposition }}
Type: | GmailForwardingDisposition |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-IncludeFolders
Questo parametro è disponibile solamente nel servizio basato su cloud.
Per una migrazione IMAP o google workspace, il parametro IncludeFolders specifica le cartelle delle cassette postali di cui si vuole eseguire la migrazione dal sistema di posta elettronica locale alle cassette postali basate sul cloud. Specificare il valore come matrice di stringhe e separare più nomi di cartelle con virgole.
Per la migrazione IMAP, usare i nomi di cartella relativi alla radice IMAP nel server di posta elettronica di origine. Per la migrazione di Google Workspace, usare i nomi delle etichette nel server di posta elettronica di origine.
I nomi delle cartelle non fanno distinzione tra maiuscole e minuscole e non sono previste limitazioni sui caratteri. Usare la seguente sintassi:
<FolderName>/*
: utilizzare questa sintassi per indicare una cartella personale nella cartella specificata nel parametro SourceRootFolder, ad esempio MyProjects
o MyProjects/FY2010
.
#<FolderName>#/*
: utilizzare questa sintassi per indicare una cartella nota indipendentemente dal nome della cartella in un'altra lingua. Ad esempio, #Inbox# indica la cartella Inbox, anche se questa viene localizzata in italiano (Posta in arrivo). Le cartelle note includono i seguenti tipi:
- Radice
- Posta in arrivo
- SentItems
- Outbox
- DeletedItems
- Calendario
- Contatti
- Bozze
- Diario
- Attività
- Note
- AllItems
- JunkEmail
- Archiviare
Se l'utente crea una cartella personale con lo stesso nome di una cartella nota e il #
simbolo che la circonda, è possibile usare una barra rovesciata (\
) come carattere di escape per specificare tale cartella. Ad esempio, se un utente crea una cartella denominata #Notes#
e si desidera specificare tale cartella anziché la cartella note nota, utilizzare la sintassi seguente: \#Notes\#
.
Non è possibile usare i caratteri jolly nei nomi delle cartelle.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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 |
-Local
Questo parametro è disponibile solo in Exchange locale.
L'opzione Locale specifica uno spostamento locale (le cassette postali vengono spostate in un database di cassette postali diverso nella stessa foresta di Active Directory). Con questa opzione non è necessario specificare alcun valore.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Locale
Questo parametro è disponibile solo in Exchange locale.
Il parametro Locale consente di specificare la lingua per il batch di migrazione.
L'input valido per questo parametro è un valore di codice delle impostazioni cultura supportato dalla classe CultureInfo di Microsoft .NET Framework. Ad esempio, da-DK per il danese o ja-JP per il giapponese. Per altre informazioni, vedere Classe CultureInfo.
Type: | CultureInfo |
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 |
-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 |
-Name
Il parametro Name consente di specificare un nome univoco per il batch di migrazione in ogni sistema (Exchange locale o Exchange Online). La lunghezza massima è 64 caratteri. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, 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. Specificare il valore come matrice di stringhe e separare più indirizzi di posta elettronica con virgole.
Se non si utilizza questo parametro, non verrà inviato alcun rapporto di stato.
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 |
-PrimaryOnly
L'opzione PrimaryOnly specifica che viene eseguita la migrazione solo delle cassette postali primarie per gli utenti del batch di migrazione che dispongono anche di cassette postali di archiviazione (non viene eseguita la migrazione delle cassette postali di archiviazione). Con questa opzione non è necessario specificare alcun valore.
È possibile usare questa opzione solo per le migrazioni di spostamento locale e remoto.
Nota: se gli utenti non dispongono di cassette postali di archiviazione, non usare questa opzione.
Type: | SwitchParameter |
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 |
-PublicFolderToUnifiedGroup
Questo parametro funziona solo nel servizio basato sul cloud.
L'opzione PublicFolderToUnifiedGroup specifica una migrazione da cartelle pubbliche a Gruppi di Microsoft 365. Con questa opzione non è necessario specificare alcun valore.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoveOnCopy
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Fill RemoveOnCopy Description }}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-RenamePrimaryCalendar
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Fill RenamePrimaryCalendar Description }}
Type: | SwitchParameter |
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 |
-Restore
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Descrizione ripristino riempimento }}
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-SkipCalendar
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione SkipCalendar specifica che si vuole ignorare la migrazione del calendario durante l'onboarding di Google Workspace. 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 |
-SkipContacts
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione SkipContacts specifica che si vuole ignorare la migrazione dei contatti durante l'onboarding di Google Workspace. 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 |
-SkipMail
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione SkipMail specifica che si vuole ignorare la migrazione della posta elettronica durante l'onboarding di Google Workspace. 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 |
-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: | 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 |
-SkipRules
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione SkipRules specifica che si vuole ignorare la migrazione delle regole durante l'onboarding di Google Workspace. 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 |
-SkipSteps
Questo parametro è disponibile solo in Exchange locale.
Il parametro SkipSteps consente di specificare i passaggi della migrazione a fasi di Exchange da ignorare. I valori validi sono:
- Nessuno (questo è il valore predefinito)
- SettingTargetAddress: non impostare l'indirizzo di posta elettronica di destinazione nella cassetta postale di origine. Questa impostazione impedisce l'inoltro della posta dalla cassetta postale originale alla nuova cassetta postale di cui è stata eseguita la migrazione.
Questo parametro viene applicato solo per le migrazioni di Exchange in fasi.
Type: | SkippableMigrationSteps[] |
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 |
-SourceEndpoint
Il parametro SourceEndpoint specifica l'endpoint di migrazione da usare per l'origine del batch di migrazione. Per creare l'endpoint di migrazione, usare il cmdlet New-MigrationEndpoint. È possibile usare qualsiasi valore che identifichi in modo univoco l'endpoint di migrazione. Ad esempio:
- Nome (valore della proprietà Identity)
- GUID
Questo parametro definisce le impostazioni usate per connettersi al server in cui si trovano le cassette postali di origine.
Type: | MigrationEndpointIdParameter |
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 |
-SourcePFPrimaryMailboxGuid
Questo parametro è disponibile solamente nel servizio basato su cloud.
{{ Fill SourcePFPrimaryMailboxGuid Description }}
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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: | True |
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 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, 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 |
-TargetArchiveDatabases
Il parametro TargetArchiveDatabases consente di specificare il database in cui verrà eseguita la migrazione delle cassette postali di archiviazione specificate nel batch di migrazione. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN"
.
Quando si immettono più valori, il servizio di migrazione seleziona un database come database di destinazione in cui spostare la cassetta postale di archiviazione.
È possibile usare questo parametro solo per le migrazioni di spostamento locale e remoto.
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 |
-TargetDatabases
Il parametro TargetDatabases consente di specificare l'identità del database in cui si spostano le cassette postali. È possibile utilizzare qualsiasi valore che identifichi il database in maniera univoca. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN"
.
Quando si immettono più valori, il servizio di migrazione seleziona un database come database di destinazione in cui spostare la cassetta postale.
È possibile usare questo parametro solo per le migrazioni di spostamento locale e remoto.
Se non si usa questo parametro per uno spostamento locale, il cmdlet usa la logica di distribuzione automatica delle cassette postali per selezionare il database.
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 |
-TargetDeliveryDomain
Il parametro TargetDeliveryDomain consente di specificare il nome di dominio completo dell'indirizzo di posta elettronica esterno creato nella foresta di origine per l'utente abilitato alla posta elettronica al termine del batch di migrazione.
Questo parametro è necessario per i batch di migrazione di trasferimento remoto e offboarding remoto
Type: | String |
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 |
-TargetEndpoint
Il parametro TargetEndpoint specifica l'endpoint di migrazione da usare per la destinazione del batch di migrazione. Per creare l'endpoint di migrazione, usare il cmdlet New-MigrationEndpoint. È possibile usare qualsiasi valore che identifichi in modo univoco l'endpoint di migrazione. Ad esempio:
- Nome (valore della proprietà Identity)
- GUID
Questo parametro definisce le impostazioni usate per connettersi al server di destinazione in cui verranno spostate le cassette postali.
Type: | MigrationEndpointIdParameter |
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 |
-TimeZone
Il parametro TimeZone consente di specificare il fuso orario dell'amministratore che invia il batch di migrazione.
Un valore valido per questo parametro è un nome di chiave del fuso orario supportato, "Pacific Standard Time"
ad esempio .
Per visualizzare i valori disponibili, eseguire il comando seguente: $TimeZone = Get-ChildItem "HKLM:\Software\Microsoft\Windows NT\CurrentVersion\Time zones" | foreach {Get-ItemProperty $_.PSPath}; $TimeZone | sort Display | Format-Table -Auto PSChildname,Display
.
Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
In Exchange locale il valore predefinito è l'impostazione del fuso orario del server Exchange.
In Exchange Online il valore predefinito è UTC
.
Type: | ExTimeZoneValue |
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 |
-UserIds
Il parametro UserIds consente di specificare gli utenti che si desidera copiare da un batch di migrazione esistente, ad esempio se una migrazione precedente ha avuto esito positivo. È possibile identificare un utente in base all'indirizzo di posta elettronica o al relativo valore della proprietà Guid dal cmdlet Get-MigrationUser. È possibile specificare più utenti separati da virgole.
Gli utenti specificati per questo parametro devono essere definiti in un batch di migrazione esistente.
Per disabilitare la migrazione degli utenti nel batch di migrazione originale, usare l'opzione DisableOnCopy con questo parametro.
Type: | MultiValuedProperty |
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 |
-Users
Il parametro Users consente di specificare gli utenti che si desidera copiare da un batch di migrazione esistente, ad esempio se una migrazione precedente ha avuto esito positivo. È possibile identificare gli utenti usando il cmdlet Get-MigrationUser. Ad esempio:
$Failed = Get-MigrationUser -Status failed
New-MigrationBatch -Name "Retry Failed Users" -Users $Failed
Gli utenti specificati per questo parametro devono essere definiti in un batch di migrazione esistente.
Per disabilitare la migrazione degli utenti nel batch di migrazione originale, usare l'opzione DisableOnCopy con questo parametro.
Type: | MultiValuedProperty |
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 |
-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 |
-WorkflowControlFlags
Il parametro WorkflowControlFlags specifica i controlli avanzati per i passaggi eseguiti nella migrazione. I valori validi sono:
- Nessuno (questo è il valore predefinito)
- InjectAndForget
- SkipSwitchover
Non usare il parametro a meno che non venga richiesto dal Servizio Supporto Tecnico Clienti Microsoft o dalla documentazione specifica.
Type: | MigrationWorkflowControlFlags |
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 |
-WorkflowTemplate
Il parametro WorkflowTemplate specifica i controlli avanzati per i passaggi eseguiti nella migrazione. Non usare il parametro a meno che non venga richiesto dal Servizio Supporto Tecnico Clienti Microsoft o dalla documentazione specifica.
Type: | String |
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 |
-WorkloadType
Questo parametro è disponibile solo in Exchange locale.
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | RequestWorkloadType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
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.