С помощью командлета 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 являются следующие свойства сообщения:
Можно указать несколько критериев фильтра с использованием оператора сравнения -and. Значения свойств, которые не выражены в виде одной цифры, должны заключаться в кавычки. |
Identity |
Обязательный |
Microsoft.Exchange.Data.QueueViewer.MessageIdentity |
С помощью параметра Identity можно указать значение MessageIdentity, которое включает отдельное сообщение, а также (необязательно) идентификатор сервера и очереди. Этот параметр имеет следующий синтаксис:
|
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Значение параметра Confirm указывать не требуется. |
Server |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
С помощью параметра Server можно указать имя сервера, к которому будет выполнено подключение с использованием удаленного вызова процедуры, содержащего очередь с сообщениями, доставку которых нужно приостановить. Введите имя server в виде имени узла или полного доменного имени. Если этот параметр не используется, запрос направляется локальному серверу. |
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется. |
Подробное описание
Командлет Suspend-Message позволяет предотвратить доставку одного или нескольких сообщений, находящихся в очереди на компьютере с установленной ролью транспортного сервера-концентратора или пограничного транспортного сервера. Если сообщение уже находится в процессе доставки, то его доставку приостановить нельзя. Доставка будет продолжена, а сообщение перейдет в состояние «PendingSuspend». Если доставка не удалась, сообщение будет повторно поставлено в очередь, а затем его доставка будет приостановлена. Отправку сообщения, которое находится в очереди передачи или в очереди подозрительных сообщений, приостановить нельзя.
Сообщение, которое отправляется нескольким адресатам, может быть расположено в нескольких очередях. Если указан параметр Identity, сообщение будет приостановлено в одной очереди, если этот идентификатор соответствует только одному сообщению. Если идентификатор соответствует нескольким сообщениям, будет выведено сообщение об ошибке. Чтобы приостановить отправку сообщения в нескольких очередях в одной операции, необходимо применить фильтр. Требуется использовать параметр Identity или Filter. Эти два параметра — взаимоисключаемые.
Можно приостановить доставку сообщения на удаленном сервере, включив имя этого сервера как часть параметра Identity либо используя параметр Server с параметром Filter. Если сервер не указан, эта команда выполняется только на локальном сервере.
Для выполнения командлета Suspend-Message используемой учетной записи необходимо делегировать роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.
Чтобы запустить командлет Suspend-Message на компьютере, на котором установлена роль пограничного транспортного сервера, необходимо войти в систему под учетной записью, принадлежащей локальной группе администраторов на этом компьютере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Типы входных данных
Типы возвращаемых данных
Ошибки
Ошибка | Описание |
---|---|
|
|
Исключения
Исключения | Описание |
---|---|
|
|
Пример
В следующем примере демонстрируется, как предотвратить доставку всех сообщений, отвечающих следующим условиям:
- Эти сообщения отправляются с указанного SMTP-адреса
отправителя.
- Сообщения поставлены в очередь на транспортном
сервере-концентраторе или пограничном транспортном сервере, на
котором выполняется данная команда.
Дополнительные сведения об использовании командной консоли Exchange для выполнения задач средства просмотра очереди см. в разделе Использование среды управления Exchange для управления очередями.
Копировать код | |
---|---|
Suspend-Message -Filter {FromAddress -eq "sender@contoso.com"} |