Get-QueueDigest
Este cmdlet solo está disponible en el entorno local de Exchange.
Use el cmdlet Get-QueueDigest para ver información sobre las colas de entrega de mensajes en los sitios de Active Directory de grupos de disponibilidad de bases de datos (DAG) o bosques de Active Directory de la organización.
De forma predeterminada, el cmdlet Get-QueueDigest muestra las colas de entrega que contienen diez o más mensajes y los resultados que tienen entre uno y dos minutos de antigüedad. Si quiere ver las instrucciones para cambiar estos valores predeterminados, consulte Configurar Get-QueueDigest.
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-QueueDigest
-Dag <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Get-QueueDigest
[-Forest]
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Get-QueueDigest
-Server <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Get-QueueDigest
-Site <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<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-QueueDigest -Forest
En este ejemplo se devuelve información sobre todas las colas del bosque de Active Directory.
Ejemplo 2
Get-QueueDigest -Dag DAG01
En este ejemplo se devuelve información sobre todas las colas del DAG denominada DAG01.
Parámetros
-Dag
El parámetro Dag filtra los resultados de la cola de entrega por DAG. Puede especificar cualquier valor que identifique de forma única el DAG. Puede especificar distintos valores separados por comas. Si el valor contiene espacios, escriba el valor entre comillas (").
No se puede usar el parámetro Dag con los parámetros Server, Site o Forest.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DetailsLevel
El parámetro DetailsLevel especifica el nivel de detalle que se va a mostrar en los resultados. Los valores válidos para este parámetro son None, Normal y Verbose. El valor predeterminado es Normal.
Type: | DetailsLevel |
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 2013, Exchange Server 2016, Exchange Server 2019 |
-Forest
El modificador Bosque filtra los resultados de la cola de entrega por bosque de Active Directory. No es necesario especificar un valor con el modificador Bosque.
No se puede usar el modificador Bosque con los parámetros Server, Site o Dag.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GroupBy
El parámetro GroupedBy ordena los mensajes en los resultados de la cola de entrega. Los valores admitidos son:
- DeliveryType
- LastError
- NextHopCategory
- NextHopDomain (este es el valor predeterminado)
- NextHopKey
- RiskLevel
- Estado
- ServerName
- OutboundIPPool
Type: | QueueDigestGroupBy |
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 |
-ResultSize
El parámetro ResultSize filtra los resultados de la cola de entrega por el número de mensajes de la cola. La entrada válida para este parámetro es un entero. El valor predeterminado es 1000. Por ejemplo, si especifica el valor 50, el comando muestra las 50 colas que contienen la mayoría de los mensajes.
Type: | Unlimited |
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 |
-Server
El parámetro Server filtra los resultados de la cola de entrega por parte del servidor exchange. Puede especificar cualquier valor que identifique de forma única el servidor. Puede especificar distintos valores separados por comas. Si el valor contiene espacios, escriba el valor entre comillas (").
No puede usar el parámetro Server con los parámetros Dag, Site o Forest.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Site
El parámetro Site filtra los resultados de la cola de entrega por sitio de Active Directory. Puede especificar cualquier valor que identifique de forma única el sitio. Puede especificar varios sitios separados por comas.
No puede usar el parámetro Site con los parámetros Server, Dag o Forest.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Timeout
El parámetro Timeout especifica el número de segundos antes de que se agote el tiempo de espera de la operación. El valor predeterminado es 10 segundos.
Para especificar un valor, introdúzcalo como un intervalo de tiempo: dd.hh:mm:ss donde dd = días, hh = horas, mm = minutos y ss = segundos.
Type: | EnhancedTimeSpan |
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 |
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.