Condividi tramite

Retry-Queue (RTM)

  • Articolo

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2008-03-11

Utilizzare il cmdlet Retry-Queue per forzare un tentativo di connessione per una coda in un computer in cui è installato il ruolo del server Trasporto Edge o Trasporto Hub.

Sintassi

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

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

Descrizione dettagliata

Il cmdlet Retry-Queue consente di forzare un tentativo di connessione per una coda con stato Riprova. Il comando stabilisce una connessione all'hop successivo, se possibile. Se una connessione è pianificata, questo comando reimposta l'ora del tentativo successivo per una coda sull'ora corrente e il tentativo di connessione viene eseguito. Se non è viene stabilita una connessione, viene impostata una nuova ora per l'esecuzione del tentativo. È possibile determinare che il contenuto della coda venga inviato nuovamente al Classificatore utilizzando il parametro Resubmit. Questo comando può essere utilizzato per riprovare a recapitare i messaggi che si trovano nella coda Irraggiungibili ma è necessario includere il parametroResubmit.

Se si imposta il parametro Resubmit su $false, il cmdlet Retry-Queue impone un nuovo tentativo di connessione. Se si imposta il parametro Resubmit su $false, i messaggi nella coda vengono inviati nuovamente al classificatore.

Nota

È possibile impostare il parametro Resubmit su $true solo se lo stato della coda remota è Riprova.

È necessario utilizzare i parametri Identity o Filter Le impostazioni del parametro Identity e del parametro Filter si escludono a vicenda. È possibile riprovare la connessione per una coda in un server remoto includendo il nome server nel parametro Identity oppure utilizzando il parametro Server con una query di filtro. Se non si specifica un server, il comando viene eseguito solo sul server locale.

Per eseguire il cmdlet Retry-Queue, è necessario utilizzare un account che disponga della seguente delega:

  • Ruolo Exchange Server Administrator e appartenenza al gruppo Administrators locale del server di destinazione.

Per eseguire il cmdlet Retry-Queue in un computer in cui è installato il ruolo del server Trasporto Edge, è necessario accedere al sistema utilizzando un account che sia membro del gruppo Administrators locale del computer.

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro Obbligatorio Tipo Descrizione

Filter

Obbligatorio

System.String

Il parametro Filter richiede un'espressione che specifichi i criteri del valore di proprietà delle code per le quali si desidera rieseguire il tentativo. L'espressione include un nome di proprietà seguito da un operatore di confronto e da un valore. Di seguito sono riportate le proprietà di coda che sono criteri validi per il parametro Filter.

  • DeliveryType   Il tipo di recapito per questa coda definito dal trasporto. Il tipo di recapito deve essere uno dei seguenti valori:

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • Non definito

    • Non raggiungibile

  • Identity   Immettere l'identità della coda nel formato Server\destinazione dove destinazione è un dominio remoto, un server cassetta postale o un nome coda persistente.

  • LastError   Una stringa di testo relativa all'ultimo errore registrato per una coda.

  • LastRetryTime   L'ora dell'ultimo tentativo di connessione per la coda corrente.

  • MessageCount   Il numero di elementi presenti nella coda.

  • NextHopConnector   Il GUID del connettore utilizzato per creare la coda.

  • NextHopDomain   Il dominio hop successivo della coda, specificato come dominio SMTP (Simple Mail Transfer Protocol) remoto, nome server, nome di un sito Active Directory o identificativo del database dei messaggi (MDB).

  • NextRetryTime   L'ora del prossimo tentativo di connessione per la coda corrente.

  • Status   Lo stato della coda. Le opzioni per lo stato della coda sono Attivo, Pronto, Riprova o Sospeso.

È possibile specificare più criteri utilizzando l'operatore di confronto -and. I valori di proprietà non espressi con un numero intero devono essere racchiusi tra virgolette.

Identity

Obbligatorio

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Utilizzare il parametro Identity per specificare l'identità della coda che contiene i messaggi che si desidera recuperare. Immettere l'identità della coda nel formato Server\destinazione, dove destinazione è un dominio remoto, un server Cassette postali o il nome della coda permanente.

Resubmit

Facoltativo

System.Boolean

Utilizzare il parametro Resubmit per specificare se il contenuto della coda deve essere inviato nuovamente al classificatore prima di stabilire una connessione. Impostare il parametro Resubmit su $false per imporre un nuovo tentativo di connessione. Impostare il parametro Resubmit su $false per inviare nuovamente i messaggi nella coda al classificatore.

Server

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Utilizzare il parametro Server per specificare il nome del server a cui connettersi, utilizzando una chiamata RPC in cui siano presenti le code contenenti i messaggi che si desidera recuperare. Immettere il nome del server come nome host oppure un nome dominio completo. Se questo parametro non viene utilizzato, viene eseguita una query al server locale.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Eccezioni

Eccezioni Descrizione

 

 

Esempio

Nel seguente esempio viene mostrato come forzare un tentativo di connessione per tutte le code che soddisfano i seguenti criteri:

  • Le code contengono messaggi per il dominio specificato.

  • Le code hanno lo stato Riprova.

  • Le code si trovano nel server su cui viene eseguito il comando.

Per ulteriori informazioni su come utilizzare Exchange Management Shell per eseguire le attività del Visualizzatore code, vedere Utilizzo di Exchange Management Shell per la gestione delle code.

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