Get-QueueDigest
Este cmdlet está disponível somente no Exchange local.
Utilize o cmdlet Get-QueueDigest para ver informações sobre filas de entrega de mensagens entre os grupos de disponibilidade de bases de dados (DAGs) sites do Active Directory ou florestas do Active Directory na 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.
Sintaxe
Dag
Get-QueueDigest
-Dag <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Forest
Get-QueueDigest
[-Forest]
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Server
Get-QueueDigest
-Server <MultiValuedProperty>
[-DetailsLevel <DetailsLevel>]
[-Filter <String>]
[-GroupBy <QueueDigestGroupBy>]
[-ResultSize <Unlimited>]
[-Timeout <EnhancedTimeSpan>]
[<CommonParameters>]
Site
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 artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 devolve 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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Dag
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-DetailsLevel
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | DetailsLevel |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Filter
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro Filter especifica uma ou mais filas através da sintaxe do filtro OPATH. O filtro OPATH inclui um nome de propriedade de fila seguido de um operador de comparação e um valor (por exemplo, "NextHopDomain -eq 'contoso.com'"). Para obter detalhes sobre as propriedades de fila filtráveis e os operadores de comparação, veja Propriedades da fila no Exchange Server e Localizar filas e mensagens em filas na Shell de Gestão do Exchange.
Pode especificar vários critérios com o operador e de comparação. Os valores de propriedade não expressos como um inteiro devem ficar entre aspas (").
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Forest
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O comutador Forest 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Forest
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-GroupBy
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro GroupedBy classifica as mensagens nos resultados da fila de entrega. Os valores válidos são:
- DeliveryType
- Último Erro
- NextHopCategory
- NextHopDomain (este é o valor predefinido)
- NextHopKey
- Nível de Risco
- Status
- ServerName
- OutboundIPPool
Propriedades do parâmetro
| Tipo: | QueueDigestGroupBy |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ResultSize
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Server
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Server
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Site
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Site
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Timeout
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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, introduza-o como um intervalo de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.
Propriedades do parâmetro
| Tipo: | EnhancedTimeSpan |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.