Localizar filas e mensagens em filas no Shell de Gerenciamento do Exchange

  • Artigo

Como nas versões anteriores do Exchange, você pode usar o Shell de Gerenciamento do Exchange no Exchange Server para exibir informações sobre filas e mensagens e usar essas informações para agir em filas e mensagens. Normalmente, um Exchange ativo contém um grande número de filas e mensagens a serem entregues, portanto, é importante entender como identificar as filas ou mensagens que você deseja gerenciar.

Observe que você também pode usar o Visualizador de Filas na Caixa de Ferramentas do Exchange para gerenciar filas e mensagens em filas. No entanto, os cmdlets de exibição de fila e mensagem no Shell de Gerenciamento do Exchange dão suporte a propriedades e opções de filtro mais filtrantes do que o Visualizador de Filas. Para obter mais informações sobre como usar o Visualizador de Filas, consulte Visualizador de Filas.

Lembre-se também de que existem filas em servidores de caixa de correio e servidores de Transporte de Borda (o serviço de transporte). Para obter mais informações sobre filas e mensagens em filas, confira Filas e mensagens em filas.

Parâmetros de filtragem de fila

A tabela a seguir resume os parâmetros de filtragem que estão disponíveis nos cmdlets de gerenciamento de filas.

Cmdlet Parâmetros de filtragem Comments
Get-Queue Excluir
Filtro
Identity
Include
Servidor		 Você pode usar os parâmetros Incluir e Excluir com os outros parâmetros de filtragem no mesmo comando.
Você não pode usar os parâmetros Identidade e Filtro no mesmo comando.
O parâmetro Server especifica o servidor em que você deseja executar o comando. Você não pode usar os parâmetros Servidor e Identidade no mesmo comando, mas pode usar o parâmetro Server com os outros parâmetros de filtragem no mesmo comando.
Resume-Queue
Retry-Queue
Suspend-Queue		 Identity
Filtro
Servidor		 Você não pode usar o parâmetro Identity com os outros parâmetros de filtragem no mesmo comando.
O parâmetro Server especifica o servidor em que você deseja executar o comando. Você pode usar os parâmetros Servidor e Filtro no mesmo comando.
Get-QueueDigest Dag
Filtro
Floresta
Servidor
Site		 Você precisa usar um dos parâmetros Dag, Site, Server ou Forest , mas não pode usar nenhum deles juntos no mesmo comando.
Você pode usar o parâmetro Filter com qualquer um dos outros parâmetros de filtragem.

Identidade da fila

O parâmetro Identity usa asintaxe básica Fila> do Servidor<\ ><. Normalmente, esse valor identifica exclusivamente a fila, portanto, você não pode usar outros parâmetros de filtragem com o parâmetro Identity . A exceção é o cmdlet Get-Queue , em que você pode usar os parâmetros Incluir e Excluir com o parâmetro Identity .

A tabela a seguir explica a sintaxe do parâmetro Identity nos cmdlets de gerenciamento de filas.

Valor do parâmetro de identidade Descrição
<Server>\<PersistentQueueName> ou <PersistentQueueName> Uma fila persistente no servidor local ou especificado.
<PersistentQueueName> é Submission, Unreachableou Poison.
Para obter mais informações sobre filas persistentes, consulte Tipos de filas.
<Server>\<NextHopDomain> ou <NextHopDomain> Uma fila de entrega no servidor local ou especificado.
<NextHopDomain> é o nome da fila do valor da propriedade NextHopDomain da fila. Por exemplo, o espaço de endereço de um conector Send, o nome de um site do Active Directory ou o nome de um DAG. Para obter mais informações, consulte NextHopSolutionKey.
<Server>\<QueueInteger> ou <QueueInteger> Uma fila de entrega no servidor local ou especificado.
<QueueInteger> é o valor inteiro exclusivo atribuído a uma fila de entrega ou a uma fila de sombras no banco de dados de fila. No entanto, você precisa executar o cmdlet Get-Queue para encontrar esse valor nas propriedades Identity ou QueueIdentity .
<Server>\Shadow\<QueueInteger> ou Shadow\<QueueInteger> Uma fila de sombras no servidor local ou especificado. Para obter mais informações sobre filas de sombra e redundância de sombra, consulte Redundância de sombra no Exchange Server.
<Server>\* ou * Todas as filas no servidor local ou especificado.
Observação: a identidade é um parâmetro posicional, o que significa que você pode especificar o valor sem especificar o -Identity qualificador. Por exemplo, os seguintes comandos produzem o mesmo resultado:
Get-Queue -Identity *
Get-Queue *
Get-Queue

Parâmetro de filtro em cmdlets de fila

Você pode usar o parâmetro Filtrar em todos os cmdlets de gerenciamento de filas para identificar uma ou mais filas com base nas propriedades das filas. O parâmetro Filter cria um filtro OPath com operadores de comparação para restringir o comando a filas que atendem aos critérios de filtro. Você pode usar o operador -and lógico para especificar várias condições para a correspondência. Aqui está um exemplo genérico da sintaxe:

Get-Queue -Filter "<Property1> -<ComparisonOperator> '<Value1>' -and <Property2> -<ComparisonOperator> '<Value2>'..."

Para obter uma lista completa de propriedades de fila que você pode usar com o parâmetro Filtro , consulte Propriedades de fila.

Para obter uma lista de operadores de comparação que você pode usar com o parâmetro Filtro , consulte a seção Operadores de comparação a serem usados ao filtrar filas ou mensagens neste tópico.

Para obter exemplos de procedimentos que usam o parâmetro Filter para exibir e gerenciar filas, consulte Procedimentos para filas.

Incluir e excluir parâmetros no Get-Queue

Você pode usar os parâmetros Incluir e Excluir no cmdlet Get-Queue por conta própria, com cada othe ou com os outros parâmetros de filtragem para ajustar seus resultados. Por exemplo, você pode:

  • Exclua filas vazias.

  • Exclua filas para destinos externos.

  • Inclua filas que tenham um valor específico do DeliveryType.

Os parâmetros Incluir e Excluir usam as seguintes propriedades de fila para filtrar filas:

Valor Descrição Exemplo
DeliveryType Inclui ou exclui filas com base na propriedade DeliveryType que define como a mensagem será transmitida para o próximo salto. Os valores válidos são descritos no NextHopSolutionKey.
Vários valores, separados por vírgulas, podem ser especificados.		 Retorna todas as filas de entrega no servidor local, onde o próximo salto é um conector Send hospedado no servidor local e está configurado para roteamento de host inteligente.
Get-Queue -Include SmartHostConnectorDelivery
Empty Inclui ou exclui filas vazias. Filas vazias têm o valor 0 na propriedade MessageCount . Retorna todas as filas no servidor local que contêm mensagens.
Get-Queue -Exclude Empty
External Inclui ou exclui filas que têm o valor External na propriedade NextHopCategory .

Filas externas sempre têm um dos seguintes valores para DeliveryType:

  • DeliveryAgent
  • DnsConnectorDelivery
  • NonSmtpGatewayDelivery
  • SmartHostConnectorDelivery

Para obter mais informações, consulte NextHopSolutionKey.

 Retorna todas as filas internas no servidor local.
Get-Queue -Exclude External
Internal Esse valor inclui ou exclui filas que têm o valor Internal na propriedade NextHopCategory . Observe que uma mensagem para um destinatário externo pode exigir vários saltos internos antes de chegar a um servidor de gateway em que é entregue externamente. Retorna todas as filas internas no servidor local.
Get-Queue -Include Internal

Observe que você pode duplicar a funcionalidade dos parâmetros Incluir e Excluir usando o parâmetro Filter . Por exemplo, os seguintes comandos produzem o mesmo resultado:

  • Get-Queue -Exclude Empty

  • Get-Queue -Filter "MessageCount -gt 0"

No entanto, como você pode ver, a sintaxe dos parâmetros Incluir e Excluir é mais simples e fácil de lembrar.

Get-QueueDigest

O cmdlet Get-QueueDigest permite exibir informações sobre algumas ou todas as filas em sua organização usando um único comando. Especificamente, o cmdlet Get-QueueDigest permite que você exiba informações sobre filas com base em sua localização nos servidores, em DAGs, nos sites do Active Directory ou em toda a floresta do Active Directory.

Observe que as filas em um servidor de Transporte de Borda subscrito não estão incluídas nos resultados. Além disso, Get-QueueDigest está disponível em um servidor de Transporte de Borda, mas os resultados são restritos a filas locais no servidor de Transporte de Borda.

Observação

Por padrão, o cmdlet Get-QueueDigest exibe as filas de entrega que contenham 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.

A tabela a seguir descreve os parâmetros de filtragem e classificação disponíveis no cmdlet Get-QueueDigest .

Parâmetro Descrição
Dag, Server ou Site Esses parâmetros são mutuamente exclusivos (não podem ser usados no mesmo comando) e definem o escopo do cmdlet. Você precisa especificar um desses parâmetros ou a opção Floresta . Normalmente, você usaria o nome do servidor, DAG ou site do Active Directory, mas pode usar qualquer valor que identifique exclusivamente o servidor, o DAG ou o site. Você pode especificar vários servidores, DAGs ou sites separados por vírgulas.
Floresta Essa opção será necessária se você não estiver usando os parâmetros Dag, Server ou Site . Você não especifica um valor com essa opção. Usando essa opção, você obtém filas de todos os servidores do Exchange Mailbox na floresta local do Active Directory. Você não pode usar essa opção para exibir filas em florestas remotas do Active Directory.
DetailsLevel Normal é o valor padrão. As seguintes propriedades são retornadas nos resultados:
  • QueueIdentity
  • ServerIdentity
  • MessageCount

Verbose retorna as seguintes propriedades adicionais nos resultados:

  • DeferidoMessageCount
  • LockedMessageCount*
  • IncomingRate
  • OutgoingRate
  • Velocity
  • NextHopDomain
  • NextHopCategory
  • NextHopConnector
  • DeliveryType*
  • Status
  • RiskLevel*
  • OutboundIPPool*
  • Lasterror
  • TlsDomain

None omite o nome da fila da coluna Detalhes nos resultados.

* Essas propriedades são reservadas para uso interno da Microsoft e não são usadas em organizações locais do Exchange. Para obter mais informações sobre todas as propriedades desta lista, confira Propriedades da fila.
Filtro Filtrar filas com base nas propriedades da fila, conforme descrito na seção Filtrar parâmetro em cmdlets de fila . Você pode usar qualquer uma das propriedades da fila filtrada, conforme descrito no tópico Propriedades da fila .
GroupBy Agrupa os resultados da fila. Você pode agrupar os resultados por uma das seguintes propriedades:
  • DeliveryType
  • Lasterror
  • NextHopCategory
  • NextHopDomain
  • NextHopKey
  • Status
  • Servername

Por padrão, os resultados são agrupados por NextHopDomain. Para obter informações sobre essas propriedades de fila, consulte Propriedades da fila.
Resultsize Limita os resultados da fila ao valor especificado. As filas são classificadas em ordem decrescente com base no número de mensagens na fila e agrupadas pelo valor especificado pelo parâmetro GroupBy . O valor padrão é 1000. Isso significa que, por padrão, o comando exibe as 1000 principais filas agrupadas pelo NextHopDomain e classificadas pelas filas que contêm mais mensagens para as filas que contêm as mensagens mínimas.
Timeout O parâmetro especifica o número de segundos antes do tempo limite da operação. O valor padrão é 00:00:10 ou 10 segundos.

Este exemplo retorna todas as filas externas não vazias nos servidores chamados Mailbox01, Mailbox02 e Mailbox03.

Get-QueueDigest -Server Mailbox01,Mailbox02,Mailbox03 -Include External -Exclude Empty

Parâmetros de filtragem de mensagem

A tabela a seguir resume os parâmetros de filtragem que estão disponíveis nos cmdlets de gerenciamento de mensagens.

Cmdlet Parâmetros de filtragem Comments
Get-Message Filtro
Identity
Fila
Servidor		 Você não pode usar os parâmetros Filtrar, Identidade ou Fila no mesmo comando.
O parâmetro Server especifica o servidor em que você deseja executar o comando. Você pode usar os parâmetros Servidor e Filtro no mesmo comando.
Remove-Message
Resume-Message
Suspend-Message		 Filtro
Identity
Servidor		 Você precisa usar o parâmetro Identity ou o parâmetro Filter , mas não pode usá-los no mesmo comando.
O parâmetro Server especifica o servidor em que você deseja executar o comando. Você pode usar os parâmetros Servidor e Filtro no mesmo comando.
Redirect-Message Servidor Esse cmdlet drena mensagens ativas de todas as filas de entrega no servidor especificado, portanto, Server é o único parâmetro de filtragem disponível. Para obter mais informações, confira Redirecionar mensagens em filas.
Export-Message Identity Esse parâmetro não é realmente um filtro, pois identifica exclusivamente a mensagem. Para identificar várias mensagens para esse cmdlet, use Get-Message e pipe os resultados para Export-Message. Para obter mais informações e exemplos, consulte Exportar mensagens de filas.

Identidade da mensagem

O parâmetro Identity nos cmdlets de gerenciamento de mensagens identifica exclusivamente uma mensagem em uma ou mais filas, para que você não possa usar nenhum outro parâmetro de filtragem de mensagens. O parâmetro Identity usa a sintaxe <Server>\<Queue>\<MessageInteger>básica .

A tabela a seguir descreve a sintaxe que você pode usar com o parâmetro Identity nos cmdlets de gerenciamento de mensagens.

**Valor do parâmetro de identidade Descrição**
<Server>\<Queue>\<MessageInteger> ou <Queue>\<MessageInteger> Uma mensagem em uma fila específica no servidor local ou especificado.

<Queue> é a identidade da fila, conforme descrito na seção Identidade da fila :

  • Nome da fila persistente
  • Nome da fila de entrega
  • Inteiro de fila
  • Identidade da fila de sombras

<MessageInteger> é o valor inteiro exclusivo atribuído à mensagem quando ela entra pela primeira vez no banco de dados de fila no servidor. Se a mensagem é enviada para vários destinatários que exigem várias filas, todas as cópias da mensagem em todas as filas do banco de dados de fila têm o mesmo valor de número inteiro. No entanto, você precisa executar o cmdlet Get-Message para encontrar esse valor nas propriedades Identity ou MessageIdentity .
<Server>\*\<MessageInteger>ou ou *\<MessageInteger><MessageInteger> Todas as cópias da mensagem em todas as filas no banco de dados de fila no servidor especificado ou local.

Parâmetro de filtro em cmdlets de mensagem

Você pode usar o parâmetro Filtrar com os cmdlets Get-Message, Remove-Message, Resume-Message e Suspend-Message para identificar uma ou mais mensagens com base nas propriedades das mensagens. O parâmetro Filter cria um filtro OPath com operadores de comparação para restringir o comando a mensagens que atendem aos critérios de filtro. Você pode usar o operador -and lógico para especificar várias condições para a correspondência. Aqui está um exemplo genérico da sintaxe:

Get-Message -Filter "<Property1> -<ComparisonOperator> '<Value1>' -and <Property2> -<ComparisonOperator> '<Value2>'..."

Para obter uma lista completa de propriedades de mensagem que você pode usar com o parâmetro Filtro , consulte Propriedades da mensagem).

Para obter uma lista de operadores de comparação que você pode usar com o parâmetro Filtro , consulte a seção Operadores de comparação a serem usados ao filtrar filas ou mensagens neste tópico.

Para obter exemplos de procedimentos que usam o parâmetro Filter para exibir e gerenciar mensagens, consulte Procedimentos para mensagens em filas.

Parâmetro de fila

O parâmetro Fila está disponível apenas no cmdlet Get-Message . Você pode usar esse parâmetro para obter todas as mensagens em uma fila específica ou todas as mensagens de várias filas usando o caractere curinga (*). Ao usar o parâmetro Fila , use o formato <Server>\<Queue> de identidade da fila conforme descrito na seção Identidade de fila neste tópico.

Operadores de comparação para usar ao filtrar filas ou mensagens

Ao criar uma expressão de filtro de fila ou mensagem usando o parâmetro Filter , você precisa incluir um operador de comparação para que o valor da propriedade corresponda. Os operadores de comparação que você pode usar e como cada função de operador são descritas na tabela a seguir. Para todos os operadores, os valores em comparação não diferenciam maiúsculas de minúsculas.

Operador Função Exemplo de código
-eq Correspondência exata do valor especificado. Mostrar todas as filas que têm um status de repetição:
Get-Queue -Filter "Status -eq 'Retry'"
Mostrar todas as mensagens que têm um status de repetição:
Get-Message -Filter "Status -eq 'Retry'"
-ne Não corresponde ao valor especificado. Mostrar todas as filas que não têm um status de Ativo:
Get-Queue -Filter "Status -ne 'Active'"
Mostrar todas as mensagens que não têm um status do Active:
Get-Message -Filter "Status -ne 'Active'"
-gt Maior que o valor inteiro ou data/hora especificado. Mostrar filas que atualmente contêm mais de 1.000 mensagens:
Get-Queue -Filter "MessageCount -gt 1000"
Mostrar mensagens que atualmente têm uma contagem de repetição que é mais de 3:
Get-Message -Filter "RetryCount -gt 3"
-ge Maior ou igual ao valor inteiro ou data/hora especificado. Mostrar filas que atualmente contêm 1.000 ou mais mensagens:
Get-Queue -Filter "MessageCount -ge 1000"
Mostrar mensagens que atualmente têm uma contagem de repetição que é 3 ou mais:
Get-Message -Filter "RetryCount -ge 3"
-lt Menor que o valor inteiro ou data/hora especificado. Mostrar filas que atualmente contêm menos de 1.000 mensagens:
Get-Queue -Filter "MessageCount -lt 1000"
Mostrar mensagens que têm uma SCL menor que 6:
Get-Message -Filter "SCL -lt 6"
-le Menor ou igual ao valor inteiro ou data/hora especificado. Mostrar filas que atualmente contêm 1.000 ou menos mensagens:
Get-Queue -Filter "MessageCount -le 1000"
Mostrar mensagens que têm uma SCL que é 6 ou menos:
Get-Message -Filter "SCL -le 6"
-like Contém o texto especificado. Você precisa incluir o caractere curinga (*) na cadeia de caracteres de texto. Mostrar filas que têm um destino para qualquer domínio SMTP que termina em Contoso.com:
Get-Queue -Filter "Identity -like '*contoso.com'"
Mostrar mensagens que têm um assunto que contém o texto "empréstimo do dia de pagamento":
Get-Message -Filter "Subject -like '*payday loan*'"

Você pode especificar um filtro que avalia várias expressões usando o operador -andlógico . As filas ou mensagens devem corresponder a todas as condições de filtro a serem incluídas nos resultados.

Este exemplo exibe uma lista de filas que tenham um destino para qualquer nome de domínio SMTP que termina em Contoso.com e que atualmente contém mais de 500 mensagens.

Get-Queue -Filter "Identity -like '*contoso.com*' -and MessageCount -gt 500"

Este exemplo exibe uma lista de mensagens enviadas de qualquer endereço de email no domínio contoso.com que tenha um valor SCL maior que 5.

Get-Message -Filter "FromAddress -like '*Contoso.com*' -and SCL -gt 5"

Parâmetros de paginação avançados

Quando você usa o Shell de Gerenciamento do Exchange para exibir filas e mensagens em filas, sua consulta recupera uma página de informações por vez. Os parâmetros avançados de paginação controlam o tamanho dos resultados e a ordem em que os resultados são exibidos. Todos os parâmetros avançados de paginação são opcionais e podem ser usados com ou sem outros parâmetros de filtragem nos cmdlets Get-Queue e Get-Message . Se nenhum parâmetro de paginação avançada for especificado, a consulta retornará os resultados na ordem crescente de identidade.

Por padrão, quando você especifica uma ordem de classificação, a propriedade Identity é sempre incluída e classificada em ordem crescente, pois as outras propriedades de fila ou mensagem disponíveis não são exclusivas.

Você pode usar os parâmetros BookmarkIndex e BookmarkObject para marcar uma posição nos resultados classificados. Se o objeto indicador não existir mais quando você recuperar a próxima página de resultados, os resultados começarão com o item mais próximo ao indicador, que depende da ordem de classificação especificada.

Os parâmetros avançados de paginação são descritos na tabela a seguir.

Parâmetro Descrição
Bookmarkindex Especifica a posição nos resultados em que os resultados exibidos começam. O valor desse parâmetro é um índice baseado em 1 nos resultados totais. Se o valor for menor ou igual a zero, a primeira página completa de resultados será retornada. Se o valor for definido como Int.MaxValue, a última página completa dos resultados será retornada.
Você não pode usar esse parâmetro com o parâmetro BookmarkObject .
Bookmarkobject Especifica o objeto nos resultados em que os resultados exibidos começam. Se você especificar um objeto de indicador, esse objeto será usado como o ponto para iniciar a pesquisa. As linhas antes ou depois desse objeto (dependendo do valor do parâmetro SearchForward ) são recuperadas.
Você não pode usar esse parâmetro com o parâmetro BookmarkIndex .
Includebookmark Especifica se deve incluir o objeto indicador nos resultados. Os valores válidos são:
$true: o objeto indicador está incluído nos resultados. Esse é o valor padrão.
$false: o objeto indicador não está incluído nos resultados. Use esse valor quando executar uma consulta para um tamanho de resultado limitado e especifique o último item como o indicador para a próxima consulta. Isso impede que o objeto indicador seja incluído em ambos os resultados.
Resultsize Especifica o número de resultados a serem exibidos por página. Se você não especificar um valor, o tamanho padrão do resultado de 1.000 objetos será usado. O Exchange limita os resultados a 250.000.
ReturnPageInfo Este é um parâmetro oculto. Ele retorna informações sobre o número total de resultados e o índice do primeiro objeto da página atual. O valor padrão é $false.
Searchforward Especifica a direção da pesquisa.
Indicador especificado: pesquise para frente ou para trás nos resultados relativos ao índice de indicador ou objeto.
Nenhum indicador especificado: pesquise para frente ou para trás nos resultados do primeiro ou último item nos resultados.
Os valores válidos são:
$true: pesquise no primeiro item nos resultados ou no indicador especificado. Se não houver resultados além do indicador, a consulta retornará a última página completa dos resultados. Esse é o valor padrão.
$false: pesquise para trás do último item nos resultados ou do indicador especificado. Se houver menos de uma página inteira de resultados além do indicador, a consulta retornará a primeira página completa de resultados.
SortOrder Especifica as propriedades da mensagem que controlam a ordem de classificação dos resultados. A ordem em que as propriedades são especificadas indica uma ordem de precedência decrescente (os resultados são classificados pela primeira propriedade, em seguida, esses resultados são classificados pela segunda propriedade e son on).
Esse parâmetro usa a sintaxe: <+|-><Property1>,<+|-><Property2>..., em que + classifica a propriedade em ordem crescente e - classifica a propriedade em ordem decrescente.
Se você não usar esse parâmetro, os resultados serão classificados pela propriedade Identity em ordem crescente.

Este exemplo mostra como usar os parâmetros avançados de paginação em uma consulta. O comando retorna as primeiras 500 mensagens no servidor especificado. Os resultados são classificados primeiro em ordem crescente por endereço do remetente e, em seguida, em ordem decrescente pelo tamanho da mensagem.

Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size

Este exemplo retorna as primeiras 500 mensagens no servidor especificado na ordem de classificação especificada, define um objeto indicador, exclui o objeto indicador dos resultados e recupera as próximas 500 mensagens na mesma ordem de classificação.

  1. Execute o comando a seguir para recuperar a primeira página de resultados.

    $Results=Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size

  2. Para definir o objeto indicador, execute o comando a seguir para salvar o último elemento da primeira página em uma variável.

    $Temp=$Results[$results.length-1]

  3. Para recuperar os próximos 500 objetos no servidor especificado e excluir o objeto indicador, execute o comando a seguir.

    Get-Message -Server mailbox01.contoso.com -BookmarkObject:$Temp -IncludeBookmark $false -ResultSize 500 -SortOrder +FromAddress,-Size