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


Suspend-Message

 

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

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

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

Синтаксис

Suspend-Message -Identity <MessageIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Suspend-Message -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

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

Командлет Suspend-Message позволяет предотвратить доставку одного или нескольких сообщений, находящихся в очереди на компьютере с установленной ролью транспортного сервера-концентратора или пограничного транспортного сервера. Если сообщение уже находится в процессе доставки, то его доставку приостановить нельзя. Доставка будет продолжена, а сообщение перейдет в состояние «PendingSuspend». Если доставка не удалась, сообщение будет повторно поставлено в очередь, а затем его доставка будет приостановлена. Отправку сообщения, которое находится в очереди передачи или в очереди подозрительных сообщений, приостановить нельзя.

Сообщение, которое отправляется нескольким адресатам, может быть расположено в нескольких очередях. Если указан параметр Identity, сообщение будет приостановлено в одной очереди, если этот идентификатор соответствует только одному сообщению. Если идентификатор соответствует нескольким сообщениям, будет выведено сообщение об ошибке. Чтобы приостановить отправку сообщения в нескольких очередях в одной операции, необходимо применить фильтр. Требуется использовать параметр Identity или Filter. Эти два параметра — взаимоисключаемые.

Можно приостановить доставку сообщения на удаленном сервере, включив имя этого сервера как часть параметра Identity либо используя параметр Server с параметром Filter. Если сервер не указан, эта команда выполняется только на локальном сервере.

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

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

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

Параметры

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

Filter

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

System.String

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

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

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

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

  • Identity — целое число, которое указывает на отдельное сообщение, а также дополнительный идентификатор сервера и очереди.

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

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

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

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

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

  • 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, которое включает отдельное сообщение, а также (необязательно) идентификатор сервера и очереди. Этот параметр имеет следующий синтаксис:

  • Server\QueueIdentity\MessageIdentity

  • QueueIdentity\MessageIdentity

  • Server\*\MessageIdentity

  • MessageIdentity

Confirm

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

System.Management.Automation.SwitchParameter

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

Server

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

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

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

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

Suspend-Message -Filter {FromAddress -eq "sender@contoso.com"}