Командлет Resume-Messagee (окончательная первоначальная версия)

 

Применимо к: Exchange Server 2007

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

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

Синтаксис

Resume-Message -Identity <MessageIdentity>

Resume-Message -Filter <String> [-Server <ServerIdParameter>]

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

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

Необходимо использовать параметр Identity или параметр Filter. Эти два параметра являются взаимоисключающими.

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

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

Чтобы выполнить командлет Resume-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.   Свойство SCL задает уровень вероятности нежелательной почты сообщения. Допустимыми значениями SCL являются целые числа в диапазоне от 0 до 9. Отсутствие значения свойства SCL свидетельствует о том, что сообщение не было обработано агентом фильтра содержимого. Size.   Размер сообщения. SourceIP.   IP-адрес внешнего сервера, который доставил сообщение в организацию Exchange. Status.   Текущее состояние сообщения. Возможные варианты состояния сообщения: «Active», «Retry», «Suspended», «PendingSuspend» и «PendingRemove». Subject.   Текстовая строка, представляющая тему сообщения электронной почты. Данное значение извлекается из поля Subject:. С помощью оператора сравнения -and можно задать несколько критериев фильтра. Значения свойств, не выраженные в виде одиночного целочисленного значения, должны заключаться в кавычки.
Идентификатор	Обязательность	Microsoft.Exchange.Data.QueueViewer.MessageIdentity	Параметр Identity служит для задания целого числа MessageIdentity. Это целое число представляет определенное сообщение и (необязательно) удостоверение сервера и очереди. Этот параметр может иметь следующий синтаксис: сервер\удостоверение_очереди\удостоверение_сообщения удостоверение_очереди\удостоверение_сообщения сервер\*\удостоверение_сообщения удостоверение_сообщения
Server (сервер)	Дополнительно	Microsoft.Exchange.Configuration.Tasks.ServerIdParameter	Параметр Server задает название сервера для подключения с использованием удаленного вызова процедур (RPC), на котором располагаются очереди, содержащие возобновляемые сообщения. Введите параметр Server как имя сервера или полное имя домена (FQDN). Если этот параметр не используется, выполняется запрос на локальном сервере.

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

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

Ошибки

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

Исключения

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

Пример

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

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

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

• Срок действия сообщений закончится до 15:00 в день, соответствующий указанной дате.

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

Resume-Message -Filter {FromAddress -eq "sender@contoso.com" -and ExpirationTime -lt "yyyy-mm-dd 03:00:00 PM"}