Remove-Message

Riferimento

Modulo:: ExchangePowerShell

Si applica a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Questo cmdlet è disponibile solo in Exchange locale.

Il cmdlet Remove-Message consente di eliminare un messaggio da una coda su un server Cassette postali o Trasporto Edge.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Remove-Message
      -Filter <String>
      [-Server <ServerIdParameter>]
      [-Confirm]
      [-WhatIf]
      [-WithNDR <Boolean>]
      [<CommonParameters>]

Remove-Message
      [-Identity] <MessageIdentity>
      [-Confirm]
      [-WhatIf]
      [-WithNDR <Boolean>]
      [<CommonParameters>]

Descrizione

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ù messaggi, verrà visualizzato un messaggio di 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 individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Remove-Message -Server Server1 -Filter "FromAddress -eq 'Kweku@contoso.com'" -WithNDR $false

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.

Parametri

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Filter

Il parametro Filter consente di specificare uno o più messaggi usando la sintassi del filtro OPATH. Il filtro OPATH include un nome di proprietà del messaggio seguito da un operatore di confronto e da un valore (ad esempio, "FromAddress -like '*@contoso.com'"). Per informazioni dettagliate sulle proprietà dei messaggi filtrabili e sugli operatori di confronto, vedere Proprietà dei messaggi nelle code e Trovare code e messaggi nelle code in Exchange Management Shell.

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Il parametro Identity consente di specificare il messaggio. L'input valido per questo parametro utilizza la sintassi Server\Queue\MessageInteger o Queue\MessageInteger o MessageInteger, per esempio, Mailbox01\contoso.com\5 o 10. Per informazioni dettagliate sull'identità del messaggio, vedere Identità del messaggio.

Type:	MessageIdentity
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Il parametro Server specifica il server Exchange in cui si vuole eseguire il comando. È possibile utilizzare qualsiasi valore che identifichi il server in maniera univoca. Ad esempio:

Nome
FQDN
Nome distinto (DN)
DN legacy di Exchange

DN legacy di Exchange

È possibile utilizzare il parametro Server e il parametro Filter nello stesso comando. Non è possibile utilizzare il parametro Server e il parametro Identity nello stesso comando.

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WithNDR

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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.