Compartilhar via

Suspend-Queue

  • Artigo

 

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

Tópico modificado em: 2007-06-28

Use o cmdlet Suspend-Queue para interromper as atividades de saída de uma fila em um computador com a função de servidor Transporte de Hub ou de Transporte de Borda instalada.

Sintaxe

Suspend-Queue -Identity <QueueIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Suspend-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cdmlet Suspend-Queue interrompe as atividades de saída em uma fila com um status Ativo ou Repetir. As mensagens que forem entregues por meio de SMTP-send terminarão as operações. Nenhuma mensagem adicional deixará a fila. Se você especificar um parâmetro Identity, a fila será suspensa se a identidade corresponder apenas a uma única fila. Se a identidade corresponder a mais de uma fila, você receberá um erro. Para suspender mais de uma fila em uma única operação, use um filtro.

Use um parâmetro Identity ou um parâmetro Filter. Os conjuntos de parâmetros Identity e Filter são mutuamente exclusivos. Você pode suspender uma fila 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. Se você não especificar um servidor, o comando será executado somente em relação ao servidor local.

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

  • Função de Administrador do Exchange Server e grupo Administradores local para o servidor de destino

Para executar o cmdlet Suspend-Queue em um computador com a função de servidor Transporte de Borda instalada, faça logon usando uma conta que seja membro do grupo Administradores local nesse 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

Filter

Necessário

System.String

O parâmetro Filter requer uma expressão que especifica os critérios de valor de propriedade para as filas a serem suspensas. 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

Necessário

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

Use o parâmetro Identity para especificar a identidade da fila que contém as mensagens a serem suspensas. 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.

Confirm

Opcional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Use o parâmetro Server para especificar o nome do servidor ao qual se conectar usando uma RPC (chamada de procedimento remoto) que contenha as filas das mensagens que você deseja suspender. Insira o nome do servidor como um nome de host ou um nome de domínio totalmente qualificado (FQDN). Se esse parâmetro não for usado, será consultado o servidor local.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O exemplo a seguir mostra dois comandos Suspend-Queue. O primeiro comando suspende atividades de saída em todas as filas que estão retendo mensagens para entrega no domínio especificado e que têm um status Repetir no momento.

O segundo comando liga a um servidor remoto usando o RPC e suspende todas as filas que têm mais de 100 mensagens.

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

Suspend-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}
Suspend-Queue -Server ExchSrv1.contoso.com -Filter {MessageCount -gt 100}