Retry-Queue

Referencia

Módulo:: ExchangePowerShell

Se aplica a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet solo está disponible en el entorno local de Exchange.

Utilice el cmdlet Retry-Queue para forzar un intento de conexión para una cola en un servidor de buzones de correo o en un servidor 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

Retry-Queue
     -Filter <String>
     [-Server <ServerIdParameter>]
     [-Confirm]
     [-Resubmit <Boolean>]
     [-WhatIf]
     [<CommonParameters>]

Retry-Queue
     [-Identity] <QueueIdentity>
     [-Confirm]
     [-Resubmit <Boolean>]
     [-WhatIf]
     [<CommonParameters>]

Description

El cmdlet Retry-Queue fuerza un intento de conexión en una cola que tenga el estado Retry. El cmdlet establece una conexión con el siguiente salto, si es posible. Si no se establece la conexión, se establece una nueva hora de reintento. Para usar este comando para reintentar la entrega de mensajes de la cola Inaccesible, debe incluir el parámetro Resubmit.

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

Retry-Queue -Filter "NextHopDomain -eq "contoso.com" -and Status -eq 'Retry'"

En este ejemplo se fuerza un intento de conexión para todas las colas que cumplan los criterios siguientes:

Las colas contienen mensajes del dominio contoso.com.
Las colas tienen un estado de Retry.
Las colas se ubican en el servidor en el que se ejecuta el comando.

Parámetros

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

Type:	SwitchParameter
Aliases:	cf
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 una o varias colas mediante la sintaxis de filtro de OPATH. El filtro OPATH incluye un nombre de propiedad de cola seguido de un operador de comparación y un valor (por ejemplo, "NextHopDomain -eq 'contoso.com'"). Para obtener más información sobre las propiedades de cola filtrables y los operadores de comparación, consulte Propiedades de cola en Exchange Server 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:	True
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 la cola. La entrada válida para este parámetro debe usar la sintaxis Server\Queue o Queue, por ejemplo, Mailbox01\contoso.com o Unreachable. Para obtener más información sobre la identidad de cola, consulte Identidad de cola.

Type:	QueueIdentity
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Resubmit

Use el parámetro Resubmit para especificar si el contenido de la cola se debe reenviar al categorizador antes de establecer una conexión. La entrada válida para este parámetro es $true o $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

-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

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Type:	SwitchParameter
Aliases:	wi
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.

Compartir a través de