Suspend-Queue

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-Queue consente di arrestare l'elaborazione per 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

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

Suspend-Queue
       [-Identity] <QueueIdentity>
       [-Confirm]
       [-WhatIf]
       [<CommonParameters>]

Descrizione

Il cmdlet Suspend-Queue consente di interrompere l'elaborazione in una coda il cui stato è Attivo o Riprova. I messaggi in fase di elaborazione vengano recapitati, mentre gli altri messaggi non lasciano la coda. Quando si utilizza il parametro Identity, la coda è sospesa solo se l'identità corrisponde a una singola coda. Se l'identità corrisponde a più di una coda, si verifica un errore. Per sospendere più di una coda in un'unica operazione, è necessario utilizzare il parametro Filter.

Per istruzioni su come riprendere gli accodamenti sospesi, vedere Resume-Queue.

È 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-Queue -Filter "NextHopDomain -eq "contoso.com" -and Status -eq 'Retry'"

Con questo esempio viene sospesa l'elaborazione in tutte le code che contengono messaggi per il recapito al dominio contoso.com e che attualmente hanno lo stato Retry.

Esempio 2

Suspend-Queue -Server Server1.contoso.com -Filter "MessageCount -gt 100"

Con questo esempio viene sospesa l'elaborazione su tutte le code del server Server1.contoso.com che contengono più di 100 messaggi.

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 una o più code usando la sintassi del filtro OPATH. Il filtro OPATH include un nome di proprietà della coda seguito da un operatore di confronto e da un valore (ad esempio, "NextHopDomain -eq 'contoso.com'"). Per informazioni dettagliate sulle proprietà delle code filtrabili e sugli operatori di confronto, vedere Proprietà della coda in Exchange Server 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 la coda. L'input valido per questo parametro utilizza la sintassi Server\Queue o Queue, per esempio, Mailbox01\contoso.com o Unreachable. Per informazioni dettagliate sull'identità della coda, vedere Identità della coda.

Type:	QueueIdentity
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.