CreateManagedFolder 操作
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="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>
错误响应元素
错误响应中使用以下元素: