Suspend-Message (RTM)

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-08

Il cmdlet Suspend-Message consente di impedire il recapito di un determinato messaggio presente in una coda in un computer in cui è installato il ruolo del server Trasporto Hub o Trasporto Edge.

Sintassi

Suspend-Message -Identity <MessageIdentity>

Suspend-Message -Filter <String> [-Server <ServerIdParameter>]

Descrizione dettagliata

Il cmdlet Suspend-Message consente di impedire il recapito di uno o più messaggi presenti in una coda nel server Trasporto Hub o nel server Trasporto Edge. Non verrano sospesi eventuali recapiti di messaggi già in corso. Il recapito verrà continuato e lo stato del messaggio sarà PendingSuspend. Se il recapito non riesce, il messaggio verrà reinserito nella coda e quindi verrà sospeso. Non è possibile sospendere un messaggio che si trova nella coda Invio o nella coda Messaggi non elaborabili.

Un messaggio inviato a più destinatari potrebbe trovarsi in più code. Se si specifica il parametro Identity, il messaggio verrà sospeso in una sola coda se l'identità specificata corrisponde a un singolo messaggio. Se l'identità corrisponde a più messaggi, verrà visualizzato un messaggio di errore. Per sospendere il messaggio in più code con un'unica operazione è necessario utilizzare un filtro. È necessario utilizzare i parametri Identity o Filter che si escludono reciprocamente.

È possibile sospendere un messaggio in un server remoto includendo il nome del server come parte del parametro Identity o utilizzando il parametro Server con il parametro Filter. Se non si specifica un server, il comando viene eseguito solo sul server locale.

Per eseguire il cmdlet Suspend-Message, è necessario utilizzare un account a cui sia stato delegato il ruolo Exchange Server Administrator e gruppo Administrators locale del server di destinazione.

Per eseguire il cmdlet Suspend-Message su 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 specifica i criteri del valore di proprietà dei messaggi che si desidera sospendere. L'espressione include un nome di proprietà seguito da un operatore di confronto e da un valore. Le seguenti proprietà del messaggio sono criteri validi per il parametro Filter: DateReceived   Data di ricezione del messaggio. ExpirationTime   Ora di scadenza del messaggio. FromAddress   Indirizzo SMTP del mittente del messaggio. Questo valore è ricavato da MAIL FROM: nella busta del messaggio. Identity   Numero intero che rappresenta un messaggio particolare, un server facoltativo e l'identità della coda. InternetMessageId   Valore del campo dell'intestazione MessageID:. Questa proprietà viene espressa come un GUID seguito dall'indirizzo SMTP del server mittente, come in questo esempio: 67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com. LastError   Stringa di testo dell'ultimo errore registrato per il messaggio. MessageSourceName   Stringa di testo del nome del componente che ha inviato il messaggio alla coda. Queue   Specifica l'identità della coda che include il messaggio. Immettere l'identità della coda nel formato Server\destinazione, dove destinazione è un dominio remoto, un server Cassette postali o il nome della coda permanente. RetryCount   Numero di tentativi di recapito di un messaggio a destinazione. SCL   Proprietà SCL (Spam Confidence Level) del messaggio che specifica il livello di probabilità di posta indesiderata. Le voci SCL valide sono numeri interi da 0 a 9. Un valore della proprietà SCL vuoto indica che il messaggio non è stato elaborato dall'agente filtro contenuti. Size   Dimensione di un messaggio. SourceIP   Indirizzo IP del server esterno che ha inviato il messaggio all'organizzazione di Exchange. Status   Stato corrente del messaggio. Le opzioni per lo stato del messaggio sono Active, Retry, Suspended, PendingSuspend e PendingRemove. Subject   Stringa di testo che rappresenta l'oggetto del messaggio di posta elettronica. Il valore è derivato dal campo dell'intestazione Subject:. È possibile specificare più criteri per il filtro utilizzando l'operatore di confronto -and. I valori della proprietà non composti da un numero intero singolo devono essere racchiusi dalle virgolette.
Identity	Obbligatorio	Microsoft.Exchange.Data.QueueViewer.MessageIdentity	Utilizzare il parametro Identity per specificare il numero intero MessageIdentity che rappresenta un messaggio particolare, un server facoltativo e l'identità della coda. La sintassi del parametro è la seguente: Server\QueueIdentity\MessageIdentity QueueIdentity\MessageIdentity Server\*\MessageIdentity MessageIdentity
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 o nome di dominio completo (FQDN, Fully Qualified Domain Name). 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

Nell'esempio seguente viene illustrato come impedire il recapito di tutti i messaggi per i quali si verificano le seguenti condizioni:

• I messaggi vengono inviati dall'indirizzo SMTP del mittente specificato.

• I messaggi vengono accodati nel server Trasporto Hub o Trasporto Edge nel quale 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.

Suspend-Message -Filter {FromAddress -eq "sender@contoso.com"}