Exportar (0) Imprimir
Expandir Tudo
Expandir Minimizar

Suspend-Queue

 

Aplicável a: Exchange Server 2013

Tópico modificado em: 2014-03-05

Este cmdlet está disponível somente no Exchange Server 2013 local.

Use o cmdlet Suspend-Queue para parar o processamento de uma fila em um servidor de Caixa de Correio ou em um servidor de Transporte de Borda.

Suspend-Queue -Identity <QueueIdentity> <COMMON PARAMETERS>
Suspend-Queue -Filter <String> [-Server <ServerIdParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Este exemplo suspende o processamento em todas as filas que mantêm mensagens para entrega no domínio contoso.com e que atualmente tenham um status Retry.

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

Este exemplo suspende o processamento em todas as filas do servidor Server1.contoso com mais de 100 mensagens na fila.

Suspend-Queue -Server Server1.contoso.com -Filter {MessageCount -gt 100}

O cmdlet Suspend-Queue para o processamento em uma fila com um status Ativo ou Tentar Novamente. As mensagens processadas são entregues, mas nenhuma mensagem adicional deixa a fila. Quando você usa o parâmetro Identity, a fila só será suspensa se a identidade corresponder 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, você deve usar o parâmetro Filter.

Para obter instruções sobre como retomar filas suspensas, consulte Resume-Queue.

Para executar esse cmdlet, você precisa ter permissões. Embora todos os parâmetros para este cmdlet estejam listados neste tópico, talvez você não tenha acesso a alguns parâmetros, caso eles não estejam incluídos nas permissões atribuídas a você. Para ver de que permissões você precisa, consulte o Entrada "Filas" no tópico Permissões de fluxo de email.

 

Parâmetro Necessário Tipo Descrição

Filter

Necessário

System.String

O parâmetro Filter especifica uma ou mais filas com o uso da sintaxe de filtro OPath. O filtro OPath inclui um nome de propriedade de fila seguido de um operador de comparação e de um valor, por exemplo, {NextHopDomain -eq "contoso.com"}. Para obter detalhes sobre propriedades de fila filtráveis e operadores de comparação, consulte Filtros de filas e Usar o Shell de Gerenciamento do Exchange para gerenciar filas.

Você pode especificar diversos critérios por meio do operador de comparação and. Os valores de propriedade não expressos como um inteiro devem ficar entre aspas (").

Identity

Necessário

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

O parâmetro Identity especifica a fila. A entrada válida para este parâmetro utiliza a sintaxe Server\Queue ou Queue, por exemplo, Mailbox01\contoso.com ou Unreachable. Para obter detalhes sobre identidade da fila, consulte a seção "Identidade da fila" em Usar o Shell de Gerenciamento do Exchange para gerenciar filas.

Confirm

Opcional

System.Management.Automation.SwitchParameter

A opção Confirm pode ser usada para suprimir o prompt de confirmação exibido por padrão quando esse cmdlet é executado. Para suprimir o prompt de confirmação, use a sintaxe -Confirm:$False. Você deve incluir dois-pontos ( : ) na sintaxe.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Server especifica o servidor Exchange no qual você deseja executar esse comando. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

  • Nome

  • FQDN

  • Nome diferenciado (DN)

  • Exchange Legacy DN

Se você não usar o parâmetro Server, o comando será executado no servidor local.

Você pode usar o parâmetro Server e o parâmetro Filter no mesmo comando. Não é possível usar o parâmetro Server e o parâmetro Identity no mesmo comando.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

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

Para ver os tipos de entrada que este cmdlet aceita, consulte Tipos de Entrada e Saída de Cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, é porque o cmdlet não aceita dados de entrada.

Para ver os tipos de retorno, também conhecidos como tipos de saida, que este cmdlet aceita, consulte Tipos de Entrada e Saída de Cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.

 
Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft