Compartir a través de

Get-MigrationBatch

Módulo:
Exchange PowerShell

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Algunos parámetros y configuraciones pueden ser exclusivos de un entorno u otro.

Use el cmdlet Get-MigrationBatch para recuperar información de estado del lote de migración actual.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

Identity 

Get-MigrationBatch
    [[-Identity] <MigrationBatchIdParameter>]
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DiagnosticInfo <String>]
    [-DomainController <Fqdn>]
    [-IncludeReport]
    [-Partition <MailboxIdParameter>]
    [-ResultSize <Unlimited>]
    [-Status <MigrationBatchStatus>]
    [<CommonParameters>]

BatchesFromEndpoint 

Get-MigrationBatch

    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-Endpoint <MigrationEndpointIdParameter>]
    [-IncludeReport]
    [-Status <MigrationBatchStatus>]
    [<CommonParameters>]

BatchesByEndpoint 

Get-MigrationBatch

    [-DiagnosticInfo <String>]
    [-Endpoint <MigrationEndpointIdParameter>]
    [-IncludeReport]
    [-Partition <MailboxIdParameter>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

BatchesByStatus 

Get-MigrationBatch

    [-DiagnosticInfo <String>]
    [-IncludeReport]
    [-Partition <MailboxIdParameter>]
    [-ResultSize <Unlimited>]
    [-Status <MigrationBatchStatus>]
    [<CommonParameters>]

Description

El cmdlet Get-MigrationBatch muestra la información de estado del lote de migración actual. Esta información incluye la siguiente información:

  • Estado del lote de migración
  • Número total de buzones que se migrarán
  • Número de migraciones completadas correctamente
  • Errores de migración
  • Fecha y hora en que se inició y completó la migración.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Nota: En el servicio basado en la nube, si no usa el parámetro TimeZone en el comando New-MigrationBatch, la zona horaria predeterminada para el lote de migración es UTC. Las propiedades CompleteAfter y CompleteAfterUTC contienen el mismo valor (y también las propiedades StartAfter y StartAfterUTC). Al crear el lote de migración en el Centro de administración de Exchange (EAC), la zona horaria que se usa se basa en la configuración regional.

Ejemplos

Ejemplo 1

Get-MigrationBatch -Identity LocalMove2

Este ejemplo muestra la información de estado del lote de migración LocalMove2.

Ejemplo 2

Get-MigrationBatch -Endpoint exsrv1.contoso.com

Este ejemplo muestra información sobre todos los lotes de migración asociados al extremo de migración exsrv1.contoso.com.

Parámetros

-Diagnostic

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parámetro solo está disponible en Exchange local.

El modificador Diagnostic especifica si se va a devolver información extremadamente detallada en los resultados. No es necesario especificar un valor con este modificador.

Normalmente, solo se usa este modificador a petición del servicio de soporte técnico y servicio al cliente de Microsoft para solucionar problemas.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BatchesFromEndpoint
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DiagnosticArgument

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parámetro solo está disponible en Exchange local.

El parámetro DiagnosticArgument modifica los resultados devueltos mediante el modificador Diagnostic. Normalmente, solo se usa el modificador Diagnostic y el parámetro DiagnosticArgument a petición del servicio de soporte técnico y servicio al cliente de Microsoft para solucionar problemas.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BatchesFromEndpoint
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DiagnosticInfo

Aplicable: Exchange Online

Este parámetro solo está disponible en el servicio basado en la nube.

Normalmente, el parámetro DiagnosticInfo solo se usa a petición del servicio de atención al cliente y soporte técnico de Microsoft para solucionar problemas. Los valores admitidos son:

  • attachmentid=String
  • batch=String
  • confirmar
  • duration=String
  • endpoints
  • endtime=DateTime
  • maxsize=Int32
  • organization=String
  • partition=String
  • reportid=String
  • Informes
  • showtimeline
  • showtimeslots=String
  • starttime=DateTime
  • status=String
  • almacenamiento
  • type=String
  • user=String
  • verboso

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BatchesByEndpoint
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BatchesByStatus
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DomainController

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Propiedades de parámetro

Tipo:Fqdn
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BatchesFromEndpoint
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Endpoint

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro Endpoint devuelve una lista de lotes de migración asociados con el extremo de migración especificado.

Si usa este parámetro, no puede incluir el parámetro Identity.

Propiedades de parámetro

Tipo:MigrationEndpointIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

BatchesFromEndpoint
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BatchesByEndpoint
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro Identity identifica el nombre del lote de migración actual. El valor de este parámetro lo especifica el parámetro Name del cmdlet New-MigrationBatch.

Si usa este parámetro, no puede incluir el parámetro Endpoint.

Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores del parámetro Identity son precisas y no contienen valores $null inexistentes.

Propiedades de parámetro

Tipo:MigrationBatchIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:1
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IncludeReport

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El modificador IncludeReport devuelve información adicional sobre el lote de migración especificado. No es necesario especificar un valor con este modificador.

Esta información se muestra en el campo Report.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Partition

Aplicable: Exchange Online

Este parámetro solo está disponible en el servicio basado en la nube.

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Tipo:MailboxIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BatchesByEndpoint
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BatchesByStatus
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResultSize

Aplicable: Exchange Online

Este parámetro solo está disponible en el servicio basado en la nube.

El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. Si desea incluir en los resultados devueltos todas las solicitudes que coincidan con la consulta, use el valor ilimitado para este parámetro. El valor predeterminado es 1000.

Propiedades de parámetro

Tipo:Unlimited
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BatchesByEndpoint
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BatchesByStatus
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Status

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro Status devuelve una lista de lotes de migración que tienen el estado especificado. Use uno de los siguientes valores:

  • Completado
  • CompletedWithErrors
  • Completar
  • Dañado
  • Creados
  • Error
  • IncrementalSyncing
  • Quitar
  • Iniciando
  • Detenido
  • Sincronización
  • Parar
  • Sincronizado
  • SyncedwithErrors
  • Espera

Propiedades de parámetro

Tipo:MMigrationBatchStatus
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BatchesFromEndpoint
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
BatchesByStatus
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.