Get-QueueDigest
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 -ForestEste exemplo retorna informações sobre todas as filas na floresta do Active Directory.
Exemplo 2
Get-QueueDigest -Dag DAG01Este 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.