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 buzones 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.
Sintaxis
Identity
Get-Queue
[[-Identity] <QueueIdentity>]
[-BookmarkIndex <Int32>]
[-BookmarkObject <ExtensibleQueueInfo>]
[-Exclude <QueueViewerIncludesAndExcludes>]
[-Include <QueueViewerIncludesAndExcludes>]
[-IncludeBookmark <Boolean>]
[-ResultSize <Unlimited>]
[-ReturnPageInfo <Boolean>]
[-SearchForward <Boolean>]
[-SortOrder <QueueViewerSortOrderEntry[]>]
[<CommonParameters>]
Server
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 artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. 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
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propiedades del parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-BookmarkObject
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propiedades del parámetro
| Tipo: | ExtensibleQueueInfo |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Exclude
Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propiedades del parámetro
| Tipo: | QueueViewerIncludesAndExcludes |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Filter
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 (").
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Server
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propiedades del parámetro
| Tipo: | QueueIdentity |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Identity
| Posición: | 1 |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Include
Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propiedades del parámetro
| Tipo: | QueueViewerIncludesAndExcludes |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-IncludeBookmark
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propiedades del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ResultSize
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propiedades del parámetro
| Tipo: | Unlimited |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ReturnPageInfo
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propiedades del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SearchForward
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propiedades del parámetro
| Tipo: | Boolean |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Server
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propiedades del parámetro
| Tipo: | ServerIdParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Server
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-SortOrder
Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propiedades del parámetro
| Tipo: | QueueViewerSortOrderEntry[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.
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.