Retry-Queue
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2008-03-11
Командлет 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>]]
Подробное описание
Командлет Retry-Queue позволяет принудительно выполнить попытку подключения для очереди, имеющей состояние повтора. Эта команда устанавливает подключение со следующим транзитным сервером при наличии такой возможности. Если подключение запланировано, эта команда устанавливает в качестве времени повтора попытки доставки очереди текущее время, после чего предпринимается попытка установить подключение. Если подключение не установлено, задается новое время повтора. Можно указать, чтобы содержимое очереди было повторно направлено в классификатор, применив параметр Resubmit. Эту команду можно использовать для повтора попытки доставить сообщения, находящиеся в очереди «Недоступные», однако в этом случае необходимо использовать параметр Resubmit.
Если параметру Resubmit присвоено значение $false, командлет Retry-Queue выполняет новую попытку подключения. Если параметру Resubmit присвоено значение $false, сообщения в очереди сообщений повторно отправляются классификатору.
.gif "note") Примечание. |
|---|
Параметру Resubmit можно присвоить значение $true, только когда удаленная очередь находится в состоянии повторения попытки подключения. |
Необходимо использовать параметр Identity или Filter. Наборы параметров Identity и Filter исключают друг друга. Можно повторить попытку выполнить очередь на удаленном сервере, включив имя этого сервера как часть параметра Identity, либо используя параметр Server с запросом фильтра. Если сервер не указан, данная команда выполняется только на локальном сервере.
Для выполнения командлета Retry-Queue используемой учетной записи необходимо делегировать следующее:
- роль администратора сервера Exchange и членство в локальной группе администраторов на целевом сервере.
Чтобы выполнить командлет Retry-Queue на компьютере с установленной ролью пограничного транспортного сервера, необходимо войти в систему с учетной записью, принадлежащей локальной группе администраторов на этом компьютере.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования сервера Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
Filter |
Обязательный |
System.String |
Для параметра Filter требуется выражение, которое определяет критерии значений свойств для очередей, выполнение которых нужно повторить. Это выражение включает имя свойства, за которым следует оператор сравнения и значение. Допустимыми критериями свойства для параметра Filter являются следующие свойства очереди:
Можно указать несколько критериев с использованием оператора сравнения -and. Значения свойств, которые не выражены в виде целого числа, могут заключаться в кавычки. |
Identity |
Обязательный |
Microsoft.Exchange.Data.QueueViewer.QueueIdentity |
С помощью параметра Identity можно указать идентификатор очереди, содержащей сообщения, для которых нужно повторить попытку доставки. Идентификатор очереди вводится в виде сервер\назначение, где в части назначение указывается удаленный домен, почтовый сервер или постоянное имя очереди. |
Confirm |
Необязательный |
System.Management.Automation.SwitchParameter |
Параметр Confirm используется для приостановки команды и требует подтверждения выполняемого ею действия. Указывать значение параметра Confirm не требуется. |
Resubmit |
Необязательный |
System.Boolean |
С помощью параметра Resubmit можно указать, следует ли повторно предоставить содержимое очереди в классификатор перед установкой подключения. Присвойте параметру Resubmit значение |
Server |
Необязательный |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
С помощью параметра Server можно указать имя сервера, к которому будет выполнено подключение с использованием удаленного вызова процедуры (RPC), содержащего очередь с сообщениями, для которых нужно повторить попытку доставки. Имя сервера вводится в виде имени хоста или полного доменного имени (FQDN). Если этот параметр не используется, запрос направляется локальному серверу. |
WhatIf |
Необязательный |
System.Management.Automation.SwitchParameter |
При использовании параметра WhatIf команда имитирует действия над объектом, которые она будет выполнять. Параметр WhatIf позволяет узнать, какие изменения произойдут, не применяя их. Указывать значение параметра WhatIf не требуется. |
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
Исключения
| Исключения | Описание |
|---|---|
|
|
Пример
В следующем ниже примере показано, как принудительно инициировать попытку установить подключение для всех очередей, отвечающих следующим требованиям:
Эти очереди содержат сообщения для заданного домена.
Очереди имеют состояние «Retry».
Очереди находятся на сервере, на котором выполняется данная команда.
Дополнительные сведения об использовании среды управления Exchange для выполнения задач просмотра очереди см. в разделе Использование среды управления Exchange для управления очередями.
Retry-Queue -Filter {NextHopDomain -eq "contoso.com" -and Status -eq "retry"}