Get-MigrationBatch

Modulo:

ExchangePowerShell

Si applica a:

Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Il cmdlet Get-MigrationBatch consente di ottenere informazioni sullo stato solo del batch di migrazione corrente.

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

Sintassi

Get-MigrationBatch
   [-Endpoint <MigrationEndpointIdParameter>]
   [-Diagnostic]
   [-DiagnosticArgument <String>]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-IncludeReport]
   [-Partition <MailboxIdParameter>]
   [-Status <Microsoft.Exchange.Data.Storage.Management.MigrationBatchStatus>]
   [<CommonParameters>]

Get-MigrationBatch
   [[-Identity] <MigrationBatchIdParameter>]
   [-Diagnostic]
   [-DiagnosticArgument <String>]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-IncludeReport]
   [-Partition <MailboxIdParameter>]
   [-Status <Microsoft.Exchange.Data.Storage.Management.MigrationBatchStatus>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-MigrationBatch mostra informazioni sul batch di migrazione corrente. Sono incluse le seguenti informazioni:

• Stato del batch di migrazione
• Numero totale di cassette postali di cui eseguire la migrazione
• Numero di migrazioni completate correttamente
• Errori di migrazione
• Data e ora di avvio e completamento della migrazione.

È 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.

Nota: nel servizio basato sul cloud, se non si usa il parametro TimeZone nel comando New-MigrationBatch, il fuso orario predefinito per il batch di migrazione è UTC. Le proprietà CompleteAfter e CompleteAfterUTC conterrà lo stesso valore (così come le proprietà StartAfter e StartAfterUTC). Quando si crea il batch di migrazione nell'interfaccia di amministrazione di Exchange, il fuso orario usato si basa sulla configurazione a livello di area.

Esempio

Esempio 1

Get-MigrationBatch -Identity LocalMove2

Con questo esempio vengono visualizzate le informazioni sullo stato per il batch di migrazione LocalMove2.

Esempio 2

Get-MigrationBatch -Endpoint exsrv1.contoso.com

Con questo esempio vengono visualizzate le informazioni su tutti i batch di migrazione associati all'endpoint di migrazione exsrv1.contoso.com.

Parametri

-Diagnostic

Questo parametro è disponibile solo in Exchange locale.

L'opzione Diagnostic consente di specificare se restituire informazioni estremamente dettagliate nei risultati. Con questa opzione non è necessario specificare alcun valore.

In genere, si utilizza questa opzione solo su richiesta di risoluzione dei problemi da parte del Supporto tecnico Microsoft.

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

-DiagnosticArgument

Questo parametro è disponibile solo in Exchange locale.

Il parametro DiagnosticArgument consente di modificare i risultati che vengono restituiti tramite l'opzione Diagnostic. In genere, l'opzione Diagnostic e il parametro DiagnosticArgument si utilizzano solo su richiesta di risoluzione dei problemi da parte del Supporto tecnico Microsoft.

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

-DiagnosticInfo

Questo parametro è disponibile solamente nel servizio basato su cloud.

In genere, si usa il parametro DiagnosticInfo solo su richiesta di Microsoft servizio clienti e supporto tecnico per risolvere i problemi. I valori validi sono:

• attachmentid=String
• batch=String
• Confermare
• duration=String
• Endpoint
• endtime=DateTime
• maxsize=Int32
• organization=String
• partition=String
• reportid=String
• Rapporti
• showtimeline
• showtimeslots=String
• starttime=DateTime
• status=String
• Archiviazione
• type=String
• user=String
• Dettagliato

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

-DomainController

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Endpoint

Il parametro Endpoint consente di restituire un elenco di batch di migrazione associati all'endpoint di migrazione specificato.

Se si utilizza questo parametro, non è possibile includere il parametro Identity.

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

-Identity

Il parametro Identity consente di identificare il nome del batch di migrazione corrente. Il valore per tale parametro è specificato dal parametro Name per il cmdlet New-MigrationBatch.

Se si utilizza questo parametro, non è possibile includere il parametro Endpoint.

Type:	MigrationBatchIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeReport

L'opzione IncludeReport restituisce informazioni aggiuntive sul batch di migrazione specificato. Con questa opzione non è necessario specificare alcun valore.

Queste informazioni vengono visualizzate nel campo Report.

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

-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

-Status

Il parametro Status consente di restituire un elenco di batch di migrazione con lo stato specificato. Utilizzare uno dei seguenti valori:

• Completata
• CompletedWithErrors
• Completamento
• Danneggiato
• Creazione
• Esito negativo
• IncrementalSyncing
• Rimozione
• In avvio
• Arrestato
• Sincronizzazione in corso
• Fermarsi
• Sincronizzati
• SyncedwithErrors
• Attesa

Type:	Microsoft.Exchange.Data.Storage.Management.MigrationBatchStatus
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.