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.
Remove-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]
Remove-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]
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.
|
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.
|
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.
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.
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