Get-QueueDigest
Questo cmdlet è disponibile solo in Exchange locale.
Usare il cmdlet Get-QueueDigest per visualizzare informazioni sulle code di recapito dei messaggi tra i gruppi di disponibilità del database (DAG) siti di Active Directory o foreste di Active Directory nell'organizzazione.
Per impostazione predefinita, il cmdlet Get-QueueDigest visualizza le code di recapito che contengono dieci o più messaggi e i risultati sono vecchi di uno e due minuti. Per istruzioni su come modificare questi valori predefiniti, vedere Configurare Get-QueueDigest.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-QueueDigest
-Dag <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>] Get-QueueDigest
[-Forest]
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>] Get-QueueDigest
-Server <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>] Get-QueueDigest
-Site <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>] Descrizione
È 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
Get-QueueDigest -ForestIn questo esempio vengono restituite informazioni su tutte le code nella foresta active directory.
Esempio 2
Get-QueueDigest -Dag DAG01In questo esempio vengono riportate le informazioni su tutte le code nel gruppo di disponibilità del database DAG01.
Parametri
-Dag
Il parametro Dag consente di filtrare i risultati della coda di recapito per gruppo di disponibilità del database. È possibile specificare qualsiasi valore che identifichi il gruppo di disponibilità del database in maniera univoca. È possibile specificare più valori separati da virgole. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Non è possibile utilizzare il parametro Dag con i parametri Server, Site oppure Forest.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DetailsLevel
Il parametro DetailsLevel consente di specificare il livello di dettagli per la visualizzazione dei risultati. I valori validi per questo parametro sono None, Normal e Verbose. Il valore predefinito è Normal.
| Type: | DetailsLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Forest
L'opzione Foresta filtra i risultati della coda di recapito in base alla foresta di Active Directory. Per l'opzione Forest non è necessario specificare un valore.
Non è possibile utilizzare l'opzione Forest con i parametri Server, Site oppure Dag.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GroupBy
Il parametro GroupedBy consente di ordinare i messaggi nei risultati della coda di recapito. I valori validi sono:
- DeliveryType
- LastError
- NextHopCategory
- NextHopDomain (questo è il valore predefinito)
- NextHopKey
- RiskLevel
- Stato
- NomeServer
- OutboundIPPool
| Type: | QueueDigestGroupBy |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ResultSize
Il parametro ResultSize consente di filtrare i risultati della coda di recapito in base al numero di messaggi nella coda. I valori validi per questo parametro sono i numeri interi. Il valore predefinito è 1000. Ad esempio, se si specifica il valore 50, il comando visualizza le 50 code contenenti più messaggi.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Server
Il parametro Server filtra i risultati della coda di recapito in base al server Exchange. È possibile specificare qualsiasi valore che identifichi il server in maniera univoca. È possibile specificare più valori separati da virgole. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Non è possibile utilizzare il parametro Server con i parametri Dag, Site oppure Forest.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Site
Il parametro Site filtra i risultati della coda di recapito in base al sito di Active Directory. È possibile specificare qualsiasi valore che identifichi il sito in maniera univoca. È possibile specificare più siti separandoli con una virgola.
Non è possibile utilizzare il parametro Site con i parametri Server, Dag oppure Forest.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Timeout
Il parametro Timeout specifica il numero di secondi prima del timeout dell'operazione. Il valore predefinito è 10 secondi.
Per specificare un valore, immetterlo come intervallo di tempo: dd.hh:mm:ss dove dd = days, hh = hours, mm = minuti e ss = secondi.
| Type: | EnhancedTimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | 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.