Compartir a través de

Get-MigrationUser

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.

Utilice el cmdlet Get-MigrationUser para ver información sobre los usuarios de migración y de movimiento.

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

MailboxGuid 

Get-MigrationUser
    -MailboxGuid <Guid>
    [-DomainController <Fqdn>]
    [-IncludeAssociatedUsers]
    [-ResultSize <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [<CommonParameters>]

StatusAndBatchId 

Get-MigrationUser
    [-BatchId <MigrationBatchIdParameter>]
    [-Status <MigrationUserStatus>]
    [-StatusSummary <MigrationUserStatusSummary>]
    [-DomainController <Fqdn>]
    [-IncludeAssociatedUsers]
    [-ResultSize <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [<CommonParameters>]

Identity 

Get-MigrationUser
    [[-Identity] <MigrationUserIdParameter>]
    [-DomainController <Fqdn>]
    [-IncludeAssociatedUsers]
    [-ResultSize <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [<CommonParameters>]

EmailAddress 

Get-MigrationUser
    -EmailAddress <SmtpAddress>
    [-DomainController <Fqdn>]
    [-IncludeAssociatedUsers]
    [-ResultSize <Unlimited>]
    [-Partition <MailboxIdParameter>]
    [<CommonParameters>]

Description

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.

Ejemplos

Ejemplo 1

Get-MigrationUser -Identity TonySmith@contoso.com

En este ejemplo se recupera información de estado acerca del usuario migrado recientemente, Tony Smith.

Ejemplo 2

Get-MigrationUser -MailboxGuid b6a6795c-a010-4f67-aaaa-da372d56fcb9 | Get-MigrationUserStatistics

En este ejemplo se recupera información más detallada sobre las migraciones en curso para el usuario con el GUID de buzón especificado.

Ejemplo 3

Get-MigrationUser -EmailAddress TonySmith@contoso.com

En este ejemplo se recupera información de estado acerca del usuario migrado recientemente, Tony Smith.

Ejemplo 4

Get-MigrationUser -EmailAddress TonySmith@contoso.com | Get-MigrationUserStatistics

En este ejemplo se recupera información más detallada sobre cualquier migración en curso para el usuario con la dirección de correo electrónico especificada.

Parámetros

-BatchId

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

El parámetro BatchId especifica el nombre del lote de migración para el que desea devolver usuarios.

Propiedades de parámetro

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

Conjuntos de parámetros

StatusAndBatchId
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

(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

-EmailAddress

Aplicable: Exchange Online

El parámetro EmailAddress especifica el usuario concreto sobre el que desea recuperar información. El parámetro EmailAddress se representa como una dirección de correo electrónico. Este parámetro solo está disponible en el servicio basado en la nube.

Propiedades de parámetro

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

Conjuntos de parámetros

EmailAddress
Posición:Named
Obligatorio:True
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 especifica la migración en curso concreta sobre la que desea recuperar información. El parámetro Identity normalmente se representa como una dirección de correo electrónico.

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:MigrationUserIdParameter
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

-IncludeAssociatedUsers

Aplicable: Exchange Online

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

{{ Fill IncludeAssociatedUsers Description }}

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

-MailboxGuid

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

El parámetro MailboxGuid especifica el GUID del buzón para el que desea ver la información de migración.

Propiedades de parámetro

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

Conjuntos de parámetros

MailboxGuid
Posición:Named
Obligatorio:True
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

(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

-ResultSize

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

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

(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

-Status

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

El parámetro Status devuelve información sobre los usuarios de migración que tienen un estado específico. Use uno de los siguientes valores:

  • Completado
  • CompletedWithWarnings
  • Completar
  • CompletionFailed
  • CompletionSynced
  • Dañado
  • Error
  • IncrementalFailed
  • IncrementalStopped
  • IncrementalSynced
  • IncrementalSyncing
  • Aprovisionamiento
  • ProvisionUpdating
  • En cola
  • Quitar
  • Iniciando
  • Detenido
  • Parar
  • Sincronizado
  • Sincronización
  • Validating

Propiedades de parámetro

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

Conjuntos de parámetros

StatusAndBatchId
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

-StatusSummary

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

El parámetro StatusSummary devuelve información abreviada sobre los usuarios de migración que tienen un valor de estado específico. Use uno de los siguientes valores:

  • Activo
  • Completado
  • Error
  • Detenido
  • Sincronizado

Propiedades de parámetro

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

Conjuntos de parámetros

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