Suspend-Queue

  • Статья

 

Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

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

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

Синтаксис

Suspend-Queue -Identity <QueueIdentity> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Suspend-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

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

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

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

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

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

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

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

Параметры

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

Filter

Обязательный

System.String

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

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

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • Undefined

    • Unreachable

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

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

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

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

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

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

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

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

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

Identity

Обязательный

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

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

Confirm

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

System.Management.Automation.SwitchParameter

Параметр Confirm используется для приостановки команды и требует подтверждения ее выполнения. Значение параметра Confirm указывать не требуется.

Server

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

Параметр WhatIf заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf можно просматривать изменения, которые могли бы произойти, без применения этих изменений. Указывать значение параметра WhatIf не требуется.

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

В следующем примере показаны две команды 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}