Retry-Queue (RTM)

Artículo
08/09/2014

Se aplica a: Exchange Server 2007

Última modificación del tema: 2008-03-11

Use el cmdlet Retry-Queue para aplicar un intento de conexión en una cola de un equipo que tenga instalada la función del servidor Transporte de concentradores o Transporte perimetral.

Sintaxis

Retry-Queue -Identity <QueueIdentity> [-Resubmit <$true | $false>]

Retry-Queue -Filter <String> [-Resubmit <$true | $false>] [-Server <ServerIdParameter>]

Descripción detallada

El cmdlet Retry-Queue fuerza un intento de conexión en una cola que tenga el estado Retry. El comando establece una conexión con el siguiente salto, si es posible. Si hay una conexión programada, este comando restablece la hora de reintento de la cola a la hora actual, y se intenta establecer la conexión. Si no se establece la conexión, se establece una nueva hora de reintento. Se puede hacer que el contenido de la cola se vuelva a enviar al Categorizador mediante el parámetro Resubmit. Este comando se puede usar para reintentar entregar mensajes que están en la cola Inaccesible, pero se debe incluir el parámetro Resubmit.

Si el parámetro Resubmit se establece en $false, el cmdlet Retry-Queue aplica un nuevo intento de conexión. Si el parámetro Resubmit se establece en $false, los mensajes de la cola se vuelven a enviar al categorizador.

Nota

El parámetro Resubmit se puede establecer en $true sólo cuando la cola remota está en un estado de reintento.

Es necesario usar un parámetro Identity o Filter. Los parámetros Identity y Filter son mutuamente excluyentes. Se puede reintentar una cola de un servidor remoto incluyendo el nombre del servidor como parte del parámetro Identity, o mediante el uso del parámetro Server con una consulta de filtro. Si no se especifica un servidor, el comando sólo se ejecuta en el servidor local.

Para ejecutar el cmdlet Retry-Queue, la cuenta que use debe tener delegado lo siguiente:

Función Administrador de Exchange Server y grupo Administradores local del servidor de destino

Para ejecutar el cmdlet Retry-Queue 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 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 las colas que desea reintentar. La expresión incluye un nombre de propiedad seguido de un operador y un valor de comparación. Las siguientes propiedades de la cola son criterios válidos para el parámetro Filter: DeliveryType El tipo de entrega de esta cola tal y como define el transporte. El tipo de entrega debe ser uno de los valores siguientes: DNSConnectorDelivery NonSMTPGatewayDelivery SmartHostConnectorDelivery SmtpRelayWithinAdSitetoEdge MapiDelivery SmtpRelayWithinAdSite SmtpRelaytoRemoteAdSite SmtpRelaytoTiRg Undefined Unreachable Identity Escriba la identidad de la cola con el formato Servidor\destino, donde destino es un nombre de dominio remoto, servidor de buzones o cola persistente. LastError Una cadena de texto del último error registrado de una cola. LastRetryTime La hora en la que se intentó por última vez establecer conexión en esta cola. MessageCount El número de elementos que hay en la cola. NextHopConnector El GUID del conector que se usó para crear la cola. NextHopDomain El dominio del siguiente salto de la cola, especificado como un dominio remoto de Protocolo simple de transferencia de correo (SMTP), un nombre de servidor, el nombre de un sitio de Active Directory o un identificador de base de datos de mensajes (MDB). NextRetryTime La hora en la que se volverá a intentar establecer conexión en esta cola. Status El estado de la cola. Las opciones de estado de la cola son Active, Ready, Retry o Suspended. Los criterios se pueden especificar mediante el uso del operador de comparación -and. Los valores de propiedad que no se expresen como un entero deben estar entre comillas.
Identity	Necesario	Microsoft.Exchange.Data.QueueViewer.QueueIdentity	Use el parámetro Identity para especificar la identidad de la cola que contiene los mensajes que desea reintentar. Escriba la identidad de la cola con el formato Servidor/destino, donde destino es un nombre de dominio remoto, servidor de buzones o cola persistente.
Resubmit	Opcional	System.Boolean	Use el parámetro Resubmit para especificar si se debe reenviar al Categorizador el contenido de la cola antes de establecer una conexión. Establezca el parámetro Resubmit en `$false` para aplicar un nuevo intento de conexión. Establezca el parámetro Resubmit en `$false` para volver a enviar los mensajes de la cola al categorizador.
Server	Opcional	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Use el parámetro Server para especificar el nombre del servidor al que conectarse mediante una llamada a procedimiento remoto (RPC) que contiene las colas en las que se encuentran los mensajes que desea reintentar. Escriba el nombre del servidor como un nombre de host o un nombre completo de dominio (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 aplicar un intento de conexión para todas las colas que cumplan los siguientes criterios:

Las colas contienen mensajes del dominio especificado.
Las colas tienen un estado Retry.
Las colas están ubicadas en el servidor en el que se ejecuta el comando.

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

Retry-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}