Retry-Queue
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:
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 |
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"}