Compartir a través de

Get-MailboxImportRequest

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-MailboxImportRequest para ver el estado detallado de una solicitud de importación en curso que se inició mediante el cmdlet New-MailboxImportRequest.

Este cmdlet solo está disponible en el rol Exportación de importación de buzones y, de forma predeterminada, el rol no está asignado a ningún grupo de roles. Para usar este cmdlet, deberá agregar el rol de importación y exportación de buzón de correo a un grupo de roles (por ejemplo, al grupo de roles de administración de la organización). Para obtener más información, vea Agregar un rol a un grupo de roles.

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-MailboxImportRequest
    [[-Identity] <MailboxImportRequestIdParameter>]
    [-DomainController <Fqdn>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Filtering 

Get-MailboxImportRequest
    [-Mailbox <MailboxLocationIdParameter>]
    [-BatchName <String>]
    [-Database <DatabaseIdParameter>]
    [-DomainController <Fqdn>]
    [-HighPriority <Boolean>]
    [-Name <String>]
    [-ResultSize <Unlimited>]
    [-Status <RequestStatus>]
    [-Suspend <Boolean>]
    [-RequestQueue <DatabaseIdParameter>]
    [<CommonParameters>]

Description

El criterio de búsqueda para el cmdlet Get-MailboxImportRequest es una instrucción booleana And. Si usa varios parámetros, se limita la búsqueda y se reducen los resultados.

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-MailboxImportRequest -Identity "tony\Recovered"

En este ejemplo se devuelve la información predeterminada respecto al estado de la solicitud de importación en curso con la identidad tony\Recovered. De forma predeterminada, el tipo de información que se devuelve incluye el nombre, el buzón y el estado.

Ejemplo 2

Get-MailboxImportRequest -Status InProgress -Database DB01

En Exchange Server 2010, este ejemplo devuelve el estado de las solicitudes de importación en curso para buzones o archivos que residen en la base de datos DB01.

Ejemplo 3

Get-MailboxImportRequest -BatchName "ImportingDB1PSTs" -Status Completed

En este ejemplo se recupera el estado de las solicitudes de importación en el lote ImportingDB1PSTs que se completó.

Ejemplo 4

Get-MailboxImportRequest -Name "Recovered" -Suspend $true

En este ejemplo se devuelven todas las solicitudes de importación que tienen el nombre Recuperado donde se suspende la importación.

Parámetros

-BatchName

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

El parámetro BatchName especifica el nombre que se asignó a una solicitud de importación de lote.

Nombre de la base de datos

Propiedades de parámetro

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

Conjuntos de parámetros

MailboxFiltering
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
MailboxLocationFiltering
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

-Database

Aplicable: Exchange Server 2010

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro Database especifica la base de datos en la que reside el buzón o el archivo del usuario. Puede usar cualquier valor que identifique la base de datos de forma exclusiva. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID

Nombre de la base de datos

Propiedades de parámetro

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

Conjuntos de parámetros

MailboxFiltering
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
MailboxLocationFiltering
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 2010, 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

-HighPriority

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

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

El parámetro HighPriority filtra los resultados en función del valor priority que se asignó cuando se creó la solicitud. La entrada válida para este parámetro es $true o $false. Este es el modo en que estos valores filtran los resultados:

  • $true Devuelve las solicitudes que se crearon con el valor De prioridad Alto, Mayor, Mayor o Emergencia.
  • $false Devuelve las solicitudes que se crearon con el valor De prioridad Normal, Bajo, Inferior o Menor.

Nombre de la base de datos

Propiedades de parámetro

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

Conjuntos de parámetros

MailboxFiltering
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
MailboxLocationFiltering
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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro Identity especifica la identidad de la solicitud de importación. De forma predeterminada, las solicitudes de importación se denominan <alias>\MailboxImportX (donde X = 0-9). Si especifica un nombre para la solicitud de importación, use la sintaxis siguiente: Alias\Name. Microsoft Exchange precede automáticamente a la solicitud con el alias del buzón.

Este parámetro no se puede usar junto con los parámetros siguientes:

  • BatchName
  • Mailbox
  • Nombre
  • Estado
  • Suspender
  • HighPriority

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

-Mailbox

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

Este parámetro solo es funcional en Exchange local.

El parámetro Mailbox filtra los resultados por el buzón de destino al que se importa el contenido.

En Exchange 2016 CU7 o posterior, el tipo de parámetro es MailboxLocationIdParameter. El valor alias es la manera más fácil de identificar el buzón.

Nombre de la base de datos

Sugerencia: En Exchange 2016 CU6 o versiones anteriores, el tipo de parámetro era MailboxOrMailUserIdParameter. Puede usar cualquier valor que identifique de forma única el buzón (incluido alias).

Propiedades de parámetro

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

Conjuntos de parámetros

MailboxLocationFiltering
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

-Name

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

El parámetro Name especifica que se devuelvan las solicitudes de importación que tienen el nombre especificado.

Utilice este parámetro para buscar el nombre que proporcionó cuando creó la solicitud de importación. Si no especificó un nombre cuando creó la solicitud, el nombre predeterminado es MailboxImportX (donde X = 0-9).

Nombre de la base de datos

Propiedades de parámetro

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

Conjuntos de parámetros

MailboxFiltering
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
MailboxLocationFiltering
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

-RequestQueue

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 RequestQueue identifica la solicitud en función de la base de datos de buzón donde se ejecuta la solicitud. Puede usar cualquier valor que identifique la base de datos de forma exclusiva. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID

Nombre de la base de datos

Propiedades de parámetro

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

Conjuntos de parámetros

MailboxFiltering
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
MailboxLocationFiltering
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 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro Status filtra los resultados en función del estado. Puede usar los siguientes valores:

  • AutoSuspended
  • Completado
  • CompletedWithWarning
  • CompletionInProgress
  • Error
  • InProgress
  • En cola
  • Reintentando
  • Suspended
  • Sincronizado

Nombre de la base de datos

CompletionInProgress y AutoSuspended no se aplican a las solicitudes de importación y no devuelven ninguna información.

Propiedades de parámetro

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

Conjuntos de parámetros

MailboxFiltering
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
MailboxLocationFiltering
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

-Suspend

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

El parámetro Suspend especifica si se deben devolver las solicitudes que se han suspendido. La entrada válida para este parámetro es $true o $false.

Nombre de la base de datos

Propiedades de parámetro

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

Conjuntos de parámetros

MailboxFiltering
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
MailboxLocationFiltering
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.