Resume-Message (RTM)

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-08

Use o cmdlet Resume-Message para permitir a entrega de uma mensagem anteriormente suspensa em uma fila de um computador com a função de servidor Transporte de Hub ou de Transporte de Borda instalada.

Sintaxe

Resume-Message -Identity <MessageIdentity>

Resume-Message -Filter <String> [-Server <ServerIdParameter>]

Descrição detalhada

O cmdlet Resume-Message permite a entrega de uma mensagem anteriormente suspensa que esteja em uma fila no servidor de Transporte de Hub ou de Transporte de Borda. 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á continuada em uma única fila se essa identidade corresponder somente a uma única mensagem. Se a identidade corresponder a mais de uma mensagem, você receberá um erro. Para continuar 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 continuar 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 Resume-Message, você deve usar uma conta à qual esteja delegada a função de Administrador do Exchange Server e o grupo Administradores local do servidor de destino.

Para executar o cmdlet Resume-Message 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 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	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 para as mensagens 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 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 do cabeçalho da mensagem, Message-ID:, localizado no cabeçalho da mensagem. 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 texto que representa o último erro registrado para uma mensagem. MessageSourceName   Uma cadeia 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 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	Microsoft.Exchange.Data.QueueViewer.MessageIdentity	Use o parâmetro Identity para especificar inteiro MessageIdentity. Este é um número inteiro que representa uma determinada mensagem e uma identidade opcional de servidor e fila. A sintaxe deste parâmetro é a seguinte: Server\QueueIdentity\MessageIdentity QueueIdentity\MessageIdentity Server\*\MessageIdentity MessageIdentity
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 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.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

O exemplo a seguir mostra como continuar a entrega de todas as mensagens que estavam em um estado suspenso e para as quais as seguintes condições são verdadeiras:

• As mensagens foram 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.

• As mensagens expirarão antes das 15 h na data especificada.

Para obter mais informações sobre como usar o Shell de Gerenciamento do Exchange para executar tarefas do visualizador de filas, consulte Usando o Shell de Gerenciamento do Exchange para gerenciar filas.

Resume-Message -Filter {FromAddress -eq "sender@contoso.com" -and ExpirationTime -lt "yyyy-mm-dd 03:00:00 PM"}