Remove-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 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 comando Remove-Message consente di eliminare uno o più messaggi in una coda di un server Trasporto Hub o Trasporto Edge. Un messaggio trasmesso 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ù messaggi, verrà visualizzato un messaggio di errore. Per rimuovere un messaggio da più code in un'unica operazione, è necessario utilizzare un filtro. 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 utilizzare i parametri Identity o Filter che si escludono reciprocamente.

Per eseguire il cmdlet Remove-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 Remove-Message su un computer in cui è installato il ruolo del server Trasporto Edge, è necessario accedere al sistema utilizzando un account che appartenga al 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 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 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 `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 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 La proprietà SCL specifica il livello di probabilità di posta indesiderata del messaggio. 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 a cui connettersi, utilizzando una chiamata RPC in cui siano presenti le code con messaggi da rimuovere. Immettere il parametro Server come nome host o nome di dominio completo (FQDN). 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.
WithNDR	Facoltativo	System.Boolean	Utilizzare il parametro WithNDR per specificare se al mittente di un messaggio deve essere restituito un rapporto di mancato recapito (NDR). Il comportamento predefinito di questo parametro è impostato su `$true`. Questo parametro può essere utilizzato sia con i set di parametri Identity sia con quelli Filter.

Tipi di input

Tipi restituiti

Errori

Errore	Descrizione

Eccezioni

Eccezioni	Descrizione

Esempio

Nel seguente esempio viene descritto come rimuovere tutti i messaggi che soddisfano i seguenti criteri:

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.

Nel seguente esempio viene inoltre mostrato come eliminare il rapporto di mancato recapito.

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.

Remove-Message -Filter {FromAddress -eq "sender@contoso.com"} -withNDR $false

Condividi tramite