Применимо к: Exchange Server 2010 SP1

Последнее изменение раздела: 2011-03-19

Командлет Remove-Message служит для удаления сообщения из очереди на компьютере с установленной ролью транспортного сервера-концентратора или пограничного транспортного сервера.

Синтаксис

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

Параметры

Параметр Обязательность Тип Описание

Filter

Обязательный

System.String

Значением параметра Filter должно быть выражение, которое задает критерии значений свойств для сообщений, подлежащих удалению. Это выражение включает в себя имя свойства, за которым следует оператор сравнения и значение. Следующие свойства сообщения — примеры допустимых критериев для параметра Filter:

  • DateReceived   Дата получения сообщения.

  • ExpirationTime   Время окончания действия сообщения.

  • FromAddress   SMTP-адрес отправителя сообщения. Данное значение извлекается из поля MAIL FROM на конверте сообщения.

  • Identity   Целое число, представляющее определенное сообщение и, дополнительно, удостоверение сервера и очереди.

  • InternetMessageId — значение поля заголовка Message-ID. Значение этого свойства имеет вид идентификатора GUID, за которым следует SMTP-адрес сервера-отправителя, как в следующем примере: 67D7543D6103DC4FBEBA6BC7205DACABA61231@exchange.contoso.com.

  • LastError   Текстовая строка последней ошибки, записанной для сообщения.

  • MessageSourceName   Текстовая строка, содержащая название компонента, который занес это сообщение в очередь.

  • Queue   Идентификатор очереди, в которой находится сообщение. Идентификатор очереди вводится в виде Сервер\назначение, где в части назначение указывается удаленный домен, почтовый сервер или постоянное имя очереди.

  • RetryCount   Выполненное количество попыток доставки сообщения адресату.

  • SCL   Вероятность нежелательной почты (SCL) сообщения. Допустимыми значениями SCL являются целые числа в диапазоне от 0 до 9. Отсутствие значения свойства SCL свидетельствует о том, что сообщение не было обработано агентом фильтра содержимого.

  • Size   Размер сообщения.

  • SourceIP   IP-адрес внешнего сервера, который доставил сообщение в организацию Exchange.

  • Status   Текущее состояние сообщения. Возможные варианты состояния сообщения: «Active», «Retry», «Suspended», «PendingSuspend» и «PendingRemove».

  • Subject   Текстовая строка, представляющая тему сообщения. Данное значение извлекается из поля Subject.

С помощью оператора сравнения and можно задать несколько критериев фильтра. Значения свойств, не выраженные в виде одиночного целого числа, должны заключаться в кавычки (").

Identity

Обязательный

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

Параметр Identity задает целое число MessageIdentity, которое представляет собой отдельное сообщение, а также дополнительный идентификатор сервера и очереди. Этот параметр может иметь следующий синтаксис:

  • сервер\удостоверение_очереди\удостоверение_сообщения

  • удостоверение_очереди\удостоверение_сообщения

  • сервер\*\удостоверение_сообщения

  • удостоверение_сообщения

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Server

Необязательный

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Параметр Server задает имя сервера для подключения с использованием удаленного вызова процедур (RPC), на котором располагаются очереди, содержащие удаляемые сообщения. Введите параметр Server как имя сервера или полное имя домена (FQDN). Если этот параметр не используется, запрос направляется на локальный сервер.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

WithNDR

Необязательный

System.Boolean

Параметр WithNDR указывает, возвращается ли отправителю сообщения отчет о недоставке. По умолчанию значение равно $true. Этот параметр можно использовать с параметрами Identity и Filter.

Подробное описание

Командлет Remove-Message удаляет одно или несколько сообщений, находящихся в очереди на транспортном сервере-концентраторе или пограничном транспортном сервере. Сообщение, передаваемое нескольким получателям, может находиться в нескольких очередях. Если задан параметр Identity, сообщение удаляется из единой очереди, если данный идентификатор соответствует только одному сообщению. Если идентификатор соответствует более чем одному сообщению, возвращается ошибка. Чтобы удалить сообщение из нескольких очередей за одну операцию, следует использовать параметр Filter. При попытке удалить доставляемое в данный момент сообщение его состояние изменяется на PendingDelete. Доставка сообщения не прерывается, но если во время доставки происходит сбой, в результате которого сообщение повторно заносится в очередь, оно будет затем удалено.

 Запись «Очереди» в разделе Разрешения транспорта.

Примеры

ПРИМЕР 1

В этом примере удаляются все сообщения, отвечающие следующему критерию, без создания отчетов о недоставке.

  • Сообщения, отправленные отправителем Kweku@contoso.com.

  • Сообщения поставлены в очередь на сервере Server1.

Скопировать код
Remove-Message -Server Server1 -Filter {FromAddress -eq "Kweku@contoso.com"} -WithNDR $false