Применимо к: Exchange Server 2010 SP1
Последнее изменение раздела: 2011-03-19
Командлет 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>]
|
Параметры
Параметр | Обязательность | Тип | Описание |
---|---|---|---|
Filter |
Обязательный |
System.String |
Значением параметра Filter должно быть выражение, которое задает критерии значений свойств для сообщений, подлежащих удалению. Это выражение включает в себя имя свойства, за которым следует оператор сравнения и значение. Следующие свойства сообщения — примеры допустимых критериев для параметра Filter:
С помощью оператора сравнения and можно задать несколько критериев фильтра. Значения свойств, не выраженные в виде одиночного целого числа, должны заключаться в кавычки ("). |
Identity |
Обязательный |
Microsoft.Exchange.Data.QueueViewer.MessageIdentity |
Параметр Identity задает целое число MessageIdentity, которое представляет собой отдельное сообщение, а также дополнительный идентификатор сервера и очереди. Этот параметр может иметь следующий синтаксис:
|
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
|
Server |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Параметр Server задает имя сервера для подключения с использованием удаленного вызова процедур (RPC), на котором располагаются очереди, содержащие удаляемые сообщения. Введите параметр Server как имя сервера или полное имя домена (FQDN). Если этот параметр не используется, запрос направляется на локальный сервер. |
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
|
WithNDR |
Необязательный |
System.Boolean |
Параметр WithNDR указывает, возвращается ли отправителю
сообщения отчет о недоставке. По умолчанию значение равно
|
Подробное описание
Командлет Remove-Message удаляет одно или несколько сообщений, находящихся в очереди на транспортном сервере-концентраторе или пограничном транспортном сервере. Сообщение, передаваемое нескольким получателям, может находиться в нескольких очередях. Если задан параметр Identity, сообщение удаляется из единой очереди, если данный идентификатор соответствует только одному сообщению. Если идентификатор соответствует более чем одному сообщению, возвращается ошибка. Чтобы удалить сообщение из нескольких очередей за одну операцию, следует использовать параметр Filter. При попытке удалить доставляемое в данный момент сообщение его состояние изменяется на PendingDelete. Доставка сообщения не прерывается, но если во время доставки происходит сбой, в результате которого сообщение повторно заносится в очередь, оно будет затем удалено.
Запись «Очереди» в разделе Разрешения транспорта.
Примеры
ПРИМЕР 1
В этом примере удаляются все сообщения, отвечающие следующему критерию, без создания отчетов о недоставке.
- Сообщения, отправленные отправителем Kweku@contoso.com.
- Сообщения поставлены в очередь на сервере Server1.
Скопировать код | |
---|---|
Remove-Message -Server Server1 -Filter {FromAddress -eq "Kweku@contoso.com"} -WithNDR $false |