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.