Get-Message

  • Artículo

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2007-08-29

Use el cmdlet Get-Message para ver los detalles de uno o más mensajes de una cola en un equipo que tenga instalada la función del servidor Transporte perimetral o Transporte de concentradores.

Sintaxis

Get-Message [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-Filter <String>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-Server <ServerIdParameter>] [-SortOrder <SortOrderEntry[]>]

Get-Message [-Identity <MessageIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Get-Message [-BookmarkIndex <Int32>] [-BookmarkObject <MessageInfo>] [-IncludeBookmark <$true | $false>] [-IncludeRecipientInfo <SwitchParameter>] [-Queue <QueueIdentity>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Descripción detallada

El cmdlet Get-Message muestra los detalles de uno o más mensajes que se encuentran en una cola del servidor de transporte de concentradores o de transporte perimetral. Si no proporciona parámetros, los comandos solicitan todos los mensajes en cualquier cola del servidor local y devuelven una única página de resultados. El tamaño predeterminado de la página es de 1.000 objetos. Puede mostrar mensajes en un servidor remoto incluyendo el nombre del servidor como parte del parámetro Identity, o mediante el parámetro Queue o bien incluyendo el parámetro Server con un filtro de consulta. El parámetros Identity, Queue y Filter son mutuamente excluyentes.

Para ejecutar el cmdlet Get-Message, la cuenta que use debe tener delegada la función de administrador de servidor de Exchange.

Para ejecutar el cmdlet Get-Message en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión mediante una cuenta que sea miembro del grupo local de administradores en dicho equipo.

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

BookmarkIndex

Opcional

System.Int32

El parámetro BookmarkIndex especifica la posición en el conjunto de resultados donde se inician los resultados mostrados. El valor de este parámetro es un índice basado en 1 en el conjunto de resultados totales. BookmarkIndex no se puede usar con el parámetro BookmarkObject.

BookmarkObject

Opcional

Microsoft.Exchange.Data.QueueViewer.MessageInfo

El parámetro BookmarkObject especifica el objeto en el conjunto de resultados en el que se inician los resultados mostrados. BookmarkObject no se puede usar con el parámetro BookmarkIndex.

Filter

Opcional

System.String

El parámetro Filter requiere una expresión que especifica el criterio del valor de propiedad para los mensajes que desea mostrar. La expresión incluye un nombre de propiedad seguido de un operador y un valor de comparación. Las siguientes propiedades de mensajes son criterios válidos para el parámetro Filter:

  • DateReceived   La fecha en la que se recibió el mensaje.

  • ExpirationTime   La hora en que expirará el mensaje.

  • FromAddress   La dirección del Protocolo simple de transferencia de correo (SMTP) del remitente de un mensaje. Este valor se obtiene de MAIL FROM: en el sobre del mensaje.

  • Identity   Un entero que representa un mensaje particular y una identidad de cola y servidor opcional.

  • InternetMessageId   Valor del campo de encabezado de Message-ID:. Esta propiedad se expresa como un GUID seguido por la dirección SMTP del servidor de envío, como en este ejemplo: 67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com.

  • LastError   Una cadena de texto del último error registrado para un mensaje.

  • MessageSourceName   Cadena de texto del nombre del componente que ha enviado este mensaje a la cola.

  • Queue   Especifica la identidad de la cola que almacena el mensaje. Escriba la identidad de la cola con el formato Servidor/destino, donde destino es un nombre de dominio remoto, servidor de buzón o cola persistente.

  • RetryCount   El número de veces que se ha intentando entregar un mensaje a un destino.

  • SCL   La propiedad SCL especifica el nivel de confianza de correo electrónico no deseado del mensaje. Las entradas SCL válidas son enteros del 0 al 9. Un valor de propiedad SCL vacío indica que el agente de filtrado de contenido no ha procesado el mensaje.

  • Size   El tamaño de un mensaje.

  • SourceIP   La dirección IP del servidor externo que ha enviado el mensaje a la organización Exchange.

  • Status   El estado actual del mensaje. Las opciones de estado del mensaje son Active, Retry, Suspended, PendingSuspend o PendingRemove.

  • Subject   Cadena de texto que representa el asunto del correo electrónico. Este valor se obtiene del campo de encabezado de Subject:.

Puede especificar varios criterios de filtro usando el operador de comparación - and. Los valores de propiedad que no se expresen como un único entero deben estar entre comillas.

Identity

Opcional

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

El parámetro Identity sirve para especificar el entero MessageIdentity. Éste es un valor entero que representa un determinado mensaje y una identidad de servidor y cola opcionales. La sintaxis para este parámetro puede especificarse de este modo:

  • Server\QueueIdentity\MessageIdentity

  • QueueIdentity\MessageIdentity

  • Server\*\MessageIdentity

  • MessageIdentity

IncludeBookmark

Opcional

System.Boolean

Use el parámetro IncludeBookmark para especificar si incluir el objeto de marcador cuando se muestran los resultados de la búsqueda. El parámetro IncludeBookmark es válido cuando se usa con los parámetros BookmarkObject o BookmarkIndex. Si no especifica un valor para el parámetro IncludeBookmark, se usa el valor predeterminado de $true.

IncludeRecipientInfo

Opcional

System.Management.Automation.SwitchParameter

Utilice el parámetro IncludeRecipientInfo para mostrar los destinatarios del mensaje en el campo Destinatarios. Si no incluye el parámetro IncludeRecipientInfo, el campo Destinatarios se quedará vacío.

Si almacena los resultados de un comando Get-Message -IncludeRecipientInfo en una variable podrá mostrar propiedades adicionales para los destinatarios del mensaje. En la lista siguiente se describen las propiedades de destinatarios disponibles:

  • Address   Dirección de correo electrónico del destinatario

  • Type   El tipo de destinatario puede ser externo, buzón o DL. La DL se usa cuando el destino es un servidor de expansión.

  • FinalDestination   Nombre distintivo (DN) del objeto que se usa para enrutar el mensaje. El objeto puede ser un conector, un servidor de buzón o un servidor de expansión.

  • Status   El estado del destinatario puede ser Complete, Ready o Retry.

  • LastError   La respuesta SMTP tras el último intento de entrega o un mensaje de error localizado si el mensaje se coloca en la cola inalcanzable.

Por ejemplo, para almacenar la información de destinatario de un mensaje en la cola de entrega remota "Contoso.com" que tiene el valor 1234 de MessageIdentity a una variable denominada $x, use el comando siguiente:

$x=Get-Message -Identity "Contoso.com\1234" -IncludeRecipientInfo

Para mostrar las propiedades extendidas de destinatario almacenadas actualmente en la variable $x, use el comando siguiente:

$x.Recipients

Queue

Opcional

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Use el parámetro Queue para especificar la identidad de la cola que contiene los mensajes que desea mostrar. Escriba la identidad de la cola con el formato Servidor/destino, donde destino es un nombre de dominio remoto, servidor de buzón o cola persistente.

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

Use el parámetro ResultSize para especificar el número total de elementos a mostrar en el conjunto de resultados. El valor predeterminado del parámetro ResultSize se establece en 1.000. ResultSize es compatible con un número ilimitado de resultados, pero Microsoft Exchange limita el conjunto de resultados en 250.000.

ReturnPageInfo

Opcional

System.Boolean

ReturnPageInfo es un parámetro oculto. Úselo para devolver 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

Opcional

System.Boolean

Use el parámetro SearchForward para especificar si buscar hacia adelante o hacia atrás en el conjunto de resultados. El valor predeterminado es $true. Este valor hace que la página de resultados sea calculada hacia adelante tanto desde el principio del conjunto de resultados como hacia adelante desde un marcador si fuese especificado.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Use el parámetro Server para especificar el nombre del servidor al que conectar mediante una llamada a procedimiento remoto (RPC) que contiene las colas en las que se encuentran los mensajes que desea mostrar. Especifique el parámetro Server como nombre del host o un nombre de dominio completo (FQDN). Si no se usa este parámetro, se consulta el servidor local.

SortOrder

Opcional

Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[]

Use el parámetro SortOrder para especificar una matriz de propiedades de mensajes que se usan para controlar el orden de clasificación del conjunto de resultados. Separe cada propiedad mediante una coma. Anexe un símbolo + al principio del nombre de propiedad para mostrar los resultados en orden ascendente. Anexe un símbolo - al principio del nombre de propiedad para mostrar los resultados en orden descendente. Si no especifica un orden de clasificación, el conjunto de resultados se muestra en orden ascendente por el entero MessageIdentity.

Ejemplo

En los siguientes ejemplos se muestra cómo buscar mensajes mediante el comando Get-Message. En el primer ejemplo se muestra cómo mostrar todos los mensajes que están en cola en el servidor local y que se han recibido de cualquier remitente en el dominio especificado. El comando se envía al comando Format-List para mostrar los resultados como lista detallada.

En el segundo ejemplo se indica cómo mostrar todos los mensajes que están en cola en el servidor local, que se han recibido de cualquier remitente en el dominio especificado y tienen un valor SCL mayor de 3.

En el tercer ejemplo se indica cómo conectar a un servidor remoto y, a continuación, cómo mostrar todos los mensajes que están en cola en el servidor remoto en el orden de clasificación especificado. Los resultados se clasifican primero en orden ascendente por dirección de remitente y, a continuación, en orden descendente de tamaño.

Para obtener más información acerca de la canalización, consulte Canalización.

Para obtener más información acerca de cómo trabajar con el resultado de un comando, consulte Trabajo con salidas de comandos.

Para obtener más información acerca de cómo usar el Shell de administración de Exchange para realizar tareas de visor de cola, consulte Utilización de Shell de administración de Exchange para administrar colas.

Get-Message -Filter {FromAddress -like "*@contoso.com"} | format-list
Get-Message -Filter {FromAddress -like "*@contoso.com" -and SCL -gt 3}
Get-Message -Server exchange.contoso.com -SortOrder: +FromAddress,-Size