Командлет Suspend-Queue используется для остановки исходящих действий в отношении очереди на компьютере, на котором установлена роль транспортного сервера-концентратора или роль пограничного транспортного сервера.

Синтаксис

Suspend-Queue -Identity <QueueIdentity>

Suspend-Queue -Filter <String> [-Server <ServerIdParameter>]

Параметры

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

Filter

Обязательность

System.String

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

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

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • Не определено

    • Недостижимо

  • Identity.   Введите удостоверение очереди в форме сервер\адресат, где адресат — это удаленный домен, почтовый сервер или постоянное название очереди.

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

  • LastRetryTime.   Время последней попытки подключения для данной очереди.

  • MessageCount.   Число элементов в очереди.

  • NextHopConnector.   Идентификатор GUID соединителя, который использовался для создания очереди.

  • NextHopDomain.   Следующий домен перехода для очереди, указанный как удаленный домен SMTP, имя сервера, название сайта Active Directory или код базы данных сообщений (MDB).

  • NextRetryTime.   Время следующей попытки подключения для данной очереди.

  • Status.   Состояние очереди. Возможные значения состояния очереди: «Active», «Ready», «Retry» или «Suspended».

С помощью оператора сравнения - and можно задать несколько критериев. Значения свойств, не выраженные в виде целого числа, должны заключаться в кавычки.

Идентификатор

Обязательность

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

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

Server (сервер)

Дополнительно

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

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

Командлет Suspend-Queue останавливает исходящие действия в отношении очереди, которая имеет состояние «Active» или «Retry». Сообщения, которые доставляются через SMTP-отправку, завершат операции. Никакие дополнительные сообщения не покидают очередь. Когда указывается параметр «Identity», очередь приостанавливается, если идентификатор соответствует только одной очереди. Если удостоверение соответствует нескольким очередям, возвращается ошибка. Чтобы приостановить несколько очередей за одну операцию, следует использовать фильтр.

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

Для выполнения командлета Suspend-Queue используемой учетной записи необходимо делегировать следующие полномочия:

  • роль администратора сервера Exchange Server и членство в локальной группе администраторов на целевом сервере.

Чтобы выполнить команду Suspend-Queue на компьютере, на котором установлена роль пограничного транспортного сервера, следует войти в систему под учетной записью, входящей в локальную группу «Администраторы» на данном компьютере.

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

В следующем примере показаны две команды Suspend-Queue. Первая команда приостанавливает исходящие действия для всех очередей, содержащих сообщения для доставки в указанный домен и имеющих в текущий момент состояние «Retry».

Вторая команда выполняет подключение к удаленному серверу с помощью удаленного вызова процедуры, а также приостанавливает все очереди, содержащие более 100 сообщений в одной очереди.

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

Копировать код 
Suspend-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}
Suspend-Queue -Server ExchSrv1.contoso.com -Filter {MessageCount -gt 100}