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.
È 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}