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