Compartilhar via

Retry-Queue

  • Artigo

 

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

Tópico modificado em: 2008-03-11

Use o cmdlet Retry-Queue para forçar uma tentativa de conexão de uma fila em um computador em que a função de servidor Transporte de Hub ou Transporte de Borda esteja instalada.

Sintaxe

Retry-Queue -Identity <QueueIdentity> [-Confirm [<SwitchParameter>]] [-Resubmit <$true | $false>] [-WhatIf [<SwitchParameter>]]

Retry-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Resubmit <$true | $false>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Retry-Queue força uma tentativa de conexão de uma fila que tenha um status de repetição. O comando estabelece uma conexão com o próximo salto, se for possível. Se uma conexão for programada, esse comando redefinirá o próximo horário de repetição de uma fila para o horário atual e será feita uma tentativa de conexão. Se uma conexão não for estabelecida, um novo horário para a repetição será definido. Você pode usar o parâmetro Resubmit para fazer com que o conteúdo da fila seja reenviado para o Categorizador. Você pode usar esse comando para repetir a entrega de mensagens que estão na fila de inacessíveis, mas você deve incluir o parâmetro Resubmit.

Se você definir o parâmetro Resubmit como $false, o cmdlet Retry-Queue forçará uma nova tentativa de conexão. Se você definir o parâmetro Resubmit como $false, as mensagens da fila serão reenviadas ao categorizador.

Dica

Você pode definir o parâmetro Resubmit como $true apenas quando o status da fila remota for Repetir.

Use um parâmetro Identity ou um parâmetro Filter. Os conjuntos de parâmetros Identity e Filter são mutuamente exclusivos. Você pode repetir uma fila em um servidor remoto incluindo o nome de 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 Retry-Queue, você deve usar uma 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 Retry-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 especifique os critérios de valor de propriedade para as filas que você deseja repetir. 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 que você deseja repetir. 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.

Resubmit

Opcional

System.Boolean

Use o parâmetro Resubmit para especificar se o conteúdo da fila deve ser reenviado para o categorizador antes que uma conexão seja estabelecida. Defina o parâmetro Resubmit como $false para forçar uma nova tentativa de conexão. Defina o parâmetro Resubmit como $false para reenviar mensagens da fila para o categorizador.

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 repetir. 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 forçar uma tentativa de conexão para todas as filas que atendam aos seguintes critérios:

  • As filas abrigam mensagens para o domínio especificado.

  • As filas têm o status Repetir.

  • As filas estão localizadas no servidor em que o comando foi executado.

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.

Retry-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}