16.9.4 Объекты ExchangeQueue и Exchange_Queue

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

Объекты ExchangeQueue и Exchange_Queue предназначены для работы с очередями Exchange Server. Очередям в окне Queue Viewer (Просмотрщик очередей) соответствуют объекты ExchangeLink и Exchange_Link. Эти очереди состоят из так называемых динамических очередей, сводная информация которых представлена в Queue Viewer. Этим динамическим очередям и соответствуют объекты ExchangeQueue и Exchange_Queue. Можно сказать, что объект ExchangeLink (или Exchange_Link) состоит из набора объектов ExchangeQueue (Exchange_Queue).

Путь к объекту ExchangeQueue в иерерархии классов WMI выглядит как

\\COMPUTERNAME\ROOT\cimv2\applications\exchange:ExchangeQueue

а путь к объекту Exchange_Queue — как

\\COMPUTERNAME\ROOT\MicrosoftExchangeV2:Exchange_Queue

Главное различие между объектами ExchangeQueue и Exchange_Queue заключается в том, что Exchange_Queue — более новый объект и его можно использовать только для работы с Exchange Server 2003. ExchangeQueue можно применять как для работы с Exchange Server 2000, так и с Exchange Server 2003. Наборы свойств этого объекта частично совпадают, хотя для каждого объекта предусмотрены и свои уникальные свойства.

Отметим одну особенность работы с этими классами. Класс ExchangeQueue — это вполне самостоятельный класс, и вы вполне можете выполнять различные операции с экземплярами данного класса (то есть объектами очередей), получив коллекцию экземпляров при помощи WQL-запроса вида

SELECT * FROM ExchangeQueue

(конечно, перед этим нужно подключиться в пространству имен root\CIMV2\Applications\Exchange). В то же время, если вы подключитесь к пространству имен \root\MicrosoftExchangeV2 и выполните запрос

SELECT * FROM Exchange_Queue

то вам вернется пустая коллекция. Связано это с тем, что Exchange_Queue — это родительский класс, а реальная работа производится с экземплярами дочерних классов Exchange_SMTPQueue и Exchange_X400Queue. Поэтому запрос для получения коллекции объектов очередей может выглядеть, например, так:

SELECT * FROM Exchange_SMTPQueue

Свойства классов Exchange_SMTPQueue и Exchange_X400Queue абсолютно одинаковы. Все они наследуются от объекта Exchange_Queue, поэтому в этом разделе речь будет идти именно об этом классе.

Ниже представлена информация о всех свойствах объектов ExchangeQueue и Exchange_Queue, при этом для каждого из свойств указано, к для какого объекта или объектов его можно использовать:

• CanEnumAll (это свойство предусмотрено для обоих объектов) — если для этого свойства возвращается значение True, то для очереди можно просмотреть все сообщения, которые в ней находятся (только обычными средствами Queue Viewer в Exchange System Manager). Этому свойству соответствует тридцать первый бит возвращаемого свойством MsgEnumFlagsSupported значения;
• CanEnumAll (только для объекта ExchangeQueue) — если для этого свойства возвращается значение True, то для очереди можно получить набор всех сообщений, которые не могут быть переданы согласно требуемому назначению (набор также можно просмотреть только средствами Exchange System Manager). Этому свойству соответствует девятый бит возвращаемого свойством MsgEnumFlagsSupported значения;
• CanEnumFirstNMessages (только для объекта ExchangeQueue) — если для этого свойства возвращается значение True, то для очереди можно получить набор из N сообщений, которые стоят первыми в очереди. Этому свойству соответствует первый бит возвращаемого свойством MsgEnumFlagsSupported значения;
• CanEnumFrozen (только для объекта ExchangeQueue) — если для этого свойства возвращается значение True, то для очереди можно получить набор из сообщений, передача которых была заморожена (при помощи команды Freeze (Заморозить) в Exchange System Manager). Этому свойству соответствует шестой бит возвращаемого свойством MsgEnumFlagsSupported значения;
• CanEnumInvertSense (только для объекта ExchangeQueue) — если для этого свойства возвращается значение True, то для очереди можно получить набор из сообщений, которые не соответствуют указанному вами критерию (например, если вам нужны сообщения, попавшие в очередь после определенного времени, то можно ли вернуть те сообщения, которые попали в очередь до указанного времени). Этому свойству соответствует тридцать второй бит возвращаемого свойством MsgEnumFlagsSupported значения;
• CanEnumLargerThan (только для объекта ExchangeQueue) — если для этого свойства возвращается значение True, то для очереди можно получить набор сообщений, размер которых больше определенного передела (например, если вы хотите разморозить только небольшие сообщения, а доставку сообщений большого размера отложить на другое время). Этому свойству соответствует четвертый бит возвращаемого свойством MsgEnumFlagsSupported значения;
• CanEnumNLargestMessages (только для объекта ExchangeQueue) — если для этого свойства возвращается значение True, то для очереди можно получить набор из N сообщений наибольшего размера. Этому свойству соответствует седьмой бит возвращаемого свойством MsgEnumFlagsSupported значения;
• CanEnumNOldestMessages (только для объекта ExchangeQueue) — если для этого свойства возвращается значение True, то для очереди можно получить набор из N сообщений, которые попали в очередь раньше всех остальных. Этому свойству соответствует восьмой бит возвращаемого свойством MsgEnumFlagsSupported значения;
• CanEnumOlderThan (только для объекта ExchangeQueue) — если для этого свойства возвращается значение True, то для очереди можно получить набор из всех сообщений, которые попали в очередь раньше определенного времени. Этому свойству соответствует пятый бит возвращаемого свойством MsgEnumFlagsSupported значения;
• CanEnumRecepients (только для объекта ExchangeQueue) — если для этого свойства возвращается значение True, то для очереди можно получить набор из всех получателей для сообщений, которые находятся в этой очереди. Этому свойству соответствует четвертый бит возвращаемого свойством MsgEnumFlagsSupported значения;
• CanEnumSender (только для объекта ExchangeQueue) — если для этого свойства возвращается значение True, то для очереди можно получить набор из всех отправителей для сообщений, которые находятся. Этому свойству соответствует второй бит возвращаемого свойством MsgEnumFlagsSupported значения;
• GlobalStop (для обоих объектов) — если этой свойство возвращает значение True, то это значит, что очередь в данный момент остановлена;
• IncreasingTime (только для объекта ExchangeQueue) — это свойство возвращает количество миллисекунд, в течение которых размер очереди только увеличивался (то есть, скорее всего, передача сообщений для данной очереди не производилась);
• LinkId (только для объекта Exchange_Queue) — это свойство возвращает идентификатор соединения (представленного объектом Exchange_Link), которому принадлежит данная очередь;
• LinkName (для обоих объектов) — это свойство возвращает имя объекта соединения (представленного объектами ExchangeLink или Exchange_Link), которому принадлежит данная очередь;
• MsgEnumFlagsSupported (для обоих объектов) — это свойство возвращает битовую маску с информацией о возможностях, которые поддерживаются данной очередью. Для объекта ExchangeQueue ту же информацию можно получить при помощи свойств, имена которых начинаются на Can....
• NumberOfMessages (только для объекта ExchangeQueue, для объекта Exchange_Queue используется аналогичное свойство MessageCount) — это свойство возвращает информацию о общем количестве сообщений в очереди;
• ProtocolName (для обоих объектов) — это свойство возвращает информацию о протоколе, который используется для передачи сообщений данной очереди в виде строкового значения. Обычно для этого свойства используются только два значения — "SMTP" и "X400".
• QueueId (только для объекта Exchange_Queue) — это свойство возвращает идентификатор данной очереди (в формате GUID).
• QueueName (для обоих объектов) — это свойство возвращает имя очереди;
• SizeOfQueue (только для объекта ExchangeQueue, для объекта Exchange_Queue используется аналогичное свойство Size) — это свойство возвращает размер всех сообщений в очереди (в байтах);
• Version (для обоих объектов) — это свойство возвращает номер версии программного обеспечения Exchange Server, которой используется для работы с очередями. Для Exchange Server 2003 возвращается значение 4.
• VirtualMachine (для обоих объектов) — это свойство возвращает имя виртуального компьютера (для кластера) или имя обычного компьютера (если кластер не используется), на котором расположена эта очередь.
• VirtualServerName (для обоих объектов) — это свойство возвращает номер виртуального сервера, к которому принадлежит данная очередь. Этот номер одновременно является значением атрибута CN (Common Name) для объекта данного сервера в Active Directory.

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