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-List

In 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-List

In questo esempio vengono visualizzate informazioni dettagliate su una specifica coda esistente sul server Cassette postali Server1.

Esempio 4

Get-Queue -Exclude Internal

In 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.