Compartir a través de


Get-Queue

Este cmdlet solo está disponible en el entorno local de Exchange.

Use el cmdlet Get-Queue para ver la información de configuración de las colas en servidores de buzón o servidores de transporte perimetral.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

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

Description

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Get-Queue | Format-List

En este ejemplo se muestra información detallada de todas las colas del servidor de buzones en el que se ejecuta el comando.

Ejemplo 2

Get-Queue -Filter "MessageCount -gt 100"

En este ejemplo se enumeran las colas que contienen más de 100 mensajes.

Ejemplo 3

Get-Queue Server1\contoso.com | Format-List

En este ejemplo se muestra información detallada de una cola específica que existe en el servidor de buzones denominado Server1.

Ejemplo 4

Get-Queue -Exclude Internal

En este ejemplo se enumeran solo las colas externas.

Parámetros

-BookmarkIndex

El parámetro BookmarkIndex especifica la posición en el conjunto de resultados donde se inician los resultados mostrados. El valor de este parámetro es un índice de base 1 en el conjunto de resultados totales. El parámetro BookmarkIndex no puede usarse con el parámetro 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

El parámetro BookmarkObject especifica el objeto en el conjunto de resultados donde se inician los resultados mostrados. El parámetro BookmarkObject no puede usarse con el parámetro 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

El parámetro Exclude especifica los tipos de colas que desea excluir de los resultados. El parámetro PasswordQuality especifica la clasificación de calidad mínima de la contraseña que se requiere para las contraseñas del dispositivo. La calidad de la contraseña es una escala numérica que indica la seguridad y complejidad de la contraseña. Un valor de calidad superior indica una contraseña más segura.

  • Interno
  • Externo
  • Valor deliveryType de cola válido. Para obtener más información, consulte la sección NextHopSolutionKey en Colas y mensajes en colas.
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

El parámetro Filter especifica una o varias colas mediante la sintaxis de filtro de OPATH. El filtro OPATH incluye un nombre de propiedad de cola seguido de un operador de comparación y un valor (por ejemplo, "NextHopDomain -eq 'contoso.com'"). Para obtener más información sobre las propiedades de cola filtrables y los operadores de comparación, consulte Propiedades de cola en Exchange Server y Búsqueda de colas y mensajes en colas en el Shell de administración de Exchange.

Puede especificar varios criterios mediante el operador de comparación y . Los valores de propiedad que no se expresen como un entero deben estar entre comillas (").

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

El parámetro Identity especifica la cola. La entrada válida para este parámetro debe usar la sintaxis Server\Queue o Queue, por ejemplo, Mailbox01\contoso.com o Unreachable. Para obtener más información sobre la identidad de cola, consulte Identidad de cola.

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

El parámetro Include especifica los tipos de colas que desea incluir los resultados. El parámetro PasswordQuality especifica la clasificación de calidad mínima de la contraseña que se requiere para las contraseñas del dispositivo. La calidad de la contraseña es una escala numérica que indica la seguridad y complejidad de la contraseña. Un valor de calidad superior indica una contraseña más segura.

  • Interno
  • Externo
  • Valor deliveryType de cola válido. Para obtener más información, consulte la sección NextHopSolutionKey en Colas y mensajes en colas.
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

El parámetro IncludeBookmark especifica si se incluirá el objeto de marcador cuando se muestran los resultados de la búsqueda. El parámetro IncludeBookmark es válido cuando se usa con el parámetro BookmarkObject o BookmarkIndex. Si no especifica un valor para el parámetro IncludeBookmark, se usa el valor predeterminado de $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

El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. Si desea incluir en los resultados devueltos todas las solicitudes que coincidan con la consulta, use el valor ilimitado para este parámetro. El valor predeterminado es 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

ReturnPageInfo es un parámetro oculto. Úselo para devolver información acerca del número total de resultados y el índice del primer objeto de la página actual. El valor predeterminado es $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

El parámetro SearchForward especifica si la búsqueda se realiza hacia adelante o hacia atrás en el conjunto de resultados. El valor predeterminado es $true. Este valor hace que la página de resultados se calcule hacia adelante, ya sea desde el principio del conjunto de resultados o desde un marcador en caso de que se especifique uno.

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

El parámetro Server especifica el servidor Exchange en el que desea ejecutar este comando. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:

  • Name
  • FQDN
  • Distinguished name (DN)
  • Nombre distintivo (DN) heredado de Exchange

Nombre distintivo (DN) heredado de Exchange

No puede usar el parámetro Server y el parámetro Filter en el mismo comando. No puede usar el parámetro Server y el parámetro Identity en el mismo 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

El parámetro SortOrder especifica una matriz de propiedades de mensaje que se usa para controlar el criterio de ordenación del conjunto de resultados. Separe cada propiedad con coma. Anteponga un símbolo del signo más (+) al comienzo del nombre de la propiedad para mostrar los resultados en orden ascendente. Anteponga un símbolo del signo menos (-) al comienzo del nombre de la propiedad para mostrar los resultados en orden descendente.

Si no especifica un criterio de ordenación, QueueIdentity muestra el conjunto de resultados en orden ascendente.

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

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.