Condividi tramite


Suspend-Queue

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2007-06-28

Utilizzare il cmdlet Suspend-Queue per interrompere le attività in uscita per una coda in un computer in cui è installato il ruolo server Trasporto Edge o Trasporto Hub.

Sintassi

Suspend-Queue -Identity <QueueIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Suspend-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Il cmdlet Suspend-Queue interrompe le attività in uscita in una coda il cui stato è Attivo o Riprova. I messaggi da recapitare tramite SMTP saranno interrotti. Nessun messaggio potrà uscire dalla coda. Se si specifica il parametro Identity, la coda sarà sospesa se l'identità corrisponde a una sola coda. Se l'identità corrisponde a più di una coda, si verificherà un errore. Per sospendere più di una coda in un'unica operazione, è necessario utilizzare un filtro.

È necessario utilizzare i parametri Identity o Filter Le impostazioni del parametro Identity e del parametro Filter si escludono a vicenda. È possibile sospendere 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 Suspend-Queue, è necessario utilizzare un account che disponga della seguente delega:

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

Per eseguire il comando Suspend-Queue in un computer in cui è installato il ruolo 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 specifica i criteri del valore di proprietà relativi alle code che si desidera sospendere. 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. È necessario che il tipo di recapito sia un valore corrispondente a uno tra quelli indicati di seguito:

    • 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 sospendere. Immettere l'identità della coda nel formato Server\destinazione, dove destinazione è un dominio remoto, un server cassette postali o il nome della coda permanente.

Confirm

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro Confirm consente di determinare la sospensione dell'elaborazione e di richiedere che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con il parametro Confirm non è necessario specificare un valore.

Server

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Utilizzare il parametro Server per specificare il nome del server da connettere utilizzando una chiamata RPC che contiene le code in cui sono presenti i messaggi da sospendere. 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.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente di indicare al comando di simulare le azioni da eseguire sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

 

Eccezioni

Eccezioni Descrizione

 

 

Esempio

Nei seguenti esempi sono mostrati due comandi Suspend-Queue. Il primo comando sospende le attività in uscita in tutte le code che contengono i messaggi da recapitare al dominio specificato e il cui stato corrente è Riprova.

Il secondo comando si connette a un server remoto utilizzando una chiamata RPC e sospende tutte le code contenenti più di 100 messaggi.

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.

Suspend-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}
Suspend-Queue -Server ExchSrv1.contoso.com -Filter {MessageCount -gt 100}