Suspend-Message

Articolo
08/10/2014

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

Ultima modifica dell'argomento: 2007-06-28

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> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

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

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. Tale valore è contenuto in `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. Tale valore è contenuto nel 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
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 o nome di dominio completo (FQDN, Fully Qualified Domain Name). 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

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 Edge Transport 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"}

Share via