Suspend-Message
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 Suspend-Message para impedir a entrega de uma determinada mensagem em uma fila em um computador em que a função de servidor Transporte de Hub ou Transporte de Borda esteja instalada.
Sintaxe
Suspend-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Suspend-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
O cmdlet Suspend-Message impede a entrega de uma ou mais mensagens que estejam em uma fila no servidor de Transporte de Hub ou no servidor de Transporte de Borda. Uma mensagem que já esteja em entrega não será suspensa. A entrega continuará e o status da mensagem será PendingSuspend. Se a entrega falhar, a mensagem retornará à fila e, então, será suspensa. Você não pode suspender uma mensagem que esteja na fila Envio ou na fila de mensagens suspeitas.
Uma mensagem que esteja sendo enviada para diversos destinatários pode estar localizada em diversas filas. Se você especificar um parâmetro Identity, a mensagem será suspensa em uma única fila, se essa identidade corresponder a apenas uma mensagem. Se a identidade corresponder a mais de uma mensagem, você receberá um erro. Para suspender uma mensagem em mais de uma fila em uma única operação, use um filtro. Use um parâmetro Identity ou um parâmetro Filter. Esses dois conjuntos de parâmetros são mutuamente exclusivos.
Você pode suspender uma mensagem em um servidor remoto ao incluir o nome do servidor como parte do parâmetro Identity ou ao usar o parâmetro Server com o parâmetro Filter. Se você não especificar um servidor, o comando será executado somente em relação ao servidor local.
Para executar o cmdlet Suspend-Message, você deve usar uma conta à qual esteja delegada a função Administrador do Exchange Server e o grupo Administradores local do servidor de destino.
Para executar o cmdlet Suspend-Message em um computador em que a função de servidor Transporte de Borda esteja instalada, você deve efetuar logon com uma conta que seja membro do grupo Administradores local nesse 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(s) | Tipo | Descrição |
|---|---|---|---|
Filter |
Necessário(s) |
System.String |
O parâmetro Filter requer uma expressão que especifique os critérios de valor da propriedade para as mensagens que você deseja suspender. A expressão inclui um nome de propriedade que é seguido de um operador de comparação e um valor. As seguintes propriedades da mensagem são critérios válidos para o parâmetro Filter:
Você pode especificar diversos critérios de filtragem por meio do operador de comparação -and. Os valores de propriedades que não são expressos como um único número inteiro devem ficar entre aspas. |
Identity |
Necessário(s) |
Microsoft.Exchange.Data.QueueViewer.MessageIdentity |
Use o parâmetro Identity para especificar o inteiro MessageIdentity que representa uma determinada mensagem e uma identidade de fila e servidor opcional. A sintaxe deste parâmetro é a seguinte:
|
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 usando uma RPC (chamada de procedimento remoto) que contenha as filas das mensagens que você deseja suspender. Insira o nome do Server 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 evitar a entrega de todas as mensagens para as quais as seguintes condições sejam verdadeiras:
As mensagens são enviadas do endereço SMTP do remetente especificado.
As mensagens são enfileiradas no servidor de Transporte de Hub ou no servidor de Transporte de Borda em que o comando é 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.
Suspend-Message -Filter {FromAddress -eq "sender@contoso.com"}