Get-Queue

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

Use o cmdlet Get-Queue para exibir as informações de configuração para as filas nos servidores de Caixa de Correio e Transporte de Borda.

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

Syntax

Get-Queue
   [[-Identity] <QueueIdentity>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleQueueInfo>]
   [-Exclude <QueueViewerIncludesAndExcludes>]
   [-Include <QueueViewerIncludesAndExcludes>]
   [-IncludeBookmark <Boolean>]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<CommonParameters>]
Get-Queue
   [-Server <ServerIdParameter>]
   [-Filter <String>]
   [-BookmarkIndex <Int32>]
   [-BookmarkObject <ExtensibleQueueInfo>]
   [-Exclude <QueueViewerIncludesAndExcludes>]
   [-Include <QueueViewerIncludesAndExcludes>]
   [-IncludeBookmark <Boolean>]
   [-ResultSize <Unlimited>]
   [-ReturnPageInfo <Boolean>]
   [-SearchForward <Boolean>]
   [-SortOrder <QueueViewerSortOrderEntry[]>]
   [<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.

Examples

Exemplo 1

Get-Queue | Format-List

Este exemplo mostra informações detalhadas para todas as filas no servidor de Caixa de Correio no qual o comando é executado.

Exemplo 2

Get-Queue -Filter "MessageCount -gt 100"

Este exemplo lista as filas que contenham mais de 100 mensagens.

Exemplo 3

Get-Queue Server1\contoso.com | Format-List

Este exemplo mostra informações detalhadas para uma fila específica que existe no servidor de Caixa de Correio chamado Server1.

Exemplo 4

Get-Queue -Exclude Internal

Este exemplo lista apenas as filas externas.

Parameters

-BookmarkIndex

O parâmetro BookmarkIndex especifica a posição no conjunto de resultados, no local de início dos resultados exibidos. O valor deste parâmetro é um índice baseado em 1 no conjunto de resultados total. O parâmetro BookmarkIndex não pode ser usado com o parâmetro BookmarkObject.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-BookmarkObject

O parâmetro BookmarkObject especifica o objeto no conjunto de resultados, no local de início dos resultados exibidos. O parâmetro BookmarkObject não pode ser usado com o parâmetro BookmarkIndex.

Type:ExtensibleQueueInfo
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Excluir

O parâmetro Exclude especifica os tipos de filas que você deseja excluir dos resultados. Os valores válidos para esse parâmetro são:

  • Interno

  • Externo

  • Uma valor DeliveryType de fila válido. Para obter detalhes, consulte a seção NextHopSolutionKey em filas e mensagens em filas.

Type:QueueViewerIncludesAndExcludes
Position:Named
Default value:None
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 com o uso da sintaxe de filtro OPath. O filtro OPath inclui um nome de propriedade de fila seguido por um operador de comparação e um valor (por exemplo, "NextHopDomain -eq 'contoso.com'" ). Para obter detalhes sobre propriedades de fila filtradas e operadores de comparação, consulte Queue Properties in Exchange Server e Find Queues and messages in the Exchange Management Shell.

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identity

O parâmetro Identity especifica a fila. A entrada válida para esse parâmetro usa a fila de sintaxe ou fila do servidor \ , por exemplo, Mailbox01 \ contoso.com ou inacessível. Para obter detalhes sobre a identidade da fila, consulte Queue Identity.

Type:QueueIdentity
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-IncludeBookmark

O parâmetro IncludeBookmark especifica se é necessário incluir o objeto indicador, quando os resultados da consulta são exibidos. O parâmetro IncludeBookmark é válido quando usado com os parâmetros BookmarkObject ou BookmarkIndex. Caso você não especifique um valor para o parâmetro IncludeBookmark, será usado o valor padrão de $true.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Incluir

O parâmetro Include especifica os tipos de filas que você deseja incluir nos resultados. Os valores válidos para esse parâmetro são:

  • Interno

  • Externo

  • Uma valor DeliveryType de fila válido. Para obter detalhes, consulte a seção NextHopSolutionKey em filas e mensagens em filas.

Type:QueueViewerIncludesAndExcludes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Resultados

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ReturnPageInfo

O parâmetro ReturnPageInfo é oculto. Use-o para retornar informações sobre o número total de resultados e o índice do primeiro objeto da página atual. O valor padrão é $false.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-SearchForward

O parâmetro SearchForward especifica se devemos pesquisar para frente ou para trás no conjunto de resultados. O valor padrão é $true. Este valor faz com que a página de resultados seja calculada para frente a partir do início do conjunto de resultados ou a partir de um indicador, caso seja fornecido.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Server

O parâmetro Server especifica o servidor Exchange onde você deseja executar este comando. O parâmetro MailboxServer especifica o servidor da Caixa de Correio do exExchange2k16 ou exExchange2k13 que você quer testar. Esse parâmetro identifica o servidor back-end que aceita conexões com proxy do servidor front-end em que os clientes se conectam.

  • Nome

  • FQDN

  • FQDN

  • DN (nome diferenciado)

DN Herdado do Exchange

Use o parâmetro Server e o parâmetro Filter no mesmo comando. Não é possível usar o parâmetro Server e o parâmetro Identity no mesmo comando.

Type:ServerIdParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-SortOrder

O parâmetro SortOrder especifica uma matriz de propriedades de mensagem usadas para controlar a ordem de classificação do conjunto de resultados. Separe cada propriedade por vírgula. Acrescente um sinal de mais (+) ao início do nome da propriedade para exibir os resultados na ordem crescente. Acrescente um sinal de menos (-) ao início do nome da propriedade para exibir os resultados na ordem decrescente.

Se você não especificar uma ordem de classificação, o conjunto de resultados será exibido em ordem crescente por QueueIdentity.

Type:QueueViewerSortOrderEntry[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Inputs

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.

Outputs

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.