Partager via


Retry-Queue

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2008-03-11

La cmdlet Retry-Queue permet de forcer une tentative de connexion à une file d'attente sur un ordinateur sur lequel le rôle serveur de transport Edge ou de transport Hub est installé.

Syntaxe

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

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

Description détaillée

La cmdlet Retry-Queue force une tentative de connexion à une file d'attente dont l'état est Retry. La commande établit une connexion au prochain saut, si cela est possible. Si une connexion est programmée, cette commande réinitialise l'heure de la tentative suivante pour une file d'attente à l'heure actuelle et une tentative de connexion est faite. Si la tentative de connexion échoue, une nouvelle heure de tentative est définie. Vous pouvez resoumettre le contenu de la file d'attente au catégoriseur à l'aide du paramètre Resubmit. Cette commande permet de réessayer de remettre les messages qui se trouvent dans la file d'attente inaccessible, mais vous devez inclure le paramètre Resubmit.

Si vous définissez le paramètre Resubmit sur $false, la cmdlet Retry-Queue force une nouvelle tentative de connexion. Si vous définissez le paramètre Resubmit sur $false, les messages dans la file d'attente sont envoyés à nouveau au catégoriseur.

Notes

Vous pouvez définir le paramètre Resubmit sur $true uniquement lorsque le statut de la file d'attente distante est Nouvelle tentative.

Vous devez utiliser un paramètre Identity ou un paramètre Filter. Les jeux de paramètres Identity et Filter s'excluent mutuellement. Vous pouvez effectuer une nouvelle tentative de file d'attente sur un serveur distant en incluant le nom de serveur dans le paramètre Identity ou en utilisant le paramètre Server avec une requête de filtre. Si vous ne spécifiez pas de serveur, la commande s'exécute uniquement sur le serveur local.

Pour exécuter la cmdlet Retry-Queue, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.

Pour exécuter la cmdlet Retry-Queue sur un ordinateur sur lequel le rôle serveur de transport Edge est installé, vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local présent sur cet ordinateur.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Filter

Obligatoire

System.String

Le paramètre Filter requiert une expression qui spécifie le critère de valeur de propriété pour les files d'attente pour lesquelles vous voulez effectuer une nouvelle tentative. L'expression comprend un nom de propriété suivi d'un opérateur de comparaison et d'une valeur. Les propriétés de file d'attente suivantes sont des critères valides pour le paramètre Filter :

  • DeliveryType   Type de remise pour cette file d'attente, tel que défini par le transport. Le type de remise doit être l'une des valeurs suivantes :

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • Non défini

    • Inaccessible

  • Identity   Entrez l'identité de la file d'attente sous la forme Serveur\destination, où destination est un domaine distant, un serveur de boîtes aux lettres ou un nom de file d'attente persistante.

  • LastError   Chaîne de texte de la dernière erreur enregistrée pour une file d'attente.

  • LastRetryTime   Heure à laquelle la dernière tentative de connexion a été effectuée pour cette file d'attente.

  • MessageCount   Nombre d'éléments dans la file d'attente.

  • NextHopConnector   GUID du connecteur utilisé pour créer la file d'attente.

  • NextHopDomain   Domaine de saut suivant de la file d'attente, spécifié comme un domaine SMTP distant, un nom de serveur, le nom d'un site Active Directory ou un identificateur de base de données de messages (MBD).

  • NextRetryTime   Heure à laquelle la prochaine tentative de connexion sera effectuée pour cette file d'attente.

  • Status   État de la file d'attente. Les options d'état de la file d'attente sont Active, Ready, Retry ou Suspended.

Vous pouvez spécifier plusieurs critères à l'aide de l'opérateur de comparaison -and. Les valeurs de propriété qui ne sont pas exprimées sous la forme d'un nombre entier doivent être entrées entre guillemets.

Identity

Obligatoire

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Le paramètre Identity permet de spécifier l'identité de la file d'attente contenant les messages pour lesquels vous voulez effectuer une nouvelle tentative. Entrez l'identité de file d'attente sous la forme Serveur\destination, où destination est un domaine distant, un serveur de boîtes aux lettres ou un nom de file d'attente persistante.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

Resubmit

Facultatif

System.Boolean

Le paramètre Resubmit permet de spécifier si le contenu de la file d'attente doit être resoumis au catégoriseur avant l'établissement d'une connexion. Définissez le paramètre Resubmit sur $false pour forcer une nouvelle tentative de connexion. Définissez le paramètre Resubmit sur $false pour envoyer à nouveau les messages dans la file d'attente au catégoriseur.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Le paramètre Server permet de spécifier le nom du serveur pour se connecter en utilisant l'appel de procédure distante (RPC) contenant les files d'attente qui comprennent les messages pour lesquels vous voulez effectuer une nouvelle tentative. Entrez le nom du serveur comme un nom d'hôte ou un nom de domaine complet (FQDN). Si ce paramètre n'est pas utilisé, le serveur local est interrogé.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exceptions

Exceptions Description

 

 

Exemple

L'exemple suivant montre comment forcer une tentative de connexion pour toutes les files d'attente répondant aux critères suivants :

  • Les files d'attente contiennent des messages pour le domaine spécifié.

  • L'état des files d'attente est Retry.

  • Les files d'attente sont localisées sur le serveur sur lequel la commande est exécutée.

Pour plus d'informations sur l'utilisation d'Exchange Management Shell pour exécuter des tâches d'Afficheur de file d'attente, consultez la rubrique Utilisation d'Exchange Management Shell pour la gestion des files d'attente.

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