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

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

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

Синтаксис

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

Параметры

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

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) сообщения. Допустимыми записями 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 указывает имя сервера, к которому будет выполнено подключение с помощью удаленного вызова процедуры, содержащего очереди с сообщениями, доставку которых нужно приостановить. Имя сервера вводится в виде имени хоста или полного доменного имени (FQDN). Если этот параметр не используется, запрос направляется на локальный сервер.

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

Примеры

ПРИМЕР 1

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

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

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

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