Compartilhar via

Resume-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 Resume-Queue para reiniciar atividades de saída de uma fila suspensa em um computador em que a função de servidor Transporte de Hub ou Transporte de Borda esteja instalada.

Sintaxe

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

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

Descrição detalhada

O cmdlet Resume-Queue reinicia as atividades de saída em uma fila que tenha um status de Suspenso. Se você especificar um parâmetro Identity, a fila será continuada se essa identidade corresponder somente a uma única fila. Se a identidade corresponder a mais de uma fila, você receberá um erro. Para continuar mais de uma fila em uma única operação você deve usar 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 continuar 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 Resume-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 Resume-Queue em um computador em que a função de servidor Transporte de Borda esteja instalada, faça logon com uma conta que seja membro do grupo Administradores local no 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 da propriedade das filas a serem continuadas. 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

    • SmartHostConnetorDelivery

    • 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 que deseja continuar. 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 por meio de uma chamada de procedimento remoto (RPC) que contenha as filas de mensagens que você deseja continuar. 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 como ligar a um servidor remoto com o RPC e continuar atividades de todas as filas em que o NextHopDomain é Fourthcoffee.com.

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.

Resume-Queue -Server ExchSrv1.contoso.com -Filter {NextHopDomain -eq "Fourthcoffee.com"}