Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
APLICA-SE A:
2016 2019 Subscription Edition
Tal como nas versões anteriores do Exchange, pode utilizar a Shell de Gestão do Exchange no Exchange Server para ver informações sobre filas e mensagens e utilizar essas informações para tomar medidas em filas e mensagens. Normalmente, um Exchange ativo contém um grande número de filas e mensagens a serem entregues, pelo que é importante compreender como identificar as filas ou mensagens que pretende gerir.
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 visualização de filas e mensagens na Shell de Gestão do Exchange suportam mais propriedades filtráveis e opções de filtro 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 Edge (o serviço transporte). Para obter mais informações sobre filas e mensagens em filas, consulte Filas e mensagens nas filas.
Parâmetros de filtragem de fila
A tabela seguinte resume os parâmetros de filtragem que estão disponíveis nos cmdlets de gestão de filas.
| Cmdlet | Parâmetros de filtragem | Comments |
|---|---|---|
| Get-Queue |
Excluir Filtro Identity Include Servidor |
Pode utilizar os parâmetros Incluir e Excluir com os outros parâmetros de filtragem no mesmo comando. Não pode utilizar os parâmetros Identidade e Filtro no mesmo comando. O parâmetro Servidor especifica o servidor onde pretende executar o comando. Não pode utilizar os parâmetros Servidor e Identidade no mesmo comando, mas pode utilizar o parâmetro Servidor com os outros parâmetros de filtragem no mesmo comando. |
|
Resume-Queue Retry-Queue Suspend-Queue |
Identity Filtro Servidor |
Não pode utilizar o parâmetro Identidade com os outros parâmetros de filtragem no mesmo comando. O parâmetro Servidor especifica o servidor onde pretende executar o comando. Pode utilizar os parâmetros Servidor e Filtro no mesmo comando. |
| Get-QueueDigest |
Dag Filtro Floresta Servidor Site |
Tem de utilizar um dos parâmetros Dag, Site, Server ou Forest , mas não pode utilizá-los em conjunto no mesmo comando. Pode utilizar o parâmetro Filter com qualquer um dos outros parâmetros de filtragem. |
Identidade da fila
O parâmetro Identidade utiliza asintaxe básica Fila> do Servidor<\ ><. Normalmente, este valor identifica exclusivamente a fila, pelo que não pode utilizar outros parâmetros de filtragem com o parâmetro Identidade . A exceção é o cmdlet Get-Queue , onde pode utilizar os parâmetros Incluir e Excluir com o parâmetro Identidade .
A tabela seguinte explica a sintaxe do parâmetro Identidade nos cmdlets de gestão de filas.
| Valor do parâmetro de identidade | Descrição |
|---|---|
<Server>\<PersistentQueueName> ou <PersistentQueueName> |
Uma fila persistente no servidor especificado ou local. <PersistentQueueName> é Submission, Unreachableou Poison. Para obter mais informações sobre filas persistentes, veja Tipos de filas. |
<Server>\<NextHopDomain> ou <NextHopDomain> |
Uma fila de entrega no servidor especificado ou local. <NextHopDomain> é o nome da fila do valor da propriedade NextHopDomain da fila. Por exemplo, o espaço de endereços de um conector Enviar, o nome de um site do Active Directory ou o nome de um DAG. Para obter mais informações, veja NextHopSolutionKey. |
<Server>\<QueueInteger> ou <QueueInteger> |
Uma fila de entrega no servidor especificado ou local. <QueueInteger> é o valor inteiro exclusivo atribuído a uma fila de entrega ou a uma fila sombra na base de dados de fila. No entanto, tem de executar o cmdlet Get-Queue para encontrar este valor nas propriedades Identity ou QueueIdentity . |
<Server>\Shadow\<QueueInteger> ou Shadow\<QueueInteger> |
Uma fila sombra no servidor especificado ou local. Para obter mais informações sobre as filas sombra e a redundância sombra, veja Redundância de sombras no Exchange Server. |
<Server>\* ou * |
Todas as filas no servidor especificado ou local. Nota: a identidade é um parâmetro posicional, o que significa que 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
Pode utilizar o parâmetro Filter em todos os cmdlets de gestão 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 cumprem os critérios de filtro. Pode utilizar o operador -and lógico para especificar várias condições para a correspondência. Eis um exemplo genérico da sintaxe:
Get-Queue -Filter "<Property1> -<ComparisonOperator> '<Value1>' -and <Property2> -<ComparisonOperator> '<Value2>'..."
Para obter uma lista completa das propriedades da fila que pode utilizar com o parâmetro Filter , veja Propriedades da fila.
Para obter uma lista de operadores de comparação que pode utilizar com o parâmetro Filtro , veja a secção Operadores de comparação a utilizar ao filtrar filas ou mensagens neste tópico.
Para obter exemplos de procedimentos que utilizam o parâmetro Filter para ver e gerir filas, veja Procedimentos para filas.
Incluir e Excluir parâmetros no Get-Queue
Pode utilizar os parâmetros Incluir e Excluir no cmdlet Get-Queue sozinhos, com cada othe ou com os outros parâmetros de filtragem para ajustar os seus resultados. Por exemplo, você pode:
Excluir filas vazias.
Excluir filas para destinos externos.
Inclua filas que tenham um valor específico de DeliveryType.
Os parâmetros Incluir e Excluir utilizam as seguintes propriedades de fila para filtrar filas:
| Valor | Descrição | Exemplo |
|---|---|---|
DeliveryType |
Inclui ou exclui filas com base na propriedade DeliveryType que define a forma como a mensagem será transmitida para o salto seguinte. Os valores válidos são descritos em NextHopSolutionKey. Vários valores, separados por vírgulas, podem ser especificados. |
Devolve todas as filas de entrega no servidor local onde o próximo salto é um conector Enviar que está alojado no servidor local e está configurado para encaminhamento de anfitriões inteligentes. Get-Queue -Include SmartHostConnectorDelivery |
Empty |
Inclui ou exclui filas vazias. As filas vazias têm o valor 0 na propriedade MessageCount . |
Devolve 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 . As filas externas têm sempre um dos seguintes valores para DeliveryType:
Para obter mais informações, veja NextHopSolutionKey. |
Devolve todas as filas internas no servidor local. Get-Queue -Exclude External |
Internal |
Este valor inclui ou exclui filas que têm o valor Internal na propriedade NextHopCategory . Tenha em atenção que uma mensagem para um destinatário externo pode necessitar de vários saltos internos antes de chegar a um servidor de gateway onde é entregue externamente. |
Devolve todas as filas internas no servidor local. Get-Queue -Include Internal |
Tenha em atenção que pode duplicar a funcionalidade dos parâmetros Incluir e Excluir com o parâmetro Filter . Por exemplo, os seguintes comandos produzem o mesmo resultado:
Get-Queue -Exclude EmptyGet-Queue -Filter "MessageCount -gt 0"
No entanto, como pode ver, a sintaxe dos parâmetros Incluir e Excluir é mais simples e fácil de memorizar.
Get-QueueDigest
O cmdlet Get-QueueDigest permite-lhe ver informações sobre algumas ou todas as filas na sua organização através de 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.
Tenha em atenção que as filas num servidor de Transporte Edge subscrito não estão incluídas nos resultados. Além disso, Get-QueueDigest está disponível num servidor de Transporte Edge, mas os resultados estão restritos a filas locais no servidor de Transporte edge.
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 seguinte descreve os parâmetros de filtragem e ordenação que estão disponíveis no cmdlet Get-QueueDigest .
| Parâmetro | Descrição |
|---|---|
| Dag, Server ou Site | Estes parâmetros são mutuamente exclusivos (não podem ser utilizados no mesmo comando) e definem o âmbito do cmdlet. Tem de especificar um destes parâmetros ou o comutador Floresta . Normalmente, utilizaria o nome do servidor, da DAG ou do site do Active Directory, mas pode utilizar qualquer valor que identifique exclusivamente o servidor, o DAG ou o site. Pode especificar vários servidores, DAGs ou sites separados por vírgulas. |
| Floresta | Este comutador é necessário se não estiver a utilizar os parâmetros Dag, Server ou Site . Não especifica um valor com este comutador. Ao utilizar este comutador, obtém filas de todos os servidores da Caixa de Correio do Exchange na floresta local do Active Directory. Não pode utilizar este comutador para ver filas em florestas remotas do Active Directory. |
| DetailsLevel |
Normal é o valor predefinido. As seguintes propriedades são devolvidas nos resultados:
* Estas propriedades estão reservadas para utilização interna da Microsoft e não são utilizadas em organizações do Exchange no local. Para obter mais informações sobre todas as propriedades nesta lista, veja Propriedades da fila. |
| Filtro | Filtre as filas com base nas propriedades da fila, conforme descrito na secção Filtrar parâmetros em cmdlets de fila . Pode utilizar qualquer uma das propriedades da fila filtráveis, conforme descrito no tópico Propriedades da fila . |
| GroupBy | Agrupa os resultados da fila. Pode agrupar os resultados por uma das seguintes propriedades:
Por predefinição, os resultados são agrupados por NextHopDomain. Para obter informações sobre estas propriedades de fila, veja Propriedades da fila. |
| ResultSize | Limita os resultados da fila ao valor que especificar. As filas são ordenadas por ordem descendente com base no número de mensagens na fila e agrupadas pelo valor especificado pelo parâmetro GroupBy . O valor padrão é 1000. Isto significa que, por predefinição, o comando apresenta as 1000 principais filas agrupadas por NextHopDomain e ordenadas pelas filas que contêm mais mensagens para as filas que contêm menos mensagens. |
| Timeout | O parâmetro especifica o número de segundos antes de a operação exceder o limite de tempo. O valor predefinido é 00:00:10 ou 10 segundos. |
Este exemplo devolve todas as filas externas não vazias nos servidores denominados Caixa de Correio01, Caixa de Correio02 e Caixa de Correio03.
Get-QueueDigest -Server Mailbox01,Mailbox02,Mailbox03 -Include External -Exclude Empty
Parâmetros de filtragem de mensagem
A tabela seguinte resume os parâmetros de filtragem que estão disponíveis nos cmdlets de gestão de mensagens.
| Cmdlet | Parâmetros de filtragem | Comments |
|---|---|---|
| Get-Message |
Filtro Identity Fila Servidor |
Não pode utilizar os parâmetros Filtro, Identidade ou Fila no mesmo comando. O parâmetro Servidor especifica o servidor onde pretende executar o comando. Pode utilizar os parâmetros Servidor e Filtro no mesmo comando. |
|
Remove-Message Resume-Message Suspend-Message |
Filtro Identity Servidor |
Tem de utilizar o parâmetro Identidade ou o parâmetro Filter , mas não pode utilizá-los no mesmo comando. O parâmetro Servidor especifica o servidor onde pretende executar o comando. Pode utilizar os parâmetros Servidor e Filtro no mesmo comando. |
| Redirect-Message | Servidor | Este cmdlet drena as mensagens ativas de todas as filas de entrega no servidor especificado, pelo que o Servidor é o único parâmetro de filtragem disponível. Para obter mais informações, veja Redirecionar mensagens em filas. |
| Export-Message | Identity | Este parâmetro não é realmente um filtro, porque identifica exclusivamente a mensagem. Para identificar várias mensagens para este cmdlet, utilize Get-Message e encaminhe os resultados para Export-Message. Para obter mais informações e exemplos, veja Exportar mensagens de filas. |
Identidade da mensagem
O parâmetro Identidade nos cmdlets de gestão de mensagens identifica exclusivamente uma mensagem numa ou mais filas, pelo que não pode utilizar outros parâmetros de filtragem de mensagens. O parâmetro Identity utiliza a sintaxe <Server>\<Queue>\<MessageInteger>básica .
A tabela seguinte descreve a sintaxe que pode utilizar com o parâmetro Identidade nos cmdlets de gestão de mensagens.
| **Valor do parâmetro de identidade | Descrição** |
|---|---|
<Server>\<Queue>\<MessageInteger> ou <Queue>\<MessageInteger> |
Uma mensagem numa fila específica no servidor especificado ou local.
|
<Server>\*\<MessageInteger>ou ou *\<MessageInteger><MessageInteger> |
Todas as cópias da mensagem em todas as filas na base de dados de fila no servidor especificado ou local. |
Parâmetro de filtro em cmdlets de mensagem
Pode utilizar o parâmetro Filter 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 cumprem os critérios de filtro. Pode utilizar o operador -and lógico para especificar várias condições para a correspondência. Eis um exemplo genérico da sintaxe:
Get-Message -Filter "<Property1> -<ComparisonOperator> '<Value1>' -and <Property2> -<ComparisonOperator> '<Value2>'..."
Para obter uma lista completa das propriedades da mensagem que pode utilizar com o parâmetro Filter , veja Propriedades da mensagem).
Para obter uma lista de operadores de comparação que pode utilizar com o parâmetro Filtro , veja a secção Operadores de comparação a utilizar ao filtrar filas ou mensagens neste tópico.
Para obter exemplos de procedimentos que utilizam o parâmetro Filter para ver e gerir mensagens, veja Procedimentos para mensagens em filas.
Parâmetro de fila
O parâmetro Fila está disponível apenas no cmdlet Get-Message . Pode utilizar este parâmetro para obter todas as mensagens numa fila específica ou todas as mensagens de várias filas com o caráter universal (*). Quando utilizar o parâmetro Fila , utilize o formato <Server>\<Queue> de identidade da fila, conforme descrito na secção Identidade da fila neste tópico.
Operadores de comparação para usar ao filtrar filas ou mensagens
Quando cria uma expressão de filtro de fila ou mensagem com o parâmetro Filter , tem de incluir um operador de comparação para que o valor da propriedade corresponda. Os operadores de comparação que pode utilizar e como cada operador funciona são descritos na tabela seguinte. 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 uma status de Repetição:Get-Queue -Filter "Status -eq 'Retry'" Mostrar todas as mensagens que têm uma status de Repetir: Get-Message -Filter "Status -eq 'Retry'" |
-ne |
Não corresponde ao valor especificado. | Mostrar todas as filas que não têm uma status do Active:Get-Queue -Filter "Status -ne 'Active'" Mostrar todas as mensagens que não têm um status de Ativo: Get-Message -Filter "Status -ne 'Active'" |
-gt |
Maior do que o número inteiro especificado ou o valor de data/hora. | Mostrar filas que contêm atualmente mais de 1000 mensagens:Get-Queue -Filter "MessageCount -gt 1000" Mostrar mensagens que têm atualmente uma contagem de repetições superior a 3: Get-Message -Filter "RetryCount -gt 3" |
-ge |
Maior ou igual ao valor inteiro ou data/hora especificado. | Mostrar filas que contêm atualmente 1000 ou mais mensagens:Get-Queue -Filter "MessageCount -ge 1000" Mostrar mensagens que têm atualmente uma contagem de repetições igual ou superior a 3: Get-Message -Filter "RetryCount -ge 3" |
-lt |
Menor do que o número inteiro especificado ou o valor de data/hora. | Mostrar filas que contêm atualmente menos de 1000 mensagens:Get-Queue -Filter "MessageCount -lt 1000" Mostrar mensagens com uma SCL inferior a 6: Get-Message -Filter "SCL -lt 6" |
-le |
Menor ou igual ao valor inteiro ou data/hora especificado. | Mostrar filas que contêm atualmente 1000 ou menos mensagens:Get-Queue -Filter "MessageCount -le 1000" Mostrar mensagens com uma SCL igual ou inferior a 6: Get-Message -Filter "SCL -le 6" |
-like |
Contém o texto especificado. Tem de incluir o caráter universal (*) na cadeia de texto. | Mostrar filas que tenham um destino para qualquer domínio SMTP que termine em Contoso.com:Get-Queue -Filter "Identity -like '*contoso.com'" Mostrar mensagens que têm um assunto que contém o texto "empréstimo de pagamento": Get-Message -Filter "Subject -like '*payday loan*'" |
Pode especificar um filtro que avalia múltiplas expressões com o operador -andlógico . As filas ou mensagens têm de corresponder a todas as condições de filtro a incluir 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 apresenta uma lista de mensagens que são enviadas a partir de qualquer endereço de e-mail no domínio contoso.com que têm um valor SCL superior a 5.
Get-Message -Filter "FromAddress -like '*Contoso.com*' -and SCL -gt 5"
Parâmetros de paginação avançados
Quando utiliza a Shell de Gestão do Exchange para ver filas e mensagens em filas, a consulta obtém uma página de informações de cada vez. Os parâmetros de paginação avançados controlam o tamanho dos resultados e a ordem em que os resultados são apresentados. Todos os parâmetros de paginação avançados são opcionais e podem ser utilizados 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 predefinição, quando especifica uma sequência de ordenação, a propriedade Identidade é sempre incluída e ordenada por ordem ascendente, porque as outras propriedades de fila ou mensagem disponíveis não são exclusivas.
Pode utilizar os parâmetros BookmarkIndex e BookmarkObject para marcar uma posição nos resultados ordenados. Se o objeto de marcador já não existir quando obter a página seguinte dos resultados, os resultados começam com o item mais próximo do marcador, que depende da sequência de ordenação que especificar.
Os parâmetros de paginação avançados estão descritos na tabela seguinte.
| Parâmetro | Descrição |
|---|---|
| BookmarkIndex | Especifica a posição nos resultados onde os resultados apresentados começam. O valor deste parâmetro é um índice baseado em 1 no total de resultados. Se o valor for menor ou igual a zero, é devolvida a primeira página completa dos resultados. Se o valor estiver definido como Int.MaxValue, é devolvida a última página completa dos resultados. Não pode utilizar este parâmetro com o parâmetro BookmarkObject . |
| BookmarkObject | Especifica o objeto nos resultados onde os resultados apresentados começam. Se especificar um objeto de marcador, esse objeto é utilizado como o ponto para iniciar a pesquisa. As linhas antes ou depois desse objeto (dependendo do valor do parâmetro SearchForward ) são obtidas. Não pode utilizar este parâmetro com o parâmetro BookmarkIndex . |
| IncludeBookmark | Especifica se pretende incluir o objeto de marcador nos resultados. Os valores válidos são:$true: o objeto de marcador está incluído nos resultados. Esse é o valor padrão. $false: o objeto de marcador não está incluído nos resultados. Utilize este valor quando executar uma consulta para um tamanho de resultado limitado e, em seguida, especifique o último item como o marcador da consulta seguinte. Isto impede que o objeto de marcador seja incluído em ambos os resultados. |
| ResultSize | Especifica o número de resultados a apresentar por página. Se não especificar um valor, é utilizado o tamanho de resultado predefinido de 1000 objetos. O Exchange limita os resultados a 250 000. |
| ReturnPageInfo | Este é um parâmetro oculto. Devolve 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. Marcador especificado: procure para a frente ou para trás nos resultados relativos ao índice ou objeto do marcador. Nenhum marcador especificado: procure para a frente ou para trás nos resultados do primeiro ou último item nos resultados. Os valores válidos são: $true: pesquise para a frente a partir do primeiro item nos resultados ou a partir do marcador especificado. Se não existirem resultados além do marcador, a consulta devolve a última página completa de resultados. Esse é o valor padrão. $false: pesquise para trás a partir do último item nos resultados ou a partir do marcador especificado. Se existir menos do que uma página completa de resultados para além do marcador, a consulta devolve a primeira página completa de resultados. |
| SortOrder | Especifica as propriedades da mensagem que controlam a sequência de ordenação dos resultados. A ordem pela qual as propriedades são especificadas indica uma ordem descendente de precedência (os resultados são ordenados pela primeira propriedade e, em seguida, esses resultados são ordenados pela segunda propriedade e por son on). Este parâmetro utiliza a sintaxe: <+|-><Property1>,<+|-><Property2>..., em que + ordena a propriedade por ordem ascendente e - ordena a propriedade por ordem descendente. Se não utilizar este parâmetro, os resultados são ordenados pela propriedade Identidade por ordem ascendente. |
Este exemplo mostra como utilizar os parâmetros de paginação avançados numa consulta. O comando devolve as primeiras 500 mensagens no servidor especificado. Os resultados são ordenados primeiro por ordem ascendente pelo endereço do remetente e, em seguida, por ordem descendente por tamanho da mensagem.
Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-Size
Este exemplo devolve as primeiras 500 mensagens no servidor especificado na sequência de ordenação especificada, define um objeto de marcador, exclui o objeto de marcador dos resultados e obtém as próximas 500 mensagens na mesma sequência de ordenação.
Execute o seguinte comando para obter a primeira página de resultados.
$Results=Get-Message -Server mailbox01.contoso.com -ResultSize 500 -SortOrder +FromAddress,-SizePara definir o objeto de marcador, execute o seguinte comando para guardar o último elemento da primeira página numa variável.
$Temp=$Results[$results.length-1]Para obter os 500 objetos seguintes no servidor especificado e para excluir o objeto de marcador, execute o seguinte comando.
Get-Message -Server mailbox01.contoso.com -BookmarkObject:$Temp -IncludeBookmark $false -ResultSize 500 -SortOrder +FromAddress,-Size