Get-Queue

Artigo
09/30/2014

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-08-29

Use o cmdlet Get-Queue para exibir as informações de configuração para filas em um computador em que a função de servidor Transporte de Hub ou de Transporte de Borda esteja instalada.

Sintaxe

Get-Queue [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-Filter <String>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-Server <ServerIdParameter>] [-SortOrder <SortOrderEntry[]>]

Get-Queue [-Identity <QueueIdentity>] [-BookmarkIndex <Int32>] [-BookmarkObject <QueueInfo>] [-IncludeBookmark <$true | $false>] [-ResultSize <Unlimited>] [-ReturnPageInfo <$true | $false>] [-SearchForward <$true | $false>] [-SortOrder <SortOrderEntry[]>]

Descrição detalhada

O cmdlet Get-Queue exibe informações sobre filas existentes em um servidor de Transporte de Hub ou de Transporte de Borda. Se você não fornecer parâmetros, o comando consultará todas as filas no servidor local e retornará uma única página de resultados. O tamanho de página padrão é de 1.000 objetos. Você pode exibir filas em um servidor remoto incluindo o nome do servidor como parte do parâmetro Identity ou usando o parâmetro Server com uma consulta de filtro. Os conjuntos de parâmetros Identity e Filter são mutuamente exclusivos.

Para executar o cmdlet Get-Queue, você deve usar uma conta à qual esteja delegado o seguinte:

Função Administradores do Exchange Server

Para executar o cmdlet Get-Queue em um computador em que a função de servidor Transporte de Borda esteja instalada, você deve fazer logon usando uma conta que seja membro do grupo Administradores local no mesmo computador.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro	Necessário	Tipo	Descrição
BookmarkIndex	Opcional	System.Int32	Use o parâmetro BookmarkIndex para especificar a posição de início dos resultados exibidos no conjunto de resultados. O valor deste parâmetro é um índice baseado em 1 no conjunto de resultados total. BookmarkIndex não pode ser usado com o parâmetro BookmarkObject.
BookmarkObject	Opcional	Microsoft.Exchange.Data.QueueViewer.QueueInfo	Use o parâmetro BookmarkObject para especificar o objeto no conjunto de resultados em que os resultados exibidos começam. BookmarkObject não pode ser usado com o parâmetro BookmarkIndex.
Filter	Opcional	System.String	O parâmetro Filter requer uma expressão que especifica os critérios de valor da propriedade das filas a serem exibidas. A expressão inclui um nome de propriedade que é seguido de um operador de comparação e um valor. As seguintes propriedades de filas são critérios válidos para o parâmetro Filter: DeliveryType O tipo de entrega desta fila, conforme definido pelo transporte. O tipo de entrega pode ser um dos seguintes valores: DNSConnectorDelivery NonSMTPGatewayDelivery SmartHostConnectorDelivery SmtpRelayWithinAdSitetoEdge MapiDelivery SmtpRelayWithinAdSite SmtpRelaytoRemoteAdSite SmtpRelaytoTiRg Indefinido Inacessível Identity Insira a identidade da fila no formato Servidor\destino, em que destino é o nome de um domínio remoto, de um servidor de caixas de correio ou de uma fila persistente. LastError Uma cadeia de caracteres de texto que representa o último erro registrado para uma fila. LastRetryTime A hora da última tentativa de uma conexão para esta fila. MessageCount O número de itens na fila. NextHopConnector A GUID do conector usado para criar a fila. NextHopDomain O domínio do próximo salto da fila, especificado como um domínio SMTP, um nome de servidor, o nome de um site do Active Directory ou um identificador de banco de dados de mensagens (MDB). NextRetryTime A hora da próxima tentativa de conexão para esta fila. Status O status da fila. As opções de status da fila são Ativo, Pronto, Repetir ou Suspenso. Você pode especificar diversos critérios por meio do operador de comparação -and. Os valores de propriedades que não são expressos como um número inteiro devem ficar entre aspas.
Identity	Opcional	Microsoft.Exchange.Data.QueueViewer.QueueIdentity	Use o parâmetro Identity para especificar a identidade da fila que contém as mensagens que deseja exibir. Insira a identidade da fila no formato Servidor\destino, onde destino é um domínio remoto, um servidor de caixas de correio ou um nome de fila persistente.
IncludeBookmark	Opcional	System.Boolean	Use o parâmetro IncludeBookmark para especificar se deseja incluir o objeto indicador quando os resultados da consulta forem exibidos. O parâmetro IncludeBookmark é válido quando for usado com o parâmetro BookmarkObject ou BookmarkIndex. Se você não especificar um valor para o parâmetro IncludeBookmark, será usado o valor padrão `$true`.
ResultSize	Opcional	Microsoft.Exchange.Data.Unlimited	Use o parâmetro ResultSize para especificar o número total de itens a serem exibidos no painel de resultados. O valor padrão do parâmetro ResultSize é definido como 1.000. ResultSize dá suporte a um número ilimitado de resultados, mas Microsoft Exchange limita o conjunto de resultados a 250.000.
ReturnPageInfo	Opcional	System.Boolean	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`.
SearchForward	Opcional	System.Boolean	Use o parâmetro SearchForward para especificar se deseja 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.
Server	Opcional	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Use o parâmetro Server para especificar o nome do servidor ao qual se conectar por meio de uma chamada de procedimento remoto (RPC) que contenha as filas das mensagens que você deseja exibir. Insira o nome do servidor como um nome de host ou um nome de domínio totalmente qualificado (FQDN). Se o parâmetro Server não for usado, será consultado o servidor local.
SortOrder	Opcional	Microsoft.Exchange.Configuration.Tasks.SortOrderEntry[]	Use o parâmetro SortOrder para especificar uma matriz de propriedades de mensagens usadas para controlar a ordem de classificação do conjunto de resultados. Separe cada propriedade por vírgula. Acrescente um símbolo + ao início do nome da propriedade para exibir os resultados na ordem crescente. Acrescente um símbolo - ao início do nome da propriedade para exibir os resultados em ordem decrescente. Se você não especificar uma ordem de classificação, o conjunto de resultados será exibido em ordem crescente por QueueIdentity.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exemplo

O exemplo a seguir mostra três comandos Get-Queue. O primeiro comando mostra como exibir as informações de configuração para todas as filas no servidor de Transporte de Hub ou de Transporte de Edge em que o comando é executado. O comando é comunicado por pipe ao comando Format-List para formatar os resultados como uma lista detalhada.

O segundo comando mostra como exibir as informações de configuração somente para filas que contêm mais de 100 mensagens.

O terceiro comando mostra como exibir as informações de configuração para uma fila existente em um servidor remoto.

Para obter mais informações sobre pipeline, consulte Pipelining.

Para obter mais informações sobre como trabalhar com a saída de um comando, consulte Trabalhando com saída do comando.

Para obter mais informações sobre como usar o Shell de Gerenciamento do Exchange para executar tarefas do visualizador de filas, consulte Usando o Shell de Gerenciamento do Exchange para gerenciar filas.

Get-Queue | format-list
Get-Queue -Filter {MessageCount -gt 100}
Get-Queue -Identity Server1\contoso.com

Compartilhar via