Поделиться через

Операция CreateManagedFolder

  • Статья

Операция CreateManagedFolder создает управляемую папку в хранилище Exchange.

Использование операции CreateManagedFolder

Операция CreateManagedFolder добавляет управляемую пользовательскую папку в почтовый ящик пользователя. Вы можете использовать командлет Get-ManagedFolder командной консоли Exchange, чтобы найти доступные управляемые папки для добавления. Хотя этот командлет возвращает как управляемые пользовательские папки, так и управляемые папки по умолчанию, можно добавлять только управляемые пользовательские папки. Управляемые пользовательские папки определяются типом папки ManagedCustomFolder. Пространство имен System.DirectoryServices также включает типы, которые можно использовать для обнаружения имен доступных управляемых папок.

Примечание.

Веб-службы Exchange нельзя использовать для поиска имен доступных управляемых папок, добавляемых в почтовый ящик.

Для доступа к управляемым папкам можно использовать операции FindFolder и GetFolder. FindFolder используется для поиска папок в указанной родительской папке. Это можно использовать для обнаружения управляемых папок в папке перед попыткой добавить дубликат управляемой пользовательской папки в тот же каталог. GetFolder используется после операции FindFolder для получения дополнительных сведений об управляемой пользовательской папке.

Замечания

Сведения о настройке политики управления записями обмена сообщениями (MRM) см. в статье Создание политики почтовых ящиков управляемых папок.

Сведения об удалении управляемых пользовательских папок из почтового ящика см. в разделе Remove-ManagedFolder.

Пример запроса CreateManagedFolder

Описание

В следующем примере запроса CreateManagedFolder показано, как добавить управляемую папку с именем Test Managed Folder в почтовый ящик.

Примечание.

Вы также можете использовать делегированный доступ для добавления управляемых пользовательских папок.

Код

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <CreateManagedFolder xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <FolderNames>
        <t:FolderName>Test Managed Folder</t:FolderName>
      </FolderNames>
    </CreateManagedFolder>
  </soap:Body>
</soap:Envelope>

Элементы запроса

В запросе используются следующие элементы:

Чтобы найти другие параметры для сообщения запроса операции CreateManagedFolder, изучите иерархию схемы. Начните с элемента CreateManagedFolder .

Успешный ответ CreateManagedFolder

Описание

В следующем примере кода показан успешный ответ на запрос CreateManagedFolder.

Примечание.

Значения атрибутов Id и ChangeKey сокращены для сохранения удобочитаемости.

Код

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="598" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateManagedFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                                 xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
                                 xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:CreateManagedFolderResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Folders>
            <t:Folder>
              <t:FolderId Id="AS0AdX=" ChangeKey="AACADA=="/>
            </t:Folder>
          </m:Folders>
        </m:CreateManagedFolderResponseMessage>
      </m:ResponseMessages>
    </CreateManagedFolderResponse>
  </soap:Body>
</soap:Envelope>

Элементы успешного отклика

В ответе используются следующие элементы:

Чтобы найти другие параметры для ответных сообщений операции CreateManagedFolder, изучите иерархию схемы. Начните с элемента CreateManagedFolderResponse .

Ответ на ошибку CreateManagedFolder

Описание

В следующем примере кода показан ответ на ошибку на запрос CreateManagedFolder.

Код

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="598" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateManagedFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                                 xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
                                 xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:CreateManagedFolderResponseMessage ResponseClass="Error">
          <m:MessageText>A specified managed folder already exists in the mailbox.</m:MessageText>
          <m:ResponseCode>ErrorManagedFolderAlreadyExists</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
          <m:Folders/>
        </m:CreateManagedFolderResponseMessage>
      </m:ResponseMessages>
    </CreateManagedFolderResponse>
  </soap:Body>
</soap:Envelope>

Элементы ответа на ошибку

В ответе на ошибку используются следующие элементы:

См. также

GetFolder Operation

FindFolder Operation

Поиск папок

Добавление управляемых папок