Cmdlet di trasporto


Remove-Message

Si applica a: Exchange Server 2010 SP2

Ultima modifica dell'argomento: 2011-05-06

Il cmdlet Remove-Message consente di eliminare un messaggio da una coda in un computer in cui è installato il ruolo del server Trasporto Hub o Trasporto Edge.

Sintassi


Remove-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]

Remove-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]
Descrizione dettagliata

Il cmdlet Remove-Message consente di eliminare uno o più messaggi in una coda di un server Trasporto Hub o Trasporto Edge. Un messaggio inviato a più destinatari potrebbe trovarsi in più code. Se si specifica un parametro Identity, il messaggio verrà rimosso da una singola coda se l'identità corrisponde a un solo messaggio. Se l'identità corrisponde a più di un messaggio, si verifica un errore. Per rimuovere un messaggio da più code in un'unica operazione, è necessario utilizzare il parametro Filter . Se si tenta di rimuovere un messaggio in fase di recapito, lo stato del messaggio verrà modificato in PendingDelete. Il recapito del messaggio non verrà interrotto, ma se si verifica un errore nel recapito che provoca il reinserimento nella coda, il messaggio verrà rimosso.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per visualizzare quali autorizzazioni sono necessarie, vedere "Code" nell'argomento Autorizzazioni di trasporto.

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 rimuovere. 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   L'indirizzo SMTP del mittente di un messaggio. Questo valore viene 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   Il valore del campo dell'intestazione Message-ID. 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   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   Il livello di probabilità di posta indesiderata (SCL) del messaggio. I valori SCL validi sono i numeri interi da 0 a 9. Una proprietà SCL vuota indica che il messaggio non è stato elaborato dall'agente filtro contenuto.
  • 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 viene ricavato dal campo dell'intestazione Subject .

È possibile specificare più criteri per il filtro utilizzando andl'operatore di confronto. I valori di proprietà non espressi con un singolo numero intero devono essere racchiusi tra virgolette (").

Identity

Obbligatorio

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

Il parametro Identity consente di 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

L'opzione Confirm può essere utilizzata per sopprimere il prompt di conferma visualizzato per impostazione predefinita quando viene eseguito questo cmdlet. Per sopprimere il prompt di conferma, utilizzare la sintassi -Confirm:$False. È necessario includere i due punti (: ) nella sintassi.

Server

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Il parametro Server consente di specificare il nome del server da connettere utilizzando una chiamata RPC che contiene le code in cui sono presenti i messaggi da eliminare. Immettere il parametro Server come nome host o nome di dominio completo (FQDN). Se tale parametro non viene utilizzato, viene eseguita una query al server locale.

WhatIf

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro WhatIf, è possibile visualizzare le modifiche che verrebbero apportate, senza doverle applicare. Con il parametro WhatIf non è necessario specificare alcun valore.

WithNDR

Facoltativo

System.Boolean

Il parametro WithNDR consente di specificare se al mittente di un messaggio deve essere restituito un rapporto di mancato recapito (NDR). Il valore predefinito è $true. Questo parametro può essere utilizzato sia con i set di parametri Identity sia con quelli Filter.

Tipi di input

Per verificare i tipi di input accettati da questo cmdlet, vedere Cmdlet Input and Output Types. Se il campo per il tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Tipi restituiti

Per verificare i tipi di output accettati da questo cmdlet, vedere Cmdlet Input and Output Types. Se il campo per il tipo di output è vuoto, il cmdlet non restituisce dati.

Esempi

ESEMPIO 1

In questo esempio vengono eliminati tutti i messaggi che soddisfano i criteri seguenti senza generare NDR:

  • I messaggi vengono inviati dal mittente Kweku@contoso.com.
  • I messaggi vengono messi in coda sul server Server1.
Remove-Message -Server Server1 -Filter {FromAddress -eq "Kweku@contoso.com"} -WithNDR $false
Page view tracker