CreateManagedFolder 操作

项目
03/29/2023

CreateManagedFolder 操作在 Exchange 存储中创建托管文件夹。

使用 CreateManagedFolder 操作

CreateManagedFolder 操作将托管自定义文件夹添加到用户的邮箱。可以使用 Exchange 命令行管理程序 Get-ManagedFolder cmdlet 查找要添加的可用托管文件夹。尽管此 cmdlet 同时返回托管自定义文件夹和托管默认文件夹，但只能添加托管自定义文件夹。托管自定义文件夹由 ManagedCustomFolder 文件夹类型标识。 System.DirectoryServices 命名空间还包括可用于发现可用托管文件夹名称的类型。

注意

不能使用 Exchange Web 服务来查找要添加到邮箱的可用托管文件夹的名称。

可以使用 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="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <CreateManagedFolder xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateManagedFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                 xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                                 xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateManagedFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                 xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                                 xmlns="https://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 操作

FindFolder 操作

Finding Folders

Adding Managed Folders