Compartir a través de

Retry-Queue

  • Artículo

 

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

Ú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> [-Confirm [<SwitchParameter>]] [-Resubmit <$true | $false>] [-WhatIf [<SwitchParameter>]]

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

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 define el parámetro Resubmit a $false, el cmdlet Retry-Queue fuerza un nuevo intento de conexión. Si define el parámetro Resubmit a $false, los mensajes de la cola se reenvían al categorizador.

Nota

El parámetro Resubmit sólo puede definirse a $true cuando el estado de la cola remota es Retry.

Es necesario utilizar 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, debe utilizar una cuenta en la que se delegue lo siguiente:

  • Función de administrador de servidores de Exchange y grupo local Administradores para el 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, funciones de delegación 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 buzón 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 buzón o cola persistente.

Confirm

Opcional

System.Management.Automation.SwitchParameter

El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm.

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. Defina el parámetro Resubmit a $false para aplicar un nuevo intento de conexión. Defina el parámetro Resubmit a $false para reenviar 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.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf.

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 cumplen 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 el Shell de administración para realizar tareas de visor de cola, consulte Utilización de Shell de administración de Exchange para administrar colas (en inglés).

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