Operación CreateManagedFolderCreateManagedFolder operation

La operación CreateManagedFolder crea una carpeta administrada en el almacén de Exchange.The CreateManagedFolder operation creates a managed folder in the Exchange store.

Uso de la operación CreateManagedFolderUsing the CreateManagedFolder Operation

La operación CreateManagedFolder agrega una carpeta personalizada administrada al buzón de un usuario.The CreateManagedFolder operation adds a managed custom folder to a user's mailbox. Puede usar el cmdlet Get-ManagedFolder del shell de administración de Exchange para buscar las carpetas administradas que se pueden agregar.You can use the Exchange Management Shell Get-ManagedFolder cmdlet to find available managed folders to add. Aunque este cmdlet devuelve las carpetas personalizadas administradas y las carpetas predeterminadas administradas, solo se pueden agregar carpetas personalizadas administradas.Although this cmdlet returns both managed custom folders and managed default folders, only managed custom folders can be added. Las carpetas personalizadas administradas se identifican mediante el tipo de carpeta ManagedCustomFolder.Managed custom folders are identified by the ManagedCustomFolder folder type. El espacio de nombres System. DirectoryServices también incluye tipos que se pueden usar para detectar los nombres de las carpetas administradas disponibles.The System.DirectoryServices namespace also includes types that can be used to discover the names of available managed folders.

Nota

No puede usar los servicios web Exchange para encontrar los nombres de las carpetas administradas disponibles para agregar a un buzón de correo.You cannot use Exchange Web Services to find the names of available managed folders to add to a mailbox.

Puede usar las operaciones FindFolder y GetFolder para tener acceso a las carpetas administradas.You can use the FindFolder and GetFolder operations to access managed folders. FindFolder se usa para buscar carpetas en una carpeta principal especificada.FindFolder is used to search for folders in a specified parent folder. Esto puede usarse para que las carpetas administradas se puedan detectar en una carpeta antes de intentar agregar una carpeta personalizada administrada duplicada al mismo directorio.This can be used so that managed folders can be discovered in a folder before trying to add a duplicate managed custom folder to the same directory. GetFolder se usa después de la operación FindFolder para obtener más información acerca de una carpeta administrada personalizada.GetFolder is used after the FindFolder operation to get more information about a managed custom folder.

ComentariosRemarks

Para obtener información acerca de cómo configurar la Directiva de administración de registros de mensajes (MRM), consulte How to Create a Managed Folder Mailbox Policy.For information about how to set up messaging records management (MRM) policy, see How to Create a Managed Folder Mailbox Policy.

Para obtener información acerca de cómo quitar las carpetas personalizadas administradas de un buzón de correo, vea Remove-ManagedFolder.For information about how to remove managed custom folders from a mailbox, see Remove-ManagedFolder.

Ejemplo de solicitud CreateManagedFolderCreateManagedFolder request example

DescriptionDescription

El siguiente ejemplo de una solicitud de CreateManagedFolder muestra cómo agregar una carpeta administrada llamada test Managed Folder a un buzón de correo.The following example of a CreateManagedFolder request shows how to add a managed folder named Test Managed Folder to a mailbox.

Nota

También puede usar acceso delegado para agregar carpetas administradas personalizadas.You can also use delegate access to add managed custom folders.

CódigoCode

<?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>

Elementos de solicitudRequest elements

Los siguientes elementos se usan en la solicitud:The following elements are used in the request:

Para buscar otras opciones para el mensaje de solicitud de la operación CreateManagedFolder, explore la jerarquía del esquema.To find other options for the request message of the CreateManagedFolder operation, explore the schema hierarchy. Empiece en el elemento CreateManagedFolder .Start at the CreateManagedFolder element.

Respuesta CreateManagedFolder correctaSuccessful CreateManagedFolder Response

DescriptionDescription

En el ejemplo de código siguiente se muestra una respuesta correcta a una solicitud CreateManagedFolder.The following code example shows a successful response to a CreateManagedFolder request.

Nota

Los valores de atributo ID y changekey se han abreviado para preservar la legibilidad.The Id and ChangeKey attribute values have been shortened to preserve readability.

CódigoCode

<?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>

Elementos Response correctoSuccessful response elements

En la respuesta se usan los siguientes elementos:The following elements are used in the response:

Para buscar otras opciones de los mensajes de respuesta de la operación CreateManagedFolder, explore la jerarquía del esquema.To find other options for the response messages of the CreateManagedFolder operation, explore the schema hierarchy. Empiece en el elemento CreateManagedFolderResponse .Start at the CreateManagedFolderResponse element.

Respuesta de error de CreateManagedFolderCreateManagedFolder error response

DescriptionDescription

El siguiente ejemplo de código muestra una respuesta de error a una solicitud CreateManagedFolder.The following code example shows an error response to a CreateManagedFolder request.

CódigoCode

<?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>

Elementos de respuesta de errorError response elements

Los siguientes elementos se usan en la respuesta de error:The following elements are used in the error response:

Vea tambiénSee also

Operación GetFolderGetFolder operation

Operación FindFolderFindFolder operation

Buscar carpetasFinding Folders

Adición de carpetas administradasAdding Managed Folders