Operación CreateManagedFolder
La operación CreateManagedFolder crea una carpeta administrada en el almacén de Exchange.
Uso de la operación CreateManagedFolder
La operación CreateManagedFolder agrega una carpeta personalizada administrada al buzón de un usuario. Puede usar el cmdlet Get-ManagedFolder del Shell de administración de Exchange para buscar las carpetas administradas disponibles que se van a agregar. Aunque este cmdlet devuelve carpetas personalizadas administradas y carpetas predeterminadas administradas, solo se pueden agregar carpetas personalizadas administradas. Las carpetas personalizadas administradas se identifican mediante el tipo de carpeta ManagedCustomFolder. El espacio de nombres System.DirectoryServices también incluye tipos que se pueden usar para detectar los nombres de las carpetas administradas disponibles.
Nota:
No puede usar servicios web de Exchange para buscar los nombres de las carpetas administradas disponibles que se van a agregar a un buzón.
Puede usar las operaciones FindFolder y GetFolder para acceder a las carpetas administradas. FindFolder se usa para buscar carpetas en una carpeta primaria especificada. Esto se puede usar para que las carpetas administradas se puedan detectar en una carpeta antes de intentar agregar una carpeta personalizada administrada duplicada al mismo directorio. GetFolder se usa después de la operación FindFolder para obtener más información sobre una carpeta personalizada administrada.
Comentarios
Para obtener información sobre cómo configurar la directiva de administración de registros de mensajería (MRM), vea Cómo crear una directiva de buzón de carpeta administrada.
Para obtener información sobre cómo quitar carpetas personalizadas administradas de un buzón de correo, vea Remove-ManagedFolder.
Ejemplo de solicitud CreateManagedFolder
Descripción
En el ejemplo siguiente de una solicitud CreateManagedFolder se muestra cómo agregar una carpeta administrada denominada Test Managed Folder a un buzón de correo.
Nota:
También puede usar el acceso delegado para agregar carpetas personalizadas administradas.
Código
<?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>
Elementos Request
En la solicitud se usan los siguientes elementos:
Para buscar otras opciones para el mensaje de solicitud de la operación CreateManagedFolder, explore la jerarquía de esquema. Comience en el elemento CreateManagedFolder .
Respuesta CreateManagedFolder correcta
Descripción
En el ejemplo de código siguiente se muestra una respuesta correcta a una solicitud CreateManagedFolder.
Nota:
Los valores de atributo Id y ChangeKey se han acortado para conservar la legibilidad.
Código
<?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>
Elementos de respuesta correctos
Los siguientes elementos se usan en la respuesta:
Para buscar otras opciones para los mensajes de respuesta de la operación CreateManagedFolder, explore la jerarquía de esquema. Comience en el elemento CreateManagedFolderResponse .
Respuesta de error CreateManagedFolder
Descripción
En el ejemplo de código siguiente se muestra una respuesta de error a una solicitud CreateManagedFolder.
Código
<?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>
Elementos de respuesta de error
Los siguientes elementos se usan en la respuesta de error: