Get-Queue (RTM)

Artículo
08/09/2014

Se aplica a: Exchange Server 2007 SP1, Exchange Server 2007

Última modificación del tema: 2007-08-06

Use el cmdlet Get-Queue para ver la información de configuración de las colas en un equipo que tenga instalada la función de servidor Transporte de concentradores o Transporte perimetral.

Sintaxis

Get-Queue [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-Filter <String>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-Server <ServerIdParameter>] [-SortOrder <SortOrderEntry[]>]

Get-Queue [-Identity <QueueIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Descripción detallada

El cmdlet Get-Queue muestra información acerca de las colas existentes en un servidor de transporte de concentradores o transporte perimetral. Si no proporciona parámetros, el comando busca todas las colas en el servidor local y devuelve una única página de resultados. El tamaño predeterminado de la página es de 1.000 objetos. Se pueden mostrar colas en un servidor remoto incluyendo el nombre del servidor como parte del parámetro Identity, o mediante el uso del parámetro Server con una consulta de filtro. Los parámetros Identity y Filter son mutuamente excluyentes.

Para ejecutar el cmdlet Get-Queue, la cuenta que use debe tener delegada la siguiente función:

Función de administradores de servidores de Exchange

Para ejecutar el cmdlet Get-Queue en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión con una cuenta que sea miembro del grupo local de administradores en dicho equipo.

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro	Necesario	Tipo	Descripción
BookmarkIndex	Opcional	System.Int32	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 basado en 1 en el conjunto de resultados totales. BookmarkIndex no se puede usar con el parámetro BookmarkObject.
BookmarkObject	Opcional	Microsoft.Exchange.Data.QueueViewer.QueueInfo	El parámetro BookmarkObject especifica el objeto en el conjunto de resultados en el que se inician los resultados mostrados. BookmarkObject no se puede usar con el parámetro BookmarkIndex.
Filter	Opcional	System.String	El parámetro Filter requiere una expresión que especifica los criterios de valor de la propiedad para las colas que desea mostrar. La expresión incluye un nombre de propiedad seguido de un operador y un valor de comparación. Las siguientes propiedades de la cola son criterios válidos para el parámetro Filter: DeliveryType El tipo de entrega de esta cola tal y como define el transporte. El tipo de entrega debe ser uno de los valores siguientes: DNSConnectorDelivery NonSMTPGatewayDelivery SmartHostConnectorDelivery SmtpRelayWithinAdSitetoEdge MapiDelivery SmtpRelayWithinAdSite SmtpRelaytoRemoteAdSite SmtpRelaytoTiRg Undefined Unreachable Identity Escriba la identidad de la cola con el formato Servidor/destino, donde destino es un nombre de dominio remoto, servidor de buzón o cola persistente. LastError Una cadena de texto del último error registrado de una cola. LastRetryTime La hora en la que se intentó por última vez establecer conexión en esta cola. MessageCount El número de elementos que hay en la cola. NextHopConnector El GUID del conector que se usó para crear la cola. NextHopDomain El dominio del siguiente salto de la cola, especificado como un dominio remoto de Protocolo simple de transferencia de correo (SMTP), un nombre de servidor, el nombre de un sitio de Active Directory o un identificador de base de datos de mensajes (MDB). NextRetryTime La hora en la que se volverá a intentar establecer conexión en esta cola. Status El estado de la cola. Las opciones de estado de la cola son Active, Ready, Retry o Suspended. Los criterios se pueden especificar mediante el uso del operador de comparación -and. Los valores de propiedad que no se expresen como un entero deben estar entre comillas.
Identity	Opcional	Microsoft.Exchange.Data.QueueViewer.QueueIdentity	Use el parámetro Identity para especificar la identidad de la cola que contiene los mensajes que desea mostrar. Escriba la identidad de la cola con el formato Servidor/destino, donde destino es un nombre de dominio remoto, servidor de buzón o cola persistente.
IncludeBookmark	Opcional	System.Boolean	Use el parámetro IncludeBookmark para especificar si 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 los parámetros BookmarkObject o BookmarkIndex. Si no especifica un valor para el parámetro IncludeBookmark, se usa el valor predeterminado de `$true`.
ResultSize	Opcional	Microsoft.Exchange.Data.Unlimited	Use el parámetro ResultSize para especificar el número total de elementos a mostrar en el conjunto de resultados. El valor predeterminado del parámetro ResultSize se establece en 1.000. ResultSize es compatible con un número ilimitado de resultados, pero Microsoft Exchange limita el conjunto de resultados en 250.000.
ReturnPageInfo	Opcional	System.Boolean	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`.
SearchForward	Opcional	System.Boolean	Use el parámetro SearchForward para especificar si buscar 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 sea calculada hacia adelante tanto desde el principio del conjunto de resultados como hacia adelante desde un marcador si fuese especificado.
Server	Opcional	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Use el parámetro Server para especificar el nombre del servidor al que conectar mediante una llamada a procedimiento remoto (RPC) que contiene las colas en las que se encuentran los mensajes que desea mostrar. Escriba el nombre del servidor como un nombre de host o un nombre completo de dominio (FQDN). Si no se usa el parámetroServer, se consulta el servidor local.
SortOrder	Opcional	Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[]	Use el parámetro SortOrder para especificar una matriz de propiedades de mensajes que se usan para controlar el orden de clasificación del conjunto de resultados. Separe cada propiedad mediante una coma. Anexe un símbolo + al principio del nombre de propiedad para mostrar los resultados en orden ascendente. Anexe un símbolo - al principio del nombre de propiedad para mostrar los resultados en orden descendente. Si no especifica un orden de clasificación, el conjunto de resultados se muestra en orden ascendente por QueueIdentity.

Tipos de entrada

Tipos de valores devueltos

Errores

Error	Descripción

Ejemplo

En el siguiente ejemplo se muestran tres comandos Get-Queue. El primer comando indica cómo mostrar la información de configuración de todas las colas en el servidor de transporte de concentradores o de transporte perimetral en el que se ejecuta el comando. El comando se envía al comando Format-List para mostrar los resultados como lista detallada.

El segundo comando indica cómo mostrar la información de configuración de colas que sólo contengan más de 100 mensajes.

El tercer comando indica cómo mostrar la información de configuración de una cola que existe en un servidor remoto.

Para obtener más información acerca de la canalización, vea Canalización.

Para obtener más información acerca de cómo trabajar con el resultado de un comando, vea Trabajo con salidas de comandos.

Para obtener más información acerca de cómo usar el Shell de administración de Exchange para realizar tareas de visor de cola, consulte Utilización de Shell de administración de Exchange para administrar colas.

Get-Queue | format-list
Get-Queue -Filter {MessageCount -gt 100}
Get-Queue -Identity Server1\contoso.com