Командлет Retry-Queue используется для принудительного вызова попытки подключения для очереди на компьютере с установленной ролью транспортного сервера-концентратора или пограничного транспортного сервера.

Синтаксис

Retry-Queue -Identity <QueueIdentity> [-Resubmit <$true | $false>]
Retry-Queue -Filter <String> [-Resubmit <$true | $false>] [-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 можно указать идентификатор очереди, содержащей сообщения, для которых нужно повторить попытку доставки. Введите удостоверение очереди в форме сервер\адресат, где адресат представляет удаленный домен, почтовый сервер или постоянное название очереди.

Resubmit

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

System.Boolean

С помощью параметра Resubmit можно указать, следует ли повторно предоставить содержимое очереди в классификатор перед установкой подключения. Присвойте параметру Resubmit значение $false, чтобы выполнить новую попытку подключения. Присвойте параметру Resubmit значение $false , чтобы повторно отправить находящиеся в очереди сообщения классификатору.

Server (сервер)

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

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

Командлет Retry-Queue позволяет принудительно выполнить попытку подключения для очереди, имеющей состояние повтора. Эта команда устанавливает подключение со следующим транзитным сервером при наличии такой возможности. Если подключение запланировано, эта команда устанавливает в качестве времени повтора попытки доставки очереди текущее время, после чего предпринимается попытка установить подключение. Если подключение не установлено, задается новое время повтора. Можно указать, чтобы содержимое очереди было повторно направлено в классификатор, применив параметр Resubmit. Эту команду можно использовать для повтора попытки доставить сообщения, находящиеся в очереди «Недоступные», однако в этом случае необходимо использовать параметр Resubmit.

Если параметру Resubmit присвоено значение $false, командлет Retry-Queue выполняет новую попытку подключения. Если параметру Resubmit присвоено значение $false, сообщения в очереди сообщений повторно отправляются классификатору.

Примечание.
Параметру Resubmit можно присвоить значение $true, только когда удаленная очередь находится в состоянии повторения попытки подключения.

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

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

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

Чтобы выполнить командлет Retry-Queue на компьютере с установленной ролью пограничного транспортного сервера, необходимо войти в систему с учетной записью, принадлежащей локальной группе администраторов на этом компьютере.

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

  • Эти очереди содержат сообщения для заданного домена.

  • Очереди имеют состояние «Retry».

  • Очереди находятся на сервере, на котором выполняется данная команда.

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

Копировать код
Retry-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}