16.9.3 Объекты ExchangeLink и Exchange_Link

Объекты ExchangeLink и Exchange_Link для управления Exchange Server средствами WMI из скриптов VBScript, мониторинг и управление состоянием соединений

Эти объекты предназначены для одной и той же цели — получения информации и мониторинга состояния соединений между серверами Exchange Server, по которым передаются сообщения. В Exchange System Manager такие соединения называются очередями (queues). Их можно просмотреть под контейнером Servers (Серверы) | Имя_сервера | Queues (Очереди). Однако объект ExchangeLink представляет именно объект соединения между серверами. Для одного соединения между серверами может быть создано несколько очередей, для которых в WMI предусмотрены свои объекты — ExchangeQueue и Exchange_Queue.

Объекты ExchangeLink и Exchange_Link очень похожи. Главное отличие между ними заключается в том, что Exchange_Link — объект, который предназначен только для работы с Exchange Server 2003, и свойств и методов для него предусмотрено больше, чем для объекта ExchangeLink. Более старый объект ExchangeLink может использоваться как для работы с ExchangeServer 2003, так и с Exchange Server 2000.

Отметим еще один момент. Класс Exchange_Link напрямую использовать нельзя. Попытка получить экземпляры этого класса при помощи WQL-запроса приведет к тому, что вам вернется пустая коллекция. Связано это с тем, что класс Exchange_Link является базовым для классов Exchange_SMTPLink и Exchange_X400Link, которые предназначены для работы с соединениями SMTP и X4000 соответственно. Однако все свойства этих классов определяются на уровне базового класса, поэтому рассматривать в этом разделе мы будем именно базовый класс Exchange_Link. На уровне Exchange_SMTPLink и Exchange_X400Link добавляются только три метода:

Freeze() — "заморозить" соединение, остановив для него всякое взаимодействие.

Thaw() — "разморозить" соединение, вернув его в обычный режим.

ForceConnection() — принудительно установить соединение и попытаться передать сообщения все расписаний.

Для объекта ExchangeLink путь в иерархии классов WMI выглядит так:

\\COMPUTERNAME\ROOT\cimv2\applications\exchange:ExchangeLink

для Exchange_Link:

\\COMPUTERNAME\ROOT\MicrosoftExchangeV2:Exchange_Link

для объекта Exchange_SMTPLink:

\\COMPUTERNAME\ROOT\MicrosoftExchangeV2:Exchange_SMTPLink

для объекта Exchange_X400Link:

\\COMPUTERNAME\ROOT\MicrosoftExchangeV2:Exchange_X400Link

Ниже представлена информация о свойствах объекта Exchange_Link (некоторые из этих свойств будут недоступны для объекта ExchangeLink):

• ActionFreeze — позволяет определить, поддерживает ли данное соединение между серверами "заморозку" сообщений в очередях. Если очередь "заморозить", то Exchange Server откажется от попыток передать эти сообщения по назначению, пока очередь не будет "разморожена". Саму заморозку можно произвести при помощи команды Freeze (Заморозить) из контекстного меню для очереди в Exchange System Manager.
• Информацию свойства ActionFreeze можно получить и при помощи свойства SupportedLinkActions. Значению свойства ActionFreeze соответствует шестой бит возвращаемого свойством SupportedLinkActions значения.
• ActionKick — позволяет определить, предусмотрена ли в очередях данного соединения реакция на приказ немедленно приступить к отправке сообщений (вне расписания). В Exchange System Manager такому приказу соответствует команда Force Connection (Соединиться принудительно) из контекстного меню для очереди.
• Значению свойства ActionKick соответствует первый бит возвращаемого свойством SupportedLinkActions значения.
• ActionThaw — это свойство позволяет определить, поддерживает ли данное соединение "разморозку" сообщений в очередях (команда Unfreeze (Разморозить) в контекстном меню для очереди в Exchange System Manager).
• Значению свойства ActionThaw соответствует седьмой бит возвращаемого свойством SupportedLinkActions значения.
• ExtendedStateInfo — это свойство возвращает текстовое описание текущего состояния данного соединения.
• GlobalStop — это свойство, работающее с логическими значениями True и False, позволяет определить, в каком состоянии настоящее время находится соединение.
• IncreasingTime — это свойство возвращает целочисленное значение, которое означает количество секунд, в течение которого количество сообщений, стоящих в очереди на доставку для данного соединения, увеличивалось. Обычно это свойство используется для того, чтобы определить, сколько времени соединение не работало.
• LinkDN — это свойство возвращает отличительное имя (distinguished name) объекта коннектора в Active Directory, который создал данное соединение.
• LinkName — это свойство возвращает имя данного соединения;
• NextScheduledConnection — это свойство, которое работает с значениями типа datetime, позволяет получить информацию, когда согласно расписанию начнется следующая передача сообщений по данному соединению;
• NumberOfMessages — это свойство определяет общее количество сообщений, которое ожидает доставки в очередях для данного соединения;
• OldestMessage — это свойство, работающее со значениями datetime, позволяет получить информацию о том, в какое время поступило в очередь самое старое сообщение для данного соединения. Это свойство также может использоваться для выяснения времени, когда возникли проблемы с соединением;
• ProtocolName — это свойство возвращает имя протокола, используемого для данного соединения, в виде строкового значения;
• SizeOfQueue — это свойство возвращает информацию о совокупном размере всех сообщений, находящихся в очередях для данного соединения;
• StateActive — если это свойство возвращает значение True, это значит, что соединение в настоящий момент активно (то есть по нему происходит передача сообщений).
• Значению свойства StateActicve соответствует первый бит возвращаемого свойством StateFlags значения.
• StateFlags — это свойство возвращает битовую маску с информацией о состоянии соединения. Ту же самую информацию можно получить, воспользовавшись свойствами, имена которых начинаются на State... и Type...
• StateFrozen — если для этого свойства возвращается значение True, то соединение Exchange находится в замороженном состоянии.
• Значению свойства StateFrozen соответствует шестой бит возвращаемого свойством StateFlags значения.
• StateReady — если для этого свойства возвращается значение True, это соединение готово к приему новых сообщений. Этому свойству соответствует второй бит возвращаемого свойством StateFlags значения.
• StateRemote — если для этого свойства возвращается значение True, то сообщения этого соединения предназначены для доставки на удаленный сервер (а не в локальное хранилище). Этому свойству соответствует пятый бит возвращаемого свойством StateFlags значения.
• StateRetry — если для этого свойства возвращается значение True, это значит, что производится попытка повторной передачи сообщений для этого соединения (после неуспешной попытки). Этому свойству соответствует третий бит возвращаемого свойством StateFlags значения.
• StateScheduled — если для этого свойства возвращается значение True, то это значит, что данное соединение работает в соответствие с установленным расписанием (а не устанавливается немедленно при появлении в очереди новых сообщений). Этому свойству соответствует четвертый бит возвращаемого свойством StateFlags значения.
• SupportedLinkActions — это свойство возвращает битовую маску с информацией о командах, которые поддерживает данное соединение. Такую же информацию можно получить при помощи свойств, имя которых начинается на Action...
• TypeCurrentlyUnreachable — если для этого свойства возвращается значение True, то это значит, что в очередях для данного соединения находятся сообщения, которые не могут быть доставлены в настоящее время по причине того, что назначение для них недоступно. Этому свойству соответствует тринадцатый бит возвращаемого свойством StateFlags значения.
• TypeDeferredDelivery — если для этого свойства установлено значение True, то это значит, что в очередях для данного соединения находятся сообщения, которые ожидают команды на начало передачи. Этому свойству соответствует четырнадцатый бит возвращаемого свойством StateFlags значения.
• TypeInternal — если для этого свойства возвращается значение True, то это значит, что очереди данного соединения используются для внутренней обработки сообщений. Этому свойству соответствует пятнадцатый бит возвращаемого свойством StateFlags значения.
• TypeLocalDelivery — если для этого свойства возвращается значение True, то это значит, что очереди данного соединения используются для локальной доставки сообщений (в пределах одного сервера). Этому свойству соответствует десятый бит возвращаемого свойством StateFlags значения.
• TypePendingCategorization — если для этого свойства возвращается значение True, то это значит, что очереди этого соединения используются для сообщений, которые ожидают категоризации (то есть проверки адресов получателя по Active Directory и отнесения сообщения к определенной категории). Этому свойству соответствует двенадцатый бит возвращаемого свойством StateFlags значения.
• TypePendingRouting — если для этого свойства возвращается значение True, то это значит, что очереди этого соединения используются для сообщений, которые ожидают расчета маршрута доставки. Этому свойству соответствует одиннадцатый бит возвращаемого свойством StateFlags значения.
• TypePendingSubmission — если для этого свойства возвращается значение True, то это значит, что очереди этого соединения используются для сообщений, которые еще не были переданы ядру маршрутизации (routing engine) для расчета маршрута доставки. Этому свойству соответствует шестнадцатый бит возвращаемого свойством StateFlags значения.
• TypeRemoteDelivery — если для этого свойства возвращается значение True, то это значит, что очереди этого соединения используются передачи сообщений на удаленные серверы (в противоположность доставке на тот же самый сервер). Этому свойству соответствует девятый бит возвращаемого свойством StateFlags значения.
• Version — это свойство возвращает номер версии программного обеспечения, используемого для работы с соединением.
• VirtualMachine — это свойство возвращает имя виртуального компьютера (работающего в кластере или одиночного), на котором создан данный объект соединения.
• VirtualServerName — это свойство возвращает не имя, а номер виртуального компьютера, на котором работает данный объект соединения. Этот номер совпадает с атрибутом CN (Common Name) для объекта данного виртуального сервера в Active Directory.

Получить учебные материалы по этому курсу