Get-QueueDigest

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Get-QueueDigest para exibir informações sobre filas de entrega de mensagens em dags (grupos de disponibilidade de banco de dados) sites do Active Directory ou florestas do Active Directory em sua organização.

Por padrão, o cmdlet Get-QueueDigest exibe as filas de entrega que contêm dez ou mais mensagens e os resultados são de um a dois minutos atrás. Para instruções sobre como alterar estes valores padrões, consulte Configurar Get-QueueDigest.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

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

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-QueueDigest -Forest

Este exemplo retorna informações sobre todas as filas na floresta do Active Directory.

Exemplo 2

Get-QueueDigest -Dag DAG01

Este exemplo retorna informações sobre todas as filas no DAG chamado DAG01.

Parâmetros

-Dag

O parâmetro Dag filtra os resultados de fila de entrega por DAG. É possível especificar qualquer valor que identifique o DAG com exclusividade. Vários valores, separados por vírgulas, podem ser especificados. Se o valor contiver espaços, coloque-o entre aspas (").

Não é possível usar o parâmetro Dag com os parâmetros Server, Site ou 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

O parâmetro DetailsLevel especifica o nível de detalhes a serem exibidos nos resultados. Os valores válidos para esse parâmetro são None, Normal e Verbose. O valor padrão é 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

O parâmetro Filter especifica uma ou mais filas usando a sintaxe do filtro OPATH. O filtro OPATH inclui um nome de propriedade de fila seguido por um operador de comparação e valor (por exemplo, "NextHopDomain -eq 'contoso.com'"). Para obter detalhes sobre propriedades de fila filtradas e operadores de comparação, consulte Propriedades de fila em Exchange Server e Localizar filas e mensagens em filas no Shell de Gerenciamento do Exchange.

Você pode especificar vários critérios usando o operador de comparação e. Os valores de propriedade não expressos como um inteiro devem ficar entre aspas (").

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

O comutador Floresta filtra os resultados da fila de entrega pela floresta do Active Directory. Você não precisa especificar um valor com a opção Forest.

Não é possível usar a opção Forest com os parâmetros Server, Site ou 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

O parâmetro GroupedBy classifica as mensagens nos resultados da fila de entrega. Os valores válidos são:

DeliveryType
Lasterror
NextHopCategory
NextHopDomain (este é o valor padrão)
NextHopKey
RiskLevel
Status
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

O parâmetro ResultSize filtra os resultados da fila de entrega pelo número de mensagens na fila. A entrada válida para esse parâmetro é um inteiro. O valor padrão é 1000. Por exemplo, se você especificar o valor como 50, o comando exibirá as 50 filas que contêm mais mensagens.

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

O parâmetro Server filtra os resultados da fila de entrega pelo servidor exchange. É possível especificar qualquer valor que identifique o servidor com exclusividade. Vários valores, separados por vírgulas, podem ser especificados. Se o valor contiver espaços, coloque-o entre aspas (").

Não é possível usar o parâmetro Server com os parâmetros Dag, Site ou 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

O parâmetro Site filtra os resultados da fila de entrega pelo site do Active Directory. É possível especificar qualquer valor que identifique o site com exclusividade. Vários sites, separados por vírgulas, podem ser especificados.

Não é possível usar o parâmetro Site com os parâmetros Server, Dag ou 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

O parâmetro Timeout especifica o número de segundos antes que o tempo limite da operação tenha se esgotado. O valor padrão é 10 segundos.

Para especificar um valor, insira-o como um intervalo de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e 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 os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.