Uso del Shell de administración de Exchange para administrar colas
Se aplica a: Exchange Server 2013
Como en versiones anteriores de Exchange, puede usar el Shell de administración de Exchange en Microsoft Exchange Server 2013 para ver información sobre colas y mensajes en dichas colas, así como para realizar acciones administrativas en ellas. En Exchange 2013, hay colas en los servidores de buzones de correo y en los servidores de transporte perimetral. Este tema hace referencia a estos servidores como servidores de transporte.
Cuando utilice el Shell para ver y administrar colas y mensajes en cola en servidores de transporte, es importante entender cómo identificar las colas o los mensajes que quiere administrar. Generalmente, los servidores de transporte contienen una gran cantidad de colas y mensajes por entregar. Puede usar los parámetros de filtrado que están disponibles en los cmdlets de administración de colas y mensajes para identificar las colas y los mensajes que quiere ver o administrar.
Observe que también puede usar el Visor de cola en Exchange Toolbox para administrar colas y mensajes en cola. Sin embargo, los cmdlets para ver colas y mensajes admiten más propiedades y opciones de filtrado que el Visor de cola. Para obtener más información acerca del uso del Visor de cola, vea Visor de cola.
Parámetros de filtrado de la cola
La siguiente tabla describe los parámetros de filtrado que están disponibles en los cmdlets de administración de cola.
| Cmdlet | Parámetros de filtrado | Comentarios |
|---|---|---|
| Get-Queue | Identity Filter Include Exclude |
No puede usar el parámetro Identity en el mismo comando con los parámetros Filter . Puede usar los parámetros Include y Exclude con el parámetro Filter en el mismo comando. |
| Resume-Queue Retry-Queue Suspend-Queue |
Identity Filter |
Debe usar el parámetro Identity o el parámetro Filter , pero no puede usar ambos en el mismo comando. |
| Get-QueueDigest | Server Dag Site Forest Filter |
Debe usar el parámetro Server, Dag, Site o Forest , pero no puede usar ninguno de ellos juntos en el mismo comando. Puede usar el parámetro Filter con cualquiera de los demás parámetros de filtrado. |
Tenga en cuenta que un parámetro Server está disponible en todos los cmdlets de administración de colas. En el cmdlet Get-QueueDigest , el parámetro Server es un parámetro de ámbito que especifica el servidor o los servidores en los que desea ver información de resumen sobre las colas. En todos los demás cmdlets de administración de colas, se usa el parámetro Server para conectarse a un servidor específico y ejecutar los comandos de administración de colas en ese servidor. Puede usar el parámetro Server con o sin el parámetro Filter , pero no puede usar el parámetro Server con el parámetro Identity . Use el nombre de host del servidor de transporte o el FQDN con el parámetro Server .
Identidad de colas
El parámetro Identity en los cmdlets de administración de cola identifica una cola determinada. Cuando se usa el parámetro Identity , no se puede especificar ningún otro parámetro de filtrado de cola, ya que ya ha identificado de forma única la cola. El parámetro Identity usa la sintaxis <básica Cola de servidor>\<>.
El <marcador de posición Servidor> es el nombre de host o FQDN del servidor exchange, por ejemplo mailbox01 , o mailbox01.contoso.com. Si omite el <calificador de servidor> , el servidor local está implícito.
El < marcador de posición Cola> acepta uno de los siguientes valores:
Nombre de cola persistente: las colas persistentes tienen nombres únicos y coherentes en todos los servidores de transporte perimetral o de buzón. Los nombres de cola persistente son:
- Envío: esta cola contiene mensajes a la espera de que el categorizador los procese.
- Inaccesible: esta cola contiene mensajes que no se pueden enrutar. Esta cola no existe hasta que los mensajes se colocan en ella.
- Dudoso: esta cola contiene mensajes que se determina que son dañinos para el servidor exchange. Esta cola no existe hasta que los mensajes se colocan en ella.
Nombre de la cola de entrega: el nombre de una cola de entrega es el valor de la propiedad NextHopDomain de la cola. Por ejemplo, el nombre de la cola podría ser el espacio de direcciones de un conector de envío, el nombre de un sitio de Active Directory o el nombre de un DAG. Para obtener más información consulte la sección "NextHopSolutionKey" en el tema Colas.
Entero de cola: a las colas de entrega y a las colas instantáneas se les asigna un valor entero único en la base de datos de cola. Sin embargo, debe ejecutar el cmdlet Get-Queue para encontrar el valor entero de la cola en las propiedades Identity o QueueIdentity.
Nombre de la cola de sombras: una cola de instantáneas usa la sintaxis
Shadow\<QueueInteger>
En la tabla siguiente se resume la sintaxis que puede usar con el parámetro Identity en los cmdlets de administración de colas. En todos los valores, <Server> es el nombre de host o FQDN del servidor.
Formatos de identidad de cola
| Valor de parámetro de identidad | Descripción |
|---|---|
<Server>\<PersistentQueueName> o <PersistentQueueName> |
Una cola persistente en el servidor especificado o en el servidor local. <PersistentQueueName> es Submission, Unreachableo Poison. |
<Server>\<NextHopDomain> o <NextHopDomain> |
Una cola de entrega en el servidor especificado o en el servidor local. <NextHopDomain> es un destino de enrutamiento o un grupo de entrega para los mensajes en cola. Para obtener más información consulte la sección "NextHopSolutionKey" en el tema Colas. |
<Server>\<QueueInteger> o <QueueInteger> |
Una cola de entrega en el servidor especificado o en el servidor local. <QueueInteger> es el valor entero único de la cola que se muestra en la propiedad Identity del cmdlet Get-Queue. |
<Server>\Shadow\<QueueInteger> o Shadow\<QueueInteger> |
Una cola de duplicados en el servidor especificado o en el servidor local. |
<Server>\* o * |
Todas las colas en el servidor especificado o en el servidor local. Observe que estos valores sólo pueden usarse con el cmdlet Get-Queue. |
Parámetro Filter de colas
Puede usar el parámetro Filter en todos los cmdlets de administración de cola para especificar las colas que quiere ver o administrar en función de sus propiedades. El parámetro Filter crea una expresión con operadores de comparación que restringe la operación de cola a las colas que cumplen los criterios de filtro. Puede usar el -and operador lógico para especificar varias condiciones que deben coincidir con los resultados.
Para obtener una lista completa de las propiedades de cola que puede usar con el parámetro Filter , consulte Colas.
Para obtener una lista de los operadores de comparación que puede usar con el parámetro Filter , consulte la sección Operadores de comparación que se usarán al filtrar colas o mensajes en este tema.
Para obtener ejemplos de procedimientos que usan el parámetro Filter para ver y administrar colas, consulte Administración de colas.
Parámetros Include y Exclude
Exchange 2013 tiene los parámetros Include y Exclude disponibles en el Get-Queue cmdlet . Puede usar estos parámetros individualmente, juntos y con el parámetro Filter para ajustar los resultados de la cola en el servidor de transporte local o especificado. Por ejemplo, puede:
- Excluir las colas vacías de los resultados.
- Excluir las colas a destinos externos de los resultados.
- Incluir colas que tengan un determinado valor de DeliveryType en los resultados.
Los parámetros Include y Exclude usan las siguientes propiedades de cola para filtrar las colas:
| Valor | Descripción | Ejemplo de código de Shell |
|---|---|---|
DeliveryType |
Este valor incluye o excluye colas en función de la propiedad DeliveryType. Puede especificar distintos valores separados por comas. Los valores válidos de DeliveryType se explican en la sección "NextHopSolutionKey" del tema Colas . | En este ejemplo se devuelven todas las colas de entrega en el servidor local donde el próximo salto es un conector de envío en el servidor local que está configurado para un enrutamiento inteligente de hosts.Get-Queue -Include SmartHostConnectorDelivery |
Empty |
Este valor incluye o excluye colas vacías. Las colas vacías tienen el valor 0 en la propiedad MessageCount . |
En este ejemplo se devuelven todas las colas en el servidor local que contienen mensajesGet-Queue -Exclude Empty |
External |
Este valor incluye o excluye las colas que tienen el valor External de la propiedad NextHopCategory . Las colas externas siempre presentan uno de los siguientes valores para DeliveryType:
Para obtener más información consulte la sección "NextHopSolutionKey" en el tema Colas. |
En este ejemplo se devuelven todas las colas internas en el servidor localGet-Queue -Exclude External |
Internal |
Este valor incluye o excluye las colas que tienen el valor Internal de la propiedad NextHopCategory . Para obtener más información consulte la sección "NextHopSolutionKey" en el tema Colas. |
En este ejemplo se devuelven todas las colas internas en el servidor local. Get-Queue -Include Internal |
Tenga en cuenta que puede duplicar la funcionalidad de los parámetros Include y Exclude mediante el parámetro Filter . Por ejemplo, el comando Get-Queue -Exclude Empty produce el mismo resultado que Get-Queue -Filter "MessageCount -gt 0". Sin embargo, la sintaxis de los parámetros Include y Exclude es más sencilla y fácil de recordar.
Get-QueueDigest
Exchange 2013 agrega un nuevo cmdlet de cola denominado Get-QueueDigest. Este cmdlet le permite ver información acerca de algunas de las colas de su organización de Exchange, o de todas ellas, usando un único comando. Concretamente, el cmdlet Get-QueueDigest le permite ver información sobre colas basándose en su ubicación en los servidores, en DAG, en sitios de Active Directory o en todo el bosque de Active Directory. Observe que las colas de un servidor de transporte perimetral suscrito en una red perimetral no aparecen entre los resultados. De igual modo, Get-QueueDigest está disponible en un servidor de transporte perimetral, pero los resultados se acotan a las colas en el servidor de transporte perimetral.
Nota:
De forma predeterminada, el cmdlet Get-QueueDigest muestra las colas de entrega que contienen diez o más mensajes y los resultados que tienen entre uno y dos minutos de antigüedad. Si quiere ver las instrucciones para cambiar estos valores predeterminados, consulte Configurar Get-QueueDigest.
Los parámetros de filtrado y ordenación disponibles con el cmdlet Get-QueueDigest se describen en la tabla siguiente.
| Parámetro | Descripción |
|---|---|
| Dag, Server o Site | Estos parámetros son mutuamente excluyentes y establecen el ámbito del cmdlet. Debe especificar uno de estos parámetros o el modificador Bosque . Generalmente, usará el nombre del servidor, el DAG o el sitio de Active Directory, pero puede usar cualquier valor que identifique de forma única el servidor, el DAG o el sitio. Puede especificar varios servidores, DAG o sitios separados por comas. |
| Forest | Este modificador es necesario si no usa los parámetros Dag, Server o Site . No se especifica un valor con este modificador. Usando este modificador, obtiene colas de todos los servidores de buzones de correo Exchange 2013 en el bosque de Active Directory. No puede usar el modificador Bosque para ver colas en bosques remotos de Active Directory. |
| DetailsLevel | Este parámetro acepta los valores None, Normaly Verbose. El valor predeterminado es Normal. Cuando se usa el valor None, el nombre de la cola se omite de la columna Detalles en los resultados. |
| Filter | Este parámetro le permite filtrar las colas en función de sus propiedades. Puede utilizar cualquiera de las propiedades filtrables de la cola tal como se describe en el tema Filtros de cola. |
| GroupBy | Este parámetro agrupa los resultados de la cola. Se pueden agrupar los resultados por una de las siguientes propiedades:
De forma predeterminada, los resultados se agrupan por |
| ResultSize | Este parámetro limita los resultados de la cola hasta el valor que especifique. Las colas se ordenan en orden descendente en función del número de mensajes de la cola y se agrupan por el valor especificado por el parámetro GroupBy . El valor predeterminado es 1000. Esto significa que, de forma predeterminada, el comando muestra las primeras 1.000 colas agrupadas por NextHopDomain y las ordena de las colas que contienen más mensajes a las que contienen menos. |
| Timeout | El parámetro especifica el número de segundos antes de que se agote el tiempo de espera de la operación. El valor predeterminado es 00:00:10 o 10 segundos. |
En este ejemplo se devuelven todas las colas externas que no estén vacías en los servidores de buzones de correo Exchange 2013 denominados Mailbox01, Mailbox02 y Mailbox03.
Get-QueueDigest -Server Mailbox01,Mailbox02,Mailbox03 -Include External -Exclude Empty
Parámetros de filtrado de mensajes
La siguiente tabla describe los parámetros de filtrado que están disponibles en los cmdlets de administración de mensajes.
| Cmdlet | Parámetros de filtrado | Comentarios |
|---|---|---|
| Get-Message | Identity Filter Queue |
Todos los parámetros de filtrado son mutuamente excluyentes y puede usarlos juntos en el mismo comando. |
| Remove-Message Resume-Message Suspend-Message |
Identity Filter |
Debe usar el parámetro Identity o el parámetro Filter , pero no puede usar ambos en el mismo comando. |
| Export-Message | Identity | Se requiere el parámetro Identity . |
Tenga en cuenta que un parámetro Server está disponible en todos los cmdlets de administración de mensajes, excepto en el cmdlet Export-Message . Use el parámetro Server para conectarse a un servidor específico y ejecutar los comandos de administración de mensajes en ese servidor. Puede usar el parámetro Server con o sin el parámetro Filter , pero no puede usar el parámetro Server con el parámetro Identity . Use el nombre de host del servidor de transporte o el FQDN con el parámetro Server .
Identidad de mensaje
El parámetro Identity en los cmdlets de administración de mensaje identifica un mensaje específico en una o más colas. Cuando se usa el parámetro Identity , no se puede especificar ningún otro parámetro de filtrado de mensajes, ya que ya ha identificado de forma única el mensaje. El parámetro Identity usa la sintaxis <básica Server>\<Queue>\<MessageInteger>.
El <marcador de posición Servidor> es el nombre de host o FQDN del servidor exchange, por ejemplo mailbox01 , o mailbox01.contoso.com. Si omite el <calificador de servidor> , el servidor local está implícito.
El < marcador de posición Cola> acepta la identidad de la cola como se describe en la sección "Identidad de cola" de este tema. Por ejemplo, puede utilizar el nombre de cola persistente, el valor NextHopDomain o el valor entero único de la cola en la base de datos de colas.
El <marcador de posición MessageInteger> representa el valor entero único asignado al mensaje cuando entra por primera vez en la base de datos de cola en el servidor. Si el mensaje se envía a varios destinatarios que requieren varias colas, todas las copias del mensaje en todas las colas de la base de datos de colas tendrán el mismo valor entero. Sin embargo, debe ejecutar el cmdlet Get-Message para encontrar el valor entero del mensaje en las propiedades Identity o MessageIdentity.
En la tabla siguiente se resume la sintaxis que puede usar con el parámetro Identity en los cmdlets de administración de mensajes. En todos los valores, <Server> es el nombre de host o FQDN del servidor.
Formatos de identidad de mensaje
| Valor de parámetro de identidad | Descripción |
|---|---|
<Server>\<Queue>\<MessageInteger> o <Queue>\<MessageInteger> |
Un mensaje en una cola determinada en un servidor determinado o en el servidor local. <MessageInteger> es el valor entero único de la cola que se muestra en la propiedad Identity del cmdlet Get-Message. <Queue> representa uno de los siguientes valores:
|
<Server>\*\<MessageInteger>o o *\<MessageInteger><MessageInteger> |
Todas las copias del mensaje en todas las colas en las base de datos de colas en el servidor especificado o en el servidor local. |
Parámetro Filter de mensajes
Puede utilizar el parámetro Filter en los cmdlets Get-Message, Remove-Message, Resume-Message y Suspend-Message para especificar los mensajes que quiere ver o administrar en función de sus propiedades. El parámetro Filter crea una expresión con operadores de comparación que restringe la operación de mensaje a los mensajes que cumplen los criterios de filtro. Puede usar el -and operador lógico para especificar varias condiciones que deben coincidir con los resultados.
Para obtener una lista completa de las propiedades del mensaje que puede usar con el parámetro Filter , consulte Colas.
Para obtener una lista de los operadores de comparación que puede usar con el parámetro Filter , consulte la sección Operadores de comparación que se usarán al filtrar colas o mensajes en este tema.
Para obtener ejemplos de procedimientos que usan el parámetro Filter para ver y administrar mensajes, consulte Administración de colas.
Parámetro Queue
El parámetro Queue solo se usa con el cmdlet Get-Message . Puede usar este parámetro para obtener todos los mensajes de una cola específica o todos los mensajes de varias colas mediante el carácter comodín (*). Cuando use el parámetro Queue, use el formato <de identidad de cola Cola de servidor>\ como se describe en la sección "Identidad de cola" de este tema.<>
Operadores de comparación que puede utilizar al filtrar colas o mensajes
Cuando crea una expresión de filtrado de colas o mensajes usando el parámetro Filter, debe incluir un operador de comparación para el valor de propiedad coincidente. La tabla siguiente muestra los operadores de comparación que se pueden utilizar en una expresión de filtro y cómo funciona cada uno de ellos. Para todos los operadores, los valores comparados no distinguen mayúsculas de minúsculas.
Operadores de comparación
| Operador | Función | Ejemplo de código de Shell |
|---|---|---|
-eq |
Este operador se usa para especificar que el resultado debe coincidir exactamente con el valor de la propiedad que se suministra en la expresión. | Para mostrar una lista de todas las colas cuyo estado es Retry:Get-Queue -Filter "Status -eq 'Retry'" Para mostrar una lista de todos los mensajes cuyo estado es Retry: Get-Message -Filter "Status -eq 'Retry'" |
-ne |
Este operador se utiliza para especificar que el resultado no debe coincidir exactamente con el valor de la propiedad que se suministra en la expresión. | Para mostrar una lista de todas las colas cuyo estado no es Active:Get-Queue -Filter "Status -ne 'Active'" Para mostrar una lista de todos los mensajes cuyo estado no es Active: Get-Message -Filter "Status -ne 'Active'" |
-gt |
Este operador se utiliza con las propiedades cuyo valor se expresa como un entero o en formato fecha/hora. Los resultados del filtro sólo incluyen colas o mensajes en los que el valor de la propiedad especificada es mayor que el que se suministra en la expresión. | Para mostrar una lista de colas que actualmente contiene más de mil mensajes:Get-Queue -Filter "MessageCount -gt 1000" Para mostrar una lista de los mensajes cuyo número de reintentos es actualmente superior a 3: Get-Message -Filter "RetryCount -gt 3" |
-ge |
Este operador se utiliza con las propiedades cuyo valor se expresa como un entero o en formato fecha/hora. Los resultados del filtro sólo incluyen colas o mensajes en los que el valor de la propiedad especificada es mayor o igual que el que se suministra en la expresión. | Para mostrar una lista de colas que actualmente contiene mil mensajes, o más:Get-Queue -Filter "MessageCount -ge 1000" Para mostrar una lista de los mensajes cuyo número de reintentos es actualmente superior o igual a 3: Get-Message -Filter "RetryCount -ge 3" |
-lt |
Este operador se utiliza con las propiedades cuyo valor se expresa como un entero o en formato fecha/hora. Los resultados del filtro sólo incluyen colas o mensajes en los que el valor de la propiedad especificada es menor que el que se suministra en la expresión. | Para mostrar una lista de colas que actualmente contiene menos de mil mensajes:Get-Queue -Filter "MessageCount -lt 1000" Para mostrar una lista de los mensajes cuyo SCL es inferior a 6: Get-Message -Filter "SCL -lt 6" |
-le |
Este operador se utiliza con las propiedades cuyo valor se expresa como un entero o en formato fecha/hora. Los resultados del filtro sólo incluyen las colas o mensajes en los que el valor de la propiedad especificada es menor o igual que el que se suministra en la expresión. | Para mostrar una lista de colas que actualmente contiene mil mensajes o menos:Get-Queue -Filter "MessageCount -le 1000" Para mostrar una lista de los mensajes cuyo SCL es inferior o igual a 6: Get-Message -Filter "SCL -le 6" |
-like |
Este operador se utiliza con las propiedades en las que el valor se expresa en forma de cadena de texto. Los resultados del filtro sólo incluyen las colas o mensajes en los que el valor de la propiedad especificada contiene la cadena de texto que se suministra en la expresión. Puede incluir el carácter comodín (*) en una expresión similar a la que se aplica a un campo de cadena de texto, pero no con un campo que tenga el tipo de enumeración. | Para mostrar una lista de colas de entrega que tienen un destino en cualquier dominio SMTP que termine en Contoso.com:Get-Queue -Filter "Identity -like '*contoso.com'" Para mostrar una lista de los mensajes cuyo asunto contiene el texto "préstamo de día de paga": Get-Messages -Filter "Subject -like '*payday loan*'" |
Puede especificar un filtro que evalúe varias expresiones usando el operador de comparación -and. Las colas o mensajes deben cumplir con todas las condiciones del filtro para que aparezcan en los resultados.
En este ejemplo se muestra una lista de las colas que tienen como destino cualquier nombre de dominio SMTP que termine en contoso.com y que actualmente contienen más de 500 mensajes.
Get-Queue -Filter "Identity -like '*contoso.com*' -and MessageCount -gt 500"
En este ejemplo se muestra una lista de los mensajes que se envían desde cualquier dirección de correo en el dominio contoso.com que tienen un SCL mayor que 5.
Get-Message -Filter "FromAddress -like '*Contoso.com*' -and SCL -gt 5"
Parámetros de paginación avanzados
En función del flujo de correo actual, las consultas a colas y mensajes pueden devolver un conjunto muy amplio de objetos. Puede usar los parámetros de paginación avanzados para controlar cómo se recuperan y muestran los resultados de una consulta.
Si usa el Shell para ver colas y los mensajes en esas colas, la consulta recuperará las páginas de información de a una por vez. Los parámetros de paginación avanzados controlan el tamaño del conjunto de resultados y también se pueden usar para ordenarlos. Los parámetros de paginación avanzados son opcionales y se pueden combinar con aquellos conjuntos de parámetros que se puedan usar con los cmdlets Get-Queue y Get-Message. Si no se especifican parámetros de paginación avanzados, la consulta devolverá los resultados en orden ascendente de identidad.
De forma predeterminada, si se especifica un criterio de ordenación, la propiedad de identidad de mensaje se incluye siempre y el orden es ascendente. Ésta es la relación de ordenación predeterminada. Se incluye la propiedad de identidad de mensaje porque el resto de las propiedades que se pueden incluir en un criterio de ordenación no son únicas. La inclusión explícita de la propiedad de identidad de mensaje en el criterio de ordenación permite especificar que los resultados muestren la identidad de mensaje en orden descendente.
Puede usar los parámetros BookmarkIndex y BookmarkObject para marcar una posición en el conjunto de resultados ordenado. Si el objeto de marcador ya no existe cuando se recupera la página de resultados siguiente, la relación de ordenación predeterminada se asegura de que el conjunto de resultados se inicie con el objeto más cercano al marcador. El objeto más cercano depende del criterio de ordenación especificado.
La tabla siguiente describe los parámetros de paginación avanzados.
| Parámetro | Descripción |
|---|---|
| BookmarkIndex | Este parámetro especifica la posición en el conjunto de resultados donde se inician los resultados mostrados. El valor de este parámetro es un índice de base 1 en el conjunto de resultados totales. Si el valor es menor que cero o igual a cero, se devuelve la primera página completa de resultados. Si el valor se establece en Int.MaxValue, se devuelve la última página completa de resultados. |
| BookmarkObject | Este parámetro especifica el objeto en el conjunto de resultados donde se inician los resultados mostrados. Si se especifica un objeto de marcador, éste se usará como punto de inicio para la búsqueda. Se recuperan las filas anteriores o posteriores a ese objeto, en función del valor del parámetro SearchForward . No puede combinar el parámetro BookmarkObject y el parámetro BookmarkIndex en una sola consulta. |
| IncludeBookmark | Este parámetro especifica si se debe incluir el objeto de marcador en el conjunto de resultados. De forma predeterminada, el valor se establece en $true y se incluye el objeto bookmark. Puede realizar una consulta para obtener un conjunto de resultados limitado y usar el último elemento de dicho conjunto como marcador para la consulta siguiente. En este caso, es posible que desee establecer IncludeBookmark en para $false que el objeto no se incluya en ambos conjuntos de resultados. |
| ResultSize | Este parámetro especifica el número de resultados que se mostrarán por página. Si no se especifica un valor, se usará el tamaño de resultados predeterminado de 1000 objetos. Exchange limita el conjunto de resultados a 250.000. |
| ReturnPageInfo | Este parámetro es un parámetro oculto. Devuelve información acerca del número total de resultados y el índice del primer objeto de la página actual. El valor predeterminado es $false. |
| SearchForward | El parámetro especifica si la búsqueda se realiza hacia adelante o hacia atrás en el conjunto de resultados. Este parámetro no afecta al orden en el que se devuelve el conjunto de resultados. Determina la dirección de búsqueda en relación con el índice de marcador o el objeto. Si no se especifica ningún índice o objeto de marcador, el parámetro SearchForward determina si la búsqueda comienza desde el primer o último objeto del conjunto de resultados. El valor predeterminado de este parámetro es $true. Si el parámetro this se establece en $true y se especifica un marcador, la consulta busca hacia delante desde ese marcador. Si usa esta configuración y no se obtienen resultados posteriores al marcador, la consulta devuelve la última página de resultados. Si el parámetro SearchForward está establecido en $false y se especifica un marcador, la consulta busca hacia atrás desde ese marcador. Si usa esta configuración y se obtiene menos de una página completa de resultados posterior al marcador, la consulta devuelve la primera página completa de resultados. |
| SortOrder | El parámetro especifica una matriz de propiedades de mensaje que se usa para controlar el criterio de ordenación del conjunto de resultados. Las propiedades del criterio de ordenación se especifican en orden descendente de precedencia. Las propiedades están separadas por comas y se anexa un signo más (+) para ordenar en orden ascendente, o un signo menos (-) para ordenar en orden descendente. Si no se especifica un criterio de ordenación explícito con este parámetro, los registros que cumplan la consulta se mostrarán y ordenarán por el campo Identidad del tipo de objeto respectivo. Si no se especifica ningún criterio de ordenación, los resultados se ordenan siempre por identidad en orden ascendente. |
En el ejemplo de código siguiente se muestra cómo usar los parámetros de paginación avanzados en una consulta. En este ejemplo, el comando se conecta al servidor especificado y recupera un conjunto de resultados que contiene 500 objetos. Los resultados se muestran en función de un criterio de ordenación: primero en orden ascendente por dirección de remitente y, a continuación, en orden ascendente por tamaño de mensaje.
Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size
Si desea ver las páginas siguientes, puede establecer un marcador para el último objeto recuperado en un conjunto de resultados y ejecutar una consulta adicional. Para este procedimiento, es necesario utilizar las funciones asociadas a los scripts del Shell.
El en ejemplo siguiente se usan scripts para recuperar la primera página de resultados, se establece el objeto de marcador, se excluye el objeto de marcador del conjunto de resultados y, por último, se recuperan del servidor especificado los 500 objetos siguientes.
Abra el Shell y escriba el comando siguiente para recuperar la primera página de resultados.
$Results=Get-message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-SizePara establecer el objeto de marcador, escriba el comando siguiente para guardar el último elemento de la primera página en una variable.
$temp=$results[$results.length-1]Para recuperar los 500 objetos siguientes del servidor especificado y excluir el objeto de marcador, escriba el comando siguiente.
Get-message -Server mailbox01.contoso.com -BookmarkObject:$temp -IncludeBookmark $False -ResultSize 500 -SortOrder +FromAddress,-Size