Retry-Queue
Questo cmdlet è disponibile solo in Exchange locale.
Usare il cmdlet Retry-Queue per forzare un tentativo di connessione per una coda su un server Cassette postali o su un server Trasporto Edge.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Retry-Queue
-Filter <String>
[-Server <ServerIdParameter>]
[-Confirm]
[-Resubmit <Boolean>]
[-WhatIf]
[<CommonParameters>]
Retry-Queue
[-Identity] <QueueIdentity>
[-Confirm]
[-Resubmit <Boolean>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Il cmdlet Retry-Queue consente di forzare un tentativo di connessione per una coda con stato Riprova. Il cmdlet stabilisce una connessione all'hop successivo, se possibile. Se non viene stabilita una connessione, viene impostata una nuova ora per l'esecuzione del tentativo. Per utilizzare questo comando per tentare di nuovo il recapito dei messaggi nella coda non raggiungibile, è necessario includere il parametro Resubmit.
È 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
Retry-Queue -Filter "NextHopDomain -eq "contoso.com" -and Status -eq 'Retry'"
In questo esempio viene forzato un tentativo di connessione per tutte le code che soddisfano i seguenti criteri:
- Le code contengono messaggi per il dominio contoso.com.
- Le code hanno lo stato Retry.
- Le code si trovano nel server su cui viene eseguito il comando.
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 |
-Resubmit
Il parametro Resubmit consente di specificare se i contenuti della coda devono essere reinviati al classificatore prima di stabilire una connessione. L'input valido per questo parametro è $true o $false.
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 |
-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.