Get-Queue
Questo cmdlet è disponibile solo in Exchange locale.
Utilizzare il cmdlet Get-Queue per visualizzare le informazioni di configurazione per le code sui server Cassette postali e Trasporto Edge.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Get-Queue
[[-Identity] <QueueIdentity>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleQueueInfo>]
[-Exclude <QueueViewerIncludesAndExcludes>]
[-Include <QueueViewerIncludesAndExcludes>]
[-IncludeBookmark <Boolean>]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]Get-Queue
[-Server <ServerIdParameter>]
[-Filter <String>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleQueueInfo>]
[-Exclude <QueueViewerIncludesAndExcludes>]
[-Include <QueueViewerIncludesAndExcludes>]
[-IncludeBookmark <Boolean>]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<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-Queue | Format-ListIn questo esempio vengono visualizzate informazioni dettagliate su tutte le code presenti sul server Cassette postali su cui viene eseguito il comando.
Esempio 2
Get-Queue -Filter "MessageCount -gt 100"In questo esempio vengono elencate le code che contengono più di 100 messaggi.
Esempio 3
Get-Queue Server1\contoso.com | Format-ListIn questo esempio vengono visualizzate informazioni dettagliate su una specifica coda esistente sul server Cassette postali Server1.
Esempio 4
Get-Queue -Exclude InternalIn questo esempio vengono elencate solo le code esterne.
Parametri
-BookmarkIndex
Il parametro BookmarkIndex consente di specificare la posizione nell'insieme di risultati da cui iniziano i risultati visualizzati. Il valore del parametro è un indice in base 1 nel set di risultati totale. Il parametro BookmarkIndex non può essere utilizzato con il parametro BookmarkObject.
| Type: | Int32 |
| 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 |
-BookmarkObject
Il parametro BookmarkObject consente di specificare l'oggetto nell'insieme di risultati da cui iniziano i risultati visualizzati. Il parametro BookmarkObject non può essere utilizzato con il parametro BookmarkIndex.
| Type: | ExtensibleQueueInfo |
| 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 |
-Exclude
Il parametro Exclude consente di specificare i tipi di code da escludere dai risultati. I valori validi per questo parametro sono:
- Interno
- Esterno
- Valore DeliveryType valido. Per informazioni dettagliate, vedere la sezione NextHopSolutionKey in Code e messaggi nelle code.
| Type: | QueueViewerIncludesAndExcludes |
| 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 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: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Include
Il parametro Include consente di specificare i tipi di code da includere nei risultati. I valori validi per questo parametro sono:
- Interno
- Esterno
- Valore DeliveryType valido. Per informazioni dettagliate, vedere la sezione NextHopSolutionKey in Code e messaggi nelle code.
| Type: | QueueViewerIncludesAndExcludes |
| 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 |
-IncludeBookmark
Il parametro IncludeBookmark consente di specificare se includere l'oggetto segnalibro quando vengono visualizzati i risultati della query. Il parametro IncludeBookmark è valido quando viene utilizzato con i parametri BookmarkObject o BookmarkIndex. Se non si specifica un valore per il parametro IncludeBookmark, verrà utilizzato il valore predefinito $true.
| 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 |
-ResultSize
Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le richieste che soddisfano la query, impostare questo parametro sul valore unlimited. Il valore predefinito è 1000.
| Type: | Unlimited |
| 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 |
-ReturnPageInfo
Il parametro ReturnPageInfo è un parametro nascosto. Usarlo per restituire informazioni sul numero totale di risultati e sull'indice del primo oggetto della pagina corrente. Il valore predefinito è $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 |
-SearchForward
Il parametro SearchForward consente di specificare se cercare in avanti o all'indietro nell'insieme di risultati. Il valore predefinito è $true. Questo valore consente di calcolare la pagina dei risultati in avanti dall'inizio del set di risultati o di un eventuale segnalibro specificato.
| 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 |
-SortOrder
Il parametro SortOrder consente di specificare una matrice di proprietà dei messaggi utilizzate per controllare l'ordinamento dell'insieme di risultati. Separare ciascuna proprietà utilizzando una virgola. Aggiungere un simbolo + all'inizio del nome della proprietà per visualizzare i risultati in ordine crescente. Aggiungere un simbolo - all'inizio del nome della proprietà per visualizzare i risultati in ordine decrescente.
Se non viene specificato un criterio di ordinamento, l'insieme dei risultati viene visualizzato in ordine ascendente in base al parametro QueueIdentity.
| Type: | QueueViewerSortOrderEntry[] |
| 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.