Get-Message
Este cmdlet solo está disponible en el entorno local de Exchange.
Utilice el cmdlet Get-Message para ver los detalles de uno o más mensajes en las colas de los servidores de buzones de correo o de transporte perimetral.
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.
Syntax
Get-Message
[-Filter <String>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleMessageInfo>]
[-IncludeBookmark <Boolean>]
[-IncludeComponentLatencyInfo]
[-IncludeRecipientInfo]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-Server <ServerIdParameter>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]Get-Message
[[-Identity] <MessageIdentity>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleMessageInfo>]
[-IncludeBookmark <Boolean>]
[-IncludeComponentLatencyInfo]
[-IncludeRecipientInfo]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]Get-Message
[-Queue <QueueIdentity>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleMessageInfo>]
[-IncludeBookmark <Boolean>]
[-IncludeComponentLatencyInfo]
[-IncludeRecipientInfo]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]Description
Para mostrar mensajes, incluya el nombre del servidor como parte del parámetro Identity o el parámetro Queue, o bien incluya el parámetro Server con una consulta de filtro. El parámetro Identity, el parámetro Queue y los valores del parámetro Filter se excluyen mutuamente.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. 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-Message -Filter "FromAddress -like '*@contoso.com'" | Format-ListEn este ejemplo se muestra información detallada sobre todos los mensajes en cola que se encuentren en el servidor local y que se hayan recibido de cualquier remitente del dominio contoso.com.
Ejemplo 2
Get-Message -Filter "FromAddress -like '*@contoso.com' -and SCL -gt 3"En este ejemplo se enumeran todos los mensajes en cola en el servidor local, recibidos de cualquier remitente en el dominio contoso.com y que tienen un valor de SCL mayor que 3.
Ejemplo 3
Get-Message -Server Server01.contoso.com -SortOrder: +FromAddress,-SizeEn este ejemplo se muestran todos los mensajes en cola en el servidor denominado Server01. Los resultados se clasifican primero en orden ascendente por dirección de remitente y, a continuación, en orden descendente según el tamaño.
Parámetros
-BookmarkIndex
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 de base 1 en el conjunto de resultados totales. El parámetro BookmarkIndex no puede usarse con el parámetro BookmarkObject.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-BookmarkObject
El parámetro BookmarkObject especifica el objeto en el conjunto de resultados donde se inician los resultados mostrados. El parámetro BookmarkObject no puede usarse con el parámetro BookmarkIndex.
| Type: | ExtensibleMessageInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Filter
El parámetro Filter especifica uno o varios mensajes mediante la sintaxis de filtro de OPATH. El filtro OPATH incluye un nombre de propiedad de mensaje seguido de un operador de comparación y un valor (por ejemplo, "FromAddress -like '*@contoso.com'"). Para obtener más información sobre las propiedades de mensajes filtrables y los operadores de comparación, consulte Propiedades de mensajes en colas y Búsqueda de colas y mensajes en colas en el Shell de administración de Exchange.
Puede especificar varios criterios mediante el operador de comparación y . Los valores de propiedad que no se expresen como un entero deben estar entre comillas (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
El parámetro Identity especifica el mensaje. La entrada válida para este parámetro debe usar la sintaxis Server\Queue\MessageInteger, Queue\MessageInteger o MessageInteger, por ejemplo, Mailbox01\contoso.com\5 o 10. Para obtener más información sobre la identidad del mensaje, consulte Identidad del mensaje.
| Type: | MessageIdentity |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludeBookmark
El parámetro IncludeBookmark especifica si se 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 el parámetro BookmarkObject o BookmarkIndex. Si no especifica un valor para el parámetro IncludeBookmark, se usa el valor predeterminado de $true.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludeComponentLatencyInfo
El modificador IncludeComponentLatencyInfo especifica si la información sobre la latencia del componente se debe incluir en las propiedades del mensaje. No es necesario especificar un valor con este modificador.
Si incluye este modificador, entre los objetos del mensaje devueltos se incluirán las medidas de latencia de cada componente de transporte que haya contribuido a la latencia del servidor local para cada mensaje en cola.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludeRecipientInfo
El modificador IncludeRecipientInfo especifica si se deben mostrar los destinatarios del mensaje en el campo Destinatarios. No es necesario especificar un valor con este modificador.
Si no incluye el modificador IncludeRecipientInfo, el campo Destinatarios permanecerá en blanco.
Almacenar los resultados de un Get-Message -IncludeRecipientInfo comando en una variable permite mostrar propiedades adicionales para los destinatarios del mensaje. En la lista siguiente se describen las propiedades de destinatarios disponibles:
- Dirección: dirección de correo electrónico del destinatario.
- Tipo: tipo de destinatario, que puede ser Externo, Buzón o Grupo de distribución. Grupo de distribución se usa cuando el destino es un servidor de expansión.
- FinalDestination: nombre distintivo (DN) del objeto que se usa para enrutar el mensaje.
- Estado: el estado del destinatario puede ser Completo, Listo o Reintentar.
- 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 el contoso.com cola de entrega remota que tiene el valor MessageIdentity de 1234 en una variable denominada $x, use el siguiente comando: $x=Get-Message -Identity "contoso.com\\1234" -IncludeRecipientInfo.
Para mostrar las propiedades de destinatario extendidas que ahora se almacenan en la variable $x, use el siguiente comando: $x.Recipients.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Queue
El parámetro Queue especifica la identidad de la cola que contiene los mensajes que desea mostrar. La entrada válida para este parámetro usa la sintaxis <Server>\<Queue> o <Queue>, por ejemplo, Mailbox01\contoso.com o Unreachable. Para obtener más información sobre la identidad de la cola, consulte la sección "Identidad de cola" en Buscar colas y mensajes en colas en el Shell de administración de Exchange.
Si usa el parámetro Queue, no puede usar los parámetros Identity, Filter o Server.
| Type: | QueueIdentity |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ResultSize
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.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ReturnPageInfo
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SearchForward
El parámetro SearchForward especifica si la búsqueda se realiza 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 se calcule hacia adelante, ya sea desde el principio del conjunto de resultados o desde un marcador en caso de que se especifique uno.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Server
El parámetro Server especifica el servidor Exchange en el que desea ejecutar este comando. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:
- Name
- FQDN
- Distinguished name (DN)
- Nombre distintivo (DN) heredado de Exchange
Nombre distintivo (DN) heredado de Exchange
No puede usar el parámetro Server y el parámetro Filter en el mismo comando. No puede usar el parámetro Server y el parámetro Identity en el mismo comando.
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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. Separe cada propiedad con coma. Anteponga un símbolo del signo más (+) al comienzo del nombre de la propiedad para mostrar los resultados en orden ascendente. Anteponga un símbolo del signo menos (-) al comienzo del nombre de la propiedad para mostrar los resultados en orden descendente.
Si no especifica ningún criterio de ordenación, el conjunto de resultados se muestra en orden ascendente mediante el entero MessageIdentity.
| Type: | QueueViewerSortOrderEntry[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.