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

Статья
09/30/2014

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

Последнее изменение раздела: 2008-03-11

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

Синтаксис

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

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

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

Командлет 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, см. в разделе Вопросы, связанные с разрешениями.

Параметры

Параметр	Обязательность	Тип	Описание
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».
Очереди находятся на сервере, на котором выполняется данная команда.

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

Retry-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}

Поделиться через