Поделиться через


Командлет Remove-Message (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

Последнее изменение раздела: 2007-06-08

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

Синтаксис

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

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

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

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

Необходимо использовать параметр Identity или параметр Filter. Эти два параметра являются взаимоисключающими.

Для выполнения командлета Remove-Message используемой учетной записи необходимо делегировать роль администратора сервера Exchange и членство в локальной группе администраторов на целевом сервере.

Чтобы выполнить командлет Remove-Message на компьютере, на котором установлена роль пограничного транспортного сервера, необходимо войти в систему с учетной записью, входящей в локальную группу администраторов на этом компьютере.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Параметры

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

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 можно задать несколько критериев фильтра. Значения свойств, не выраженные в виде одиночного целочисленного значения, должны заключаться в кавычки.

Идентификатор

Обязательность

Microsoft.Exchange.Data.QueueViewer.MessageIdentity

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

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

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

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

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

Server (сервер)

Дополнительно

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

WithNDR

Дополнительно

System.Boolean

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

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

Исключения

Исключения Описание

Пример

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

  • Эти сообщения отправляются с указанного SMTP-адреса отправителя.

  • Сообщения занесены в очередь на транспортном сервере-концентраторе или пограничном транспортном сервере, на котором выполнена команда.

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

Дополнительные сведения об использовании среды управления Exchange для выполнения задач просмотра очереди см. в разделе Использование среды управления Exchange для управления очередями.

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