Suspend-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 Suspend-Message consente di impedire il recapito di un determinato messaggio in coda in un server Cassette postali o Trasporto Edge.

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

Sintassi

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

Suspend-Message
       [-Identity] <MessageIdentity>
       [-Confirm]
       [-WhatIf]
       [<CommonParameters>]

Descrizione

Non saranno 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 presente nella coda dei messaggi non elaborabili.

Un messaggio inviato a più destinatari potrebbe trovarsi in più code. Se si specifica il parametro Identity, il messaggio viene 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 il parametro Filter.

Per istruzioni su come riprendere un messaggio sospeso, vedere Resume-Message.

È 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

Suspend-Message -Server Server1 -Filter "FromAddress -eq 'kweku@contoso.com'"

Con questo esempio viene impedito il recapito di tutti i messaggi per il quale sono vere le seguenti condizioni:

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

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.

Condividi tramite