Get-MigrationBatch

  • Riferimento
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.