16.9.10 Класс Exchange_PublicFolder

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

Класс Exchange_PublicFolder предназначен для работы с общими папками Exchange Server. Помимо обычных возможностей по созданию отчетов и мониторингу, которые представляют объекты WMI, этот в том классе также реализовано большое количество методов, при помощи которых с общими папками можно выполнять различные административные операции.

Этот класс доступен только для Exchange Server 2003. Путь к нему в иерархии пространств имен WMI выглядит как

\\COMPUTERNAME\ROOT\MicrosoftExchangeV2:Exchange_PublicFolder

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

• AddressBookName — это свойство возвращает имя общей папки, которое отображается для данной общей папки в адресной книге Exchange Server.
• AdministrativeNote — административные заметки для общей папки (их можно настроить на вкладке Details (Подробности) свойств общей папки в Exchange System Manager);
• AdminSecurityDescriptor — это свойство (в отличие от большинства других, оно доступно как на чтение, так и на запись), возвращает битовую маску, описывающую права, которыми будут обладать по отношению к этой общей папке пользователи, подключившиеся к хранилищу с административными привлегиями.
• ADProxyPath — это свойство возвращает глобально-уникальный иденфтикатор объекта получателя для данной общей папки в Active Directory.
• AssociatedMessageCount — это свойство возвращает общее количество сообщений, ассоциированных согласно таблицам протокола MAPI с данной общей папкой.
• AttachmentsCount — это свойство возвращает общее количество вложений для всех сообщений в данной общей папке.
• CategorizationCount — это свойство возвращает общее количество категоризаций в общей папке.
• Comment — это свойство возвращает описание для данной общей папки. Описание для общей папки устаналивается из свойств папки в клиентском приложении, например, Outlook.
• ContactCount — это свойство возвращает общее количество элементов типа "Контакт" в данной общей папке.
• ContainsRules — если это свойство возвращает значение True, то это значит, что для данной общей папки настроены правила.
• CreationTime — это свойство возвращает время создания данной общей папки.
• DeletedItemLifeTime — это свойство возвращает информацию о том, в течение какого времени сообщения, удаленные из этой общей папки, могут быть восстановлены. Это свойство можно использовать и на чтение, и на запись.
• FolderTree — это свойство определяет, к какому дереву общих папок относится данная общая папка. Это свойство возвращает путь WMI для соответствующего объекта Exchange_FolderTree.
• FriendlyURL — это свойство возвращает путь URL для данной общей папки. Затем этот путь можно использовать, например, при работе с объектной моделью CDOEX.
• HasChildren — это свойство определяет, есть ли в данной папке вложенные подпапки.
• HasLocalReplica — если это свойство возвращает значение True, то это значит, что на данном локалном сервере Exchange Server для этой общей папки имеется копия (реплика).
• IsMailEnabled — если это свойство возвращает значение True, то это значит, что для данной общей папки настроен адрес электронной почты.
• IsNormalFolder — если это свойство возвращает значение True, то это значит, что эта общая папки является обычной общей папкой Exchange Server.
• IsPerUserReadDisabled — если это свойство возвращает значение False, то это значит, что в папке сохраняется информация о том, какие сообщения были прочитаны, для каждого пользователя. Это свойство доступно не только на чтение, но и на запись.
• IsSearchFolder — если это свойство возвращает значение True, то это значит, что данная папка является специализированной папкой поиска.
• IsSecureInSite — если это свойство возвращает значение True, то это значит, что административными правами на эту папку обладают только администраторы ее домашнего сайта (административной группы, в которой она была создана). Это свойство доступно не только на чтение, но и на запись.
• LastAccessTime — это свойство возвращает время последнего клиентского обращения к данной общей папке.
• LastModificationTime — это свойство возвращает информацию о том, когда информация в этой папке последний раз изменялась.
• MaximuItemSize — это свойство возвращает информацию о максималном размере сообщения, которое можно отправлят в данную общую папку. Это свойство доступно не только на чтение, но и на запись.
• MessageCount — это свойство возвращает общее количество сообщений в данной общей папке.
• MessageWithAttachmentsCount — это свойство возвращает информацию об общем количестве сообщений со вложениями в данной общей папке.
• Name — это свойство возвращает имя данной общей папки.
• NormalMessageSize — это свойство возвращает совкупный размер всех обычных сообщений в данной общей папке в байтах.
• OwnerCount — это свойство возвращает количество владельцев для данной общей папки.
• ParentFriendlyUrl — это свойство возвращает путь URL для родительской папки данной общей папки.
• Path — это свойство возвращает часть пути URL к данной общей папке за вычетом части вида http://server/vroot.
• ProhibitPostLimit — это свойство возвращает информацию о настроенном для общей папки ограничении на ее размер (в Кбайт), после которой отправка информации в данную общую папку становится невозможной.
• PublishInAddressBook — если для этого свойства возвращается значение True, то это значит, что эта общая папка должна появиться в глобальном списке адресов.
• RecepientCountOnAssociatedMessages — это свойство возвращает общее количество получателей в ассоциированных сообщениях для данной общей папки.
• RecepientCountOnNormalMessages — это свойство возвращает возвращает общее количество получателей в обычных сообщениях для данной общей папки.
• ReplicaAgeLimit — это свойство позволяет определить "ограничение по возрасту" для сообщений в данной папке — сколько времени будут храниться сообщения в данной папке до того, как они будут удалены. Это свойство можно использовать не только на чтение, но и на запись.
• ReplicaList — это свойство возвращает список отличительных имен в Active Directory для объектов хранилищ, в которых есть реплики для данной папки.
• ReplicationMessagePriority - это свойство определяет приоритет сообщений, которые исползуются для репликации копий данной общей папки. Это свойство доступно и на чтение, и на запись.
• ReplicationSchedule — это свойство определяет расписание репликации для данной общей папки. В качестве значения этого свойства используется массив объектов типа Exchange_ScheduleInterval. Это свойство доступно как на чтение, так и на запись.
• ReplicationStyle — это свойство, работающее с чиловыми значениями, определяет тип расписания репликации данной общей папки. Для него могут быть использованы следующие значения:
• 0 — пользовательское расписание репликации (определяемое при помощи свойства ReplicationSchedule);
• 1 — репликация отключена;
• 2 — репликация работает постоянно;
• 3 — каждый час;
• 4 — каждые два часа;
• 5 — каждые четыре часа;
• 6 — используется расписание по умолчанию, опреденное для всего хранилища общих папок.

Это свойство доступно как на чтение, так и на запись.

• RestrictionCount — это свойство определяет общее количество ограниченйи, наложенных на данную общую папку.
• SecurityDescriptor — это свойство определяет десктриптор безопасности (то есть битовую маску с информацией о разрешениях) для данной общей папки. Это свойство можно исползоват как на чтение, так и н запись.
• StorageLimitStyle — это свойство определяет, как именно для данной общей папки будут налагатся ограничения на размер. Для этого свойства можно исползоват одно из трех значений:
• 0 — использовать ограничения для всех папок по умолчанию, определенные на уровне хранилища общих папок;
• 1 — использовать явно назначенные для данной общей папки ограничения;
• 2 — ограничения для данной общей папки сняты.

Это свойство доступно как на чтение, так и на запись.

• TargetAddress — еще одно свойство, которое определяет адрес электронной почты для данной папки. Значение этого свойства используется только при работе с общей папкой средствами проткола MAPI.
• TotalMessageSize — как и свойство NormalMessageSize, это свойство возвращает совокупный размер всех обычных сообщений в данной общей папке. Фактически это свойство является 8-битной версией свойства MormalMessageSize.
• URL — это свойство возвращает адрес URL для общей папки, в котором используется глобально-уникальный идентификатор данной общей папки.
• UsePublicStoreAgeLimits — если для этого свойства настроено значение True, то это значит, что для данной общей папки должны использоватся параметры устаревания сообщений, настроенные по умолчанию для всех общих папок на уровне хранилища. Это свойство доступно как на чтение, так и на запись.
• UsePublicStoreDeletedItemLifetime — если для этого свойства установлено значение True, то это значит, что для данной общей папки должны применяться параметры работы с удаленными сообщениями, настроенные на уровне всего хранилища общих папок. Это свойство доступно как на чтение, так и на запись.
• WarningLimit — это свойство определяет предельный размер общей папки (в Кбайт), при превышении которого владелцам данной общей папки будут генерироваться предупреждающие сообщения с просьбой очистить данную общую папку. Это свойство доступно как на чтение, так и на запись.
• Syncronize() — при помощи этого метода можно инициироват репликацию данной общей папки. Вызов этого метода для реплики общей папки приводет к тому, что данная реплика немедленно запросит у партнеров по репликаии уведомления об изменениях.
• SendChanges() — вызов этого метода приведет к тому, что данная реплика немеделнно отправит всем партнерам по репликации уведомления об изменениях. В качестве необязательных параметров этот метод принимает количсетво дней, за которые нужно отправлят уведомления, и строковые значения с информацией о партнерах репликации, которым нужно отправить уведомления.
• AddReplica() — этот меод позволяет создат для данной общей папки новую реплику. В качестве параметра этот метод принимает отличительное имя объекта хранилища в Active Directory. В этом хранилище будет создана новая реплика общей папки.
• RemoveReplica() — этот метод позволяет удалить реплику данной общей папки. В качестве параметра этот метод принимает отличительное имя объекта хранилища, в котором нужно удалить реплику.
• Rename() — этот метод можно использоват для переименования общей папки. В качестве параметра этот метод принимает новое имя данной общей папки.
• Move() — этот метод позвоялет переместить общую папку на новое место в иерархии общих папок. В качестве параметра этот метод принимает новый путь URL для данной папки.
• Copy() — этот метод позволяет скопировать общую папку на новое место в иерархии общих папок. В качестве параметра этот метод также принимает новый путь URL для данной папки.
• PropagateSettings() — этот метод позволяет распространить все параметры, настроенные на уровне данной общей папки, на все подпапки и далее вниз по иерархии общих папок. В качестве параметра этому методу передается битовая маска с информацией о том, какие именно параметры нужно применять к подпапкам.

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