Utilización de Shell de administración de Exchange para administrar colas
Se aplica a: Exchange Server 2010 SP2, Exchange Server 2010 SP3
Última modificación del tema: 2015-03-09
En este tema, se explica cómo puede usar los conjuntos de cmdlets y parámetros del Shell de administración de Exchange para crear una consulta, recuperar los resultados y realizar acciones de modificación. Para obtener más información acerca de las tareas de colas y cómo se pueden usar para supervisar y solucionar problemas, consulte Descripción de las colas de transporte.
En Microsoft Exchange Server 2010, puede usar el Shell para realizar tareas de administración y configuración, y crear scripts para automatizar tareas. También se puede usar el Shell para ver información acerca de las colas de un servidor y los mensajes en dichas colas y para realizar acciones de administración en colas y elementos de correo. Estas operaciones son útiles para solucionar problemas del flujo de correo e identificar correo no deseado. Para obtener más información acerca del uso del Shell, consulte Usar PowerShell con Exchange 2010 (Shell de administración de Exchange).
¿Está buscando tareas de administración relacionadas con colas? Consulte Administración de colas de transporte.
Contenido
Administración de colas y mensajes
Cmdlets de cola
Conjuntos de parámetros de tarea de cola
Administración de colas y mensajes
Las tareas de colas se agrupan en dos categorías:
Las acciones de visualización muestran las colas y los mensajes en cola de un servidor ,y seleccionan el modo en que se agrupan y ordenan los datos que se visualizan.
Las acciones de modificación cambian el estado de las colas y los mensajes.
Ambos tipos de tareas tienen acceso a los datos al conectarse al proceso de trabajo de transporte con una llamada a procedimiento remoto (RPC).
De forma predeterminada, el Visor de cola se centra en la base de datos en cola ubicada en el servidor al que se conecta el Visor de cola para ejecutar las tareas. Sin embargo, puede conectarse a un servidor distinto al que ejecuta las tareas del Visor de cola.
Para obtener más información acerca del proceso de transporte de Exchange 2010, consulte Descripción de la canalización de transporte. Para obtener más información acerca de cómo usar el Shell de administración para ver colas y mensajes, consulte Ver colas y Ver propiedades del mensaje en cola.
Volver al principio
Cmdlets de cola
En la tabla siguiente, se enumeran los cmdlets de los que dispone el Shell para administrar las colas y los mensajes en dichas colas. Para obtener más información acerca de cómo usar cada cmdlet, consulte los temas de Ayuda enumerados en la columna Para más información.
Cmdlets de cola
| Cmdlet | Uso | Para obtener más información |
|---|---|---|
Export-Message |
Este cmdlet guarda una copia de un mensaje en una ruta de archivo que especifica el administrador. |
|
Get-Message |
Este cmdlet muestra los detalles de los mensajes que se encuentran en cola para su entrega. Puede usar el cmdlet Get-Message para recuperar un conjunto de mensajes y, a continuación, canalizar los resultados a los otros cmdlets de administración de mensajes. |
|
Get-Queue |
Este cmdlet muestra los detalles de configuración de las colas de los servidores de transporte. Puede usar el cmdlet Get-Queue para recuperar un conjunto de colas y, a continuación, canalizar los resultados a uno de los otros cmdlets de administración de colas. |
|
Remove-Message |
Este cmdlet elimina un mensaje de una cola. Puede elegir si se envía o no un informe de no entrega (NDR). |
|
Resume-Message |
Este cmdlet reanuda la entrega de un mensaje que se había suspendido. También puede usar el cmdlet Resume-Message para volver a enviar los mensajes que se encuentren en la cola de mensajes dudosos a la cola de envío con el objeto de que el categorizador los vuelva a procesar. |
|
Resume-Queue |
Este cmdlet reanuda las entregas de mensajes de una cola que se había suspendido. |
|
Retry-Queue |
Este cmdlet fuerza un intento de conexión en una cola cuyo estado actual es Reintentar. Este intento de conexión anula el reintento programado siguiente. También puede usar el cmdlet Retry-Queue junto con el parámetro Resubmit para enviar a la cola de envío los mensajes que se encuentran en las colas de entrega o en la cola inaccesible con el objeto de que el categorizador los vuelva a procesar. |
|
Suspend-Message |
Este cmdlet suspende la entrega de un mensaje ubicado en una cola de un servidor de transporte de Exchange 2010. |
|
Suspend-Queue |
Este cmdlet suspende las actividades de salida en una cola de un servidor de transporte de Exchange 2010. |
Volver al principio
Conjuntos de parámetros de tarea de cola
Las tareas de la cola admiten varios conjuntos de parámetros. Dichos conjuntos son los siguientes: Identity, Filter y Queue. Los conjuntos de parámetros Identity, Filter y Queue no se pueden combinar en un comando. El conjunto de parámetros Queue sólo está disponible con comandos de mensaje.
También puede usar los parámetros de paginación avanzados disponibles en el Shell en combinación con los conjuntos de parámetros Identity, Filter y Queue. Los parámetros de paginación avanzados se usan con los cmdlets Get-Message y Get-Queue para controlar cómo se ordena y muestra el conjunto de resultados. La tabla "Parámetros de paginación avanzados" de este tema incluye una descripción de los parámetros de paginación avanzados.
Debe usar un conjunto de parámetros Identity, Filter o Queue para los comandos que modifican mensajes o colas. Si no se especifican parámetros, los cmdlets Get-Message y Get-Queue mostrarán todos los objetos de mensaje o cola que existan en el servidor local.
Si el conjunto de resultados de una consulta de cola o de mensajes supera los 250 000 elementos, se producirá un error y se le indicará que aplique un filtro para reducir el número de resultados.
Parámetro Identity
Use el parámetro Identity si el mensaje o la cola que desea visualizar o con los que tomará acciones son conocidos. La búsqueda por identidad es más rápida que formular la misma consulta a modo de filtro.
El nombre del servidor se puede expresar como nombre de host o como nombre de dominio completo (FQDN). Puede especificar el nombre de un servidor remoto como parte de la identidad para iniciar una conexión RPC con ese servidor y poder, de este modo, realizar consultas en las colas de dicho servidor. Si no se especifica un nombre de servidor, se utilizará el host local.
Cuando se proporciona una identidad a una acción de modificación, el objeto que se identifica debe ser único y estar totalmente definido. Si la identidad no es explícita, la acción no tendrá lugar. Si se omite la parte del servidor de la identidad, se supondrá que dicha parte corresponde al equipo local.
Si usa el parámetro Identity como parte de un cmdlet Get-Queue oGet-Message, el parámetro Identity admitirá el uso de expresiones comodín.
Identidad de colas
Al tener nombres únicos, las colas persistentes se pueden especificar por su nombre. Se asigna una identidad única de base de datos a las colas de entrega. Para especificar una cola, se puede utilizar esta identidad de base de datos o el nombre del destino de entrega. Para realizar una operación en una cola mediante la especificación de su identidad única de base de datos, debe ejecutar, en primer lugar, el cmdlet Get-Queue. La identidad de base de datos se devolverá en los resultados. La tabla a continuación muestra los formatos de identidad aceptados para las colas.
Formatos de identidad de cola
| Formato de identidad de cola | Uso |
|---|---|
Servidor\QueueJetID (Int64) |
La identidad única y completa para una cola de entrega. |
\QueueJetID |
La identidad de una cola en el servidor local. Se omite el nombre del servidor. Por tanto, se usa el servidor local de forma implícita. |
Servidor\* |
Cualquier cola del servidor especificado. |
Servidor\NextHopDomain |
Una cola en el servidor especificado que mantiene mensajes para su entrega a un dominio remoto específico. |
\NextHopDomain |
Una cola que mantiene mensajes destinados a un dominio específico y que está ubicada en el servidor local. |
Servidor\Dudoso |
La cola de mensajes dudosos que está ubicada en el servidor especificado. |
Servidor\Envío |
La cola que contiene elementos en espera para ser procesados por el categorizador. |
Servidor\Inaccesible |
La cola que contiene elementos que no se pueden enrutar y que está ubicada en el servidor específico. |
El código siguiente es un ejemplo de cómo se usa una identidad de cola con el cmdlet Get-Queue. En este ejemplo, se devuelve una lista de todas las colas que mantienen mensajes para su entrega a nombres de dominio de SMTP que finalicen en Contoso.com. Además, da el formato de lista detallada al conjunto de resultados.
Get-Queue -Identity Server\*Contoso.com | format-list
Identidad de mensajes
La identidad de un mensaje es una agregación del elemento de correo de base de datos único y la identidad de cola. Cuando un mensaje entra en la base de datos del Motor de almacenamiento extensible (ESE) (antes conocido como JET) de la cola, se le asigna una identidad en forma de entero y dicho entero se anexa a la identidad de cola para crear la identidad de mensaje.
Para realizar una operación en un mensaje mediante la especificación de su identidad de base de datos, debe ejecutar, en primer lugar, el cmdlet Get-Message. La identidad se devuelve en los resultados. Puede incluir el nombre de servidor como parte de la identidad de mensaje si desea conectarse a un servidor remoto. Si se omite el nombre de servidor, se tomará el del servidor local.
Un mensaje que se envía a más de un destinatario puede estar ubicado en varias colas. Puede usar un carácter comodín para especificar que desea ubicar el mensaje en cada cola hacia la cual se enrutó el mensaje. La tabla siguiente ofrece ejemplos de una identidad de mensaje válida.
Formatos de identidad de mensaje
| Formato de identidad de mensaje | Uso |
|---|---|
Servidor\QueueJetId\MessageJetID |
Denominación completa de un mensaje en una cola. |
Servidor\Dudoso\MessageJetID |
Un mensaje que está en la cola de mensajes dudosos. |
MessageJetID |
Todos los mensajes que tienen esta identidad de base de datos y que se enrutan hacia alguna cola del servidor local (un mensaje que se enruta a varias colas). |
Servidor\*\MessageJetID |
Todos los mensajes que tienen esta identidad de base de datos y que se enrutan hacia alguna cola del servidor especificado. |
El código siguiente es un ejemplo de cómo se usa una identidad de mensaje con el cmdlet Get-Message. En este ejemplo, se devuelve una lista de todos los mensajes que tienen la identidad especificada y están ubicados en alguna cola del servidor especificado. Además, se le da el formato de lista detallada al conjunto de resultados.
Get-message -Identity Server\*\1234 | Format-List
Parámetro Filter
Las tareas de la cola admiten el parámetro Filter para que pueda especificar los criterios según los cuales se deben recuperar colas y mensajes. Las propiedades de cola y de mensaje se usan como criterios de filtro. Cree un filtro que muestre un conjunto limitado de colas o mensajes. Después de ubicar las colas y los mensajes que desea supervisar, podrá ver la información acerca de las propiedades de cada objeto. Esta información es útil para solucionar problemas relacionados con el flujo de correo.
Use el parámetro Filter para crear una expresión con operadores lógicos y relacionales y, de esta forma, visualizar sólo los objetos de cola o mensaje que cumplan los criterios del filtro. Puede usar el operador lógico -and si los resultados deben cumplir varias condiciones. Si usa el operador -and, sólo se mostrarán los objetos que cumplan todas las condiciones especificadas en la expresión. Para especificar los criterios de filtro, se usa un subconjunto de las propiedades de un mensaje o de una cola. La propiedad que se especifica debe ser una propiedad válida para el objeto que se consulta, y el valor que se debe cumplir debe estar expresado con la sintaxis correcta. Si no expresa el valor de la propiedad en un entero único, asegúrese de escribirlo entre comillas.
El parámetro Server se puede incluir en un comando junto con el parámetro Filter. Use el parámetro Server para especificar el nombre de host o el FQDN del servidor al que se desea conectar mediante RPC para consultar las colas y los mensajes de dicho servidor y recuperar un conjunto de resultados.
Para obtener más información acerca de las propiedades que se pueden usar para el filtrado, su sintaxis correcta y los operadores admitidos, consulte los siguientes temas:
Parámetro Queue
El parámetro Queue se usa sólo con comandos de mensaje. Use este parámetro para especificar la identidad de la cola de la que desea recuperar los mensajes. Si se especifica una cola, se recuperarán todos los mensajes de dicha cola. Puede recuperar todos los mensajes de una cola determinada sin necesidad de usar una expresión de filtro. Puede recuperar mensajes de varias colas si usa un carácter comodín.
Si usa el parámetro Queue con un comando de mensaje, use el formato de identidad de cola que figura en la tabla "Identidad de cola" de este tema. En el ejemplo de código siguiente se muestra cómo usar el parámetro Queue con un cmdlet Get-Message. En este ejemplo, se devuelve un conjunto de resultados que sólo contiene los mensajes del servidor especificado que están en la cola de entrega al dominio de SMTP de Contoso.com:
Get-message -Queue Server\Contoso.com
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 ordenados. 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ámetros de paginación avanzados
| Parámetro | Descripción |
|---|---|
BookmarkIndex |
El parámetro BookmarkIndex especifica la posición en el conjunto de resultados donde se inician los resultados mostrados. El valor del parámetro BookmarkIndex 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 está establecido en Int.MaxValue, se devuelve la última página completa de resultados. |
BookmarkObject |
El parámetro BookmarkObject 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. El valor del parámetro SearchForward determina si se recuperan las filas anteriores o posteriores al objeto. No se puede combinar el parámetro BookmarkObject y el parámetro BookmarkIndex en una sola consulta. |
IncludeBookmark |
El parámetro IncludeBookmark especifica si se debe incluir el objeto de marcador en el conjunto de resultados. De forma predeterminada, este valor está establecido en |
ResultSize |
El parámetro ResultSize especifica el número de resultados que se muestra por página. Si no se especifica un valor, se usará el tamaño de resultados predeterminado de 1000 objetos. Exchange 2010 limita el conjunto de resultados a 250.000. |
ReturnPageInfo |
ReturnPageInfo 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 |
SearchForward |
El parámetro SearchForward 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 objeto o índice, el parámetro SearchForward determina si la búsqueda se inicia desde el primero o el último de los objetos del conjunto de resultados. El valor predeterminado para este parámetro es Si se establece el parámetro SearchForward en |
SortOrder |
El parámetro SortOrder 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 Exchange.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. Debe usar las capacidades de scripting del Shell para realizar este procedimiento.
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 Exchange.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 Exchange.Contoso.com -BookmarkObject:$temp -IncludeBookmark $False -ResultSize 500 -SortOrder +FromAddress,-Size
Volver al principio
© 2010 Microsoft Corporation. Reservados todos los derechos.