16.9.9 Класс Exchange_MessageTrackingEntry

Объект Exchange_MessageTrackingEntry для управления Exchange Server средствами WMI из скриптов VBScript, получение информации из журнала отслеживания сообщений Exchange Server

Класс Exchange_MessageTrackingEntry предназначен для работы с записями в журнале отслеживания сообщений. Конечно же, его можно использовать только тогда, когда на сервере Exchange Server включено протколирование прохождения сообщений в журнал (по умолчанию оно отключено). Обычно этот объект используется для составления отчетов по прохождению сообщений и для мониторинга событий, связанных с отправкой и получением сообщений сервером.

Та же самая информация может быть получена и стандартными средствами Excahneg System Manager (при помощи контейнера Tools (Сервис) | Message Tracking Center (Центр отслеживания сообщений), однако автоматизация работы с журналом может быть очень удобной при большом количестве сообщений или при необходимости непрерывного мониторинга журнала на предмет появлений событий определенного типа. Отметим также, что отчеты по журналу отслеживания сообщений можно создавать средствами генератора отчетов Crystal Reports (см. раздел Доделать!).

Класс Exchange_MessageTrackingEntry может использоваться и для Exchange Server 2000, и для Exchange Server 2003, однако при работе с Exchange Server 2003 свойств в нем предусмотрено больше. В этом разделе будут рассмотрены свойства этого класса, рассмотренные при работе с Exchange Server 2003.

Путь к этому классу в иерархии пространств имен WMI выглядит как

\\COMPUTERNAME\ROOT\MicrosoftExchangeV2:Exchange_MessageTrackingEntry

Ниже представлена информация о всех свойствах этого класса:

• AttemptedPartnerServer — это свойство возвращает информацию о сервере, которому, согласно записи в журнале протоколирования сообщений, была сделана попытка передать сообщение, однако такая попытка завершилась неудачей. Формат имени сервера может быть самым разным (в зависимости от события, которое описывается данной записью), например, именем NetBIOS, FQDN, отличтельным именем для объекта сервера в Active Directory и т.п.
• ClientIP — это свойство возвращает информацию об IP-адресе клиента, который изначально отправил данное сообщение. Если письмо было отправлено с самого сервера Exchange Server, то это свойство возвратит пустое строковое значение.
• ClientName — это свойство возвращает информацию об имени клиентского приложения, из которого было изначально отправлено это сообщение.
• Cost — это свойство возвращает значение, которое говорит об относительной стоимости отправки данного сообщения. Это значение рассчитывается относительно других сообщений. Более высокое значение для какого-то сообщения означает, что для его отправки пришлось использовать низкоскоростные соединения или промежуточные серверы.
• DeliveryTime — это свойство отображает время доставки (в секундах) для данного сообщения.
• Encrypted — если для этого свойства возвращается знчение True, то это значит, что сообщение, для которого была создана запись, было зашифровано перед отправкой.
• EntryType — это свойство возвращает информацию о типе записи в числовом виде, например, 1000 ("Message delivered locally", "Сообщение доставлено на локальном сервере") или 1020 ("SMTP: Started outbound transfer of message", "SMTP: начата передача исходящего сообщения"). Значений для этого свойства предусмотрено очень много. Это свойство обычно используется для фильтрации записей определенного типа.
• ExpansionDL — значение этого свойства предусмотрено только для операций расширения списка рассылки (когда одно сообщение, отправленное на список рассылки, превращается в множество сообщений на каждого получателя, входящего в этот список). Это свойство возвращает имя списка рассылки Exchange Server.
• KeyID — это свойство возвращает уникальный номер данной записи в журнале отслеживания сообщений. Выглядеть его значение может, например, так:

\\london3.nwtraders1.msft\LONDON3.log\20060811.log,338

• LinkedMessageID — это свойство возвращает информацию об новом идентификаторе, которое присваивается этому сообщению, когда его принимает сервер-партнер (определяемый свойством PartnerServer). Значение его может выглядеть, например, так:

c=RU;a= ;p=First Organizati;l=LONDON3-060811112238Z-1

• MessageID — уникальный идентификатор сообщения, который присваивается этому сообщению сервером Exchange Server. Выглядеть такой индентификатор может, например, так:

918F91BFA544C147B25002A6604601386E8B@www.askit.ru

• OriginationTime — это свойство возвращает информацию о времени, когда сообщение появилось на Exchange Server (то есть было принято от клиента или другого сервера, сгенерировано и т.п.). Обратите внимание: это свойство возвращает не локальное время, а время по Гринвичу!
• PartnerServer — это свойство возвращает имя сервера-партнера, то есть сервера, которому было передано сообщение. Формат имени сервера может быть самым разным (в зависимости от события, которое описывается данной записью), например, именем NetBIOS, FQDN, отличтельным именем для объекта сервера в Active Directory и т.п.
• Priority — это свойство возвращает числовое значение приоритета для данного сообщения. Для обычных сообщений, которым не был настроен какой-либо специальный приоритет, это свойство возвращает значение 0.
• RecipeintAddress — это свойство возвращает массив строковых значений с адресами получателей данного сообщения (под получателями подразумеваются все, кто был перечислен в полях To:, CC: и BCC: для данного письма, а если письмо было отправлено на список рассылки — все члены этого списка рассылки). При этом адреса для получателей Exchange передаются в формате отличительного имени объекта данного получателя в Active Directory, например

/O=FIRST ORGANIZATION/OU=FIRST ADMINISTRATIVE GROUP/CN=RECIPIENTS/CN=TestUser1

• RecipientCount — это свойство возвращает количество получателей для данного сообщения (количество элементов в массиве RecipientAddress).
• RecipientStatus — это свойство возвращает для каждого элемента массива RecipientStatus информацию о типе сообщения, которое было отправлено данному получателю, в виде числового значения. Для этого свойства могут использоваться следующие значения:
• 0 — получателю было отправлено обычное сообщение;
• 1 — получателю было отправлено сообщение о невозможности доставки его сообщения (NDR, non-deliverable response);
• 2 — получателю было отправлено подтверждение доставки (DR, delivery receipt);
• 3 — получателю было отправлено подтверждение о прочтении (RR, read receipt).
• SenderAddress — это свойство определяет адрес электронной почты отправителя почтового сообщения. Для значения этого свойства используется формат отличительного имени объекта данного отправителя в Active Directory, например:

EX:/O=FIRST ORGANIZATION/OU=FIRST ADMINISTRATIVE GROUP/CN=RECIPIENTS/CN={24735964-3725-4055-B562-31CF34D8BCA6}

• ServerIP — это свойство возвращает информацию об IP-адресе сервера Exchange Server, который использовался для отправки или получения сообщения в рамках данного события.
• ServerName — это свойство возвращает имя виртуального сервера, который использовался для отправки или получения сообщения в рамках данного события. Имя виртуального сервера возвращается в формате FQDN и может выглядеть, например, как london3.nwtraders.msft.
• Size — это свойство возвращает размер сообщения (включая все вложения), для которого была создана данная запись в журнале. Размер сообщения приводится в байтах.
• Subject — это свойство возвращает тему сообщения, для которого была создана данная запись в журнале. Тема сообщения будет возвращена только в том случае, если в свойствах сервера было включено протоколирование тем сообщений (флажок Enable Subject Logging and Dsiplay (Включить протоколирование и отображение темы) на вкладке General (Общие) свойств Exchange Server в Exchange System Manager).
• SubjectID — это свойство определяет индентификатор темы сообщения, который присваивается некоторыми клиентскими приложениями (в основном для отслеживания тем обсуждений для групп новостей). В большинстве случаев это свойство вернет пустое значение.
• TimeLogged — это свойство возвращает время создания данной записи в журнале. Время для этого свойства указывается по Гринвичу.
• Version — это свойство возвращает номер версии для службы, которая создала данную запись в журнале. В большинстве ситуаций это свойство остается пустым.

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