Remove-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 Remove-Message para excluir uma mensagem de uma fila em um computador em que as funções de servidor Transporte de Hub ou Transporte de Borda estejam instaladas.

Sintaxe

Remove-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]

Remove-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]] [-WithNDR <$true | $false>]

Descrição detalhada

O cmdlet Remove-Message exclui uma ou mais mensagens que estejam em uma fila de um servidor de Transporte de Hub ou de Transporte de Borda. Uma mensagem que esteja sendo transmitida para diversos destinatários pode estar localizada em diversas filas. Se você especificar um parâmetro Identity, a mensagem será removida de um única fila se a identidade corresponder somente a uma única mensagem. Se a identidade corresponder a mais de uma mensagem, você receberá um erro. Para remover uma mensagem de mais de uma fila em uma única operação, use um filtro. Se você tentar remover uma mensagem que está sendo entregue no momento, o status da mensagem será alterado para PendingDelete. A entrega da mensagem não será interrompida, mas se o envio da mensagem falhar e ela entrar novamente na fila, então ela será removida.

Use um parâmetro Identity ou um parâmetro Filter. Esses dois conjuntos de parâmetros são mutuamente exclusivos.

Para executar o cmdlet Remove-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 Remove-Message em um computador em que a função de servidor Transporte de Borda esteja instalada, faça logon usando 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(s)	Tipo	Descrição
Filter	Necessário(s)	System.String	O parâmetro Filter requer uma expressão que especifica os critérios do valor da propriedade para mensagens que você deseja remover. 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: DateReceived   A data em que a mensagem foi recebida. ExpirationTime   A hora em que uma mensagem irá expirar. FromAddress   O endereço SMTP do remetente de uma mensagem. Esse valor é obtido de MAIL FROM: no envelope da mensagem. Identity   Um número inteiro que representa uma determinada mensagem e uma identidade opcional de servidor e fila. InternetMessageId   O valor do campo de cabeçalho Message-ID:. Esta propriedade é expressa como uma GUID seguida do endereço SMTP de um servidor remetente, como neste exemplo: 67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com. LastError   Uma cadeia de caracteres de texto que representa o último erro registrado para uma mensagem. MessageSourceName   Uma cadeia de caracteres de texto que representa o nome do componente que enviou esta mensagem para a fila. Queue   Especifica a identidade da fila que contém a mensagem. 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. RetryCount   O número de tentativas de entrega de uma mensagem para um destino. SCL   A propriedade SCL especifica o nível de confiança de spam da mensagem. Entradas SCL válidas são números inteiros de 0 a 9. Um valor de propriedade SCL vazio indica que a mensagem não foi processada pelo agente de Filtro de Conteúdo. Size   O tamanho de uma mensagem. SourceIP   O endereço IP do servidor externo que enviou a mensagem para a organização do Exchange. Status   O status atual da mensagem. As opções de status da mensagem são Active, Retry, Suspended, PendingSuspend e PendingRemove. Subject   Uma cadeia de caracteres de texto que representa o assunto do email. O valor é obtido do campo de cabeçalho Subject:. 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: Server\QueueIdentity\MessageIdentity QueueIdentity\MessageIdentity Server\*\MessageIdentity MessageIdentity
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 remover. Insira o parâmetro 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.
WithNDR	Opcional	System.Boolean	Use o parâmetro WithNDR para especificar se uma notificação de falha na entrega é retornada ao remetente da mensagem. O comportamento padrão deste parâmetro é definido como $true. Esse parâmetro pode ser usado tanto com o parâmetro Identity e o conjunto de parâmetrosFilter.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

O exemplo a seguir mostra como remover todas as mensagens que correspondem aos seguintes critérios:

• 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.

O exemplo a seguir mostra como suprimir a notificação de falha na entrega.

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.

Remove-Message -Filter {FromAddress -eq "sender@contoso.com"} -withNDR $false