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

Синтаксис

Retry-Queue -Identity <QueueIdentity> [-Confirm [<SwitchParameter>]] [-Resubmit <$true | $false>] [-WhatIf [<SwitchParameter>]]

Retry-Queue -Filter <String> [-Confirm [<SwitchParameter>]] [-Resubmit <$true | $false>] [-Server <ServerIdParameter>] [-WhatIf [<SwitchParameter>]]

Параметры

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

Filter

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

System.String

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

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

    • DNSConnectorDelivery

    • NonSMTPGatewayDelivery

    • SmartHostConnectorDelivery

    • SmtpRelayWithinAdSitetoEdge

    • MapiDelivery

    • SmtpRelayWithinAdSite

    • SmtpRelaytoRemoteAdSite

    • SmtpRelaytoTiRg

    • Undefined

    • Unreachable

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

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

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

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

  • NextHopConnector — Глобальный уникальный идентификатор соединителя, который использовался для создания этой очереди.

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

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

  • Status — состояние очереди. Доступны параметры состояния очереди «Active», «Ready», «Retry», «Suspended».

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

Identity

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

Microsoft.Exchange.Data.QueueViewer.QueueIdentity

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

Confirm

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

System.Management.Automation.SwitchParameter

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

Resubmit

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

System.Boolean

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

Server

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

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

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

WhatIf

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

System.Management.Automation.SwitchParameter

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

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

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

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

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

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

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

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

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

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

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

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

Ошибки

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

 

 

Исключения

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

 

 

Пример

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

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

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

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

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

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