Remove-Message

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

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

Командлет 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>]

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

Командлет 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.   Свойство вероятности нежелательной почты задает уровень вероятности нежелательной почты сообщения. Допустимыми значениями вероятности нежелательной почты являются целые числа в диапазоне от 0 до 9. Отсутствие значения свойства вероятности нежелательной почты свидетельствует о том, что сообщение не было обработано агентом фильтрации содержимого.

  • 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

Параметр Confirm используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется.

Server

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется.

WithNDR

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

System.Boolean

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

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

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

Ошибки

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

Исключения

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

Пример

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

  • Сообщения отправлены с SMTP-адреса заданного отправителя.

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

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

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

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