Resume-Message (RTM)

  • Artículo

 

Se aplica a: Exchange Server 2007

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

Use el cmdlet Resume-Message para permitir la entrega de un mensaje que se haya suspendido anteriormente de una cola de un equipo que tenga instalada la función de servidor de transporte de concentradores o transporte de bordes.

Sintaxis

Resume-Message -Identity <MessageIdentity>

Resume-Message -Filter <String> [-Server <ServerIdParameter>]

Descripción detallada

El cmdlet Resume-Message habilita la entrega de un mensaje anteriormente suspendido que se encuentre en una cola del servidor de transporte de concentradores o de transporte de bordes. Un mensaje que se está enviando a varios destinatarios puede estar ubicado en diferentes colas. Si se especifica un parámetro Identity, el mensaje se restaurará en una sola cola si esa identidad sólo coincide con un solo mensaje. Si la identidad coincide con más de un mensaje, recibirá un error. Para restaurar un mensaje en más de una cola en una sola operación, debe usar un filtro.

Es necesario usar un parámetro Identity o Filter. Estos dos conjuntos de parámetros son mutuamente excluyentes.

Se puede restaurar un mensaje de un servidor remoto incluyendo el nombre del servidor como parte del parámetro Identity, o mediante el uso del parámetro Server con el parámetro Filter. Si no se especifica un servidor, el comando sólo se ejecuta en el servidor local.

Para ejecutar el cmdlet Resume-Message, se debe delegar la función Administrador de servidor de Exchange y el grupo Administradores local para el servidor de destino.

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

Para obtener más información sobre 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

Filter

Necesario

System.String

El parámetro Filter requiere una expresión que especifica los criterios de valor de la propiedad para los mensajes que desea restaurar. 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   El valor del campo de encabezado de mensaje Message-ID: ubicado en el encabezado del mensaje. 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   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 y 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

Necesario

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

El parámetro Identity sirve para especificar el entero MessageIdentity. Éste es un valor entero que representa un mensaje en particular y una identidad de servidor y cola opcionales. La sintaxis para este parámetro es la siguiente:

  • Server\QueueIdentity\MessageIdentity

  • QueueIdentity\MessageIdentity

  • Server\*\MessageIdentity

  • MessageIdentity

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Use el parámetro Server para especificar el nombre del servidor al que se va a conectar mediante una llamada a procedimiento remoto (RPC) que contiene las colas que almacenan los mensajes que desea restaurar. 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.

Tipos de entrada

Tipos de valores devueltos

Errores

Error Descripción

 

 

Excepciones

Excepciones Descripción

 

 

Ejemplo

En el siguiente ejemplo se muestra cómo restaurar la entrega de todos los mensajes que estén en estado suspendido y para los que las siguientes condiciones sean verdaderas:

  • Los mensajes se enviaron desde la dirección SMTP especificada de remitente.

  • Los mensajes se ponen en cola en los servidores de transporte de concentradores o transporte de bordes en donde se ejecuta el comando.

  • Los mensajes caducarán antes de las 15:00 del día especificado.

Para obtener más información acerca de cómo usar Shell de administración de Exchange para realizar tareas de visor de cola, vea Utilización de Shell de administración de Exchange para administrar colas (en inglés).

Resume-Message -Filter {FromAddress -eq "sender@contoso.com" -and ExpirationTime -lt "yyyy-mm-dd 03:00:00 PM"}