Operação CreateManagedFolderCreateManagedFolder operation

A operação CreateManagedFolder cria uma pasta gerenciada no repositório do Exchange.The CreateManagedFolder operation creates a managed folder in the Exchange store.

Usando a operação CreateManagedFolderUsing the CreateManagedFolder Operation

A operação CreateManagedFolder adiciona uma pasta personalizada gerenciada à caixa de correio de um usuário.The CreateManagedFolder operation adds a managed custom folder to a user's mailbox. Você pode usar o cmdlet Get-ManagedFolder do Shell de gerenciamento do Exchange para localizar pastas gerenciadas disponíveis para adicionar.You can use the Exchange Management Shell Get-ManagedFolder cmdlet to find available managed folders to add. Embora este cmdlet retorne pastas personalizadas gerenciadas e pastas padrão gerenciadas, somente pastas personalizadas gerenciadas podem ser adicionadas.Although this cmdlet returns both managed custom folders and managed default folders, only managed custom folders can be added. Pastas personalizadas gerenciadas são identificadas pelo tipo de pasta ManagedCustomFolder.Managed custom folders are identified by the ManagedCustomFolder folder type. O namespace System. DirectoryServices também inclui tipos que podem ser usados para descobrir os nomes das pastas gerenciadas disponíveis.The System.DirectoryServices namespace also includes types that can be used to discover the names of available managed folders.

Observação

Você não pode usar os serviços Web do Exchange para localizar os nomes das pastas gerenciadas disponíveis para adicionar a uma caixa de correio.You cannot use Exchange Web Services to find the names of available managed folders to add to a mailbox.

Você pode usar as operações FindFolder e GetFolder para acessar pastas gerenciadas.You can use the FindFolder and GetFolder operations to access managed folders. FindFolder é usado para pesquisar pastas em uma pasta pai especificada.FindFolder is used to search for folders in a specified parent folder. Isso pode ser usado para que pastas gerenciadas possam ser descobertas em uma pasta antes de tentar adicionar uma pasta personalizada gerenciada duplicada no mesmo diretório.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 é usado após a operação FindFolder para obter mais informações sobre uma pasta personalizada gerenciada.GetFolder is used after the FindFolder operation to get more information about a managed custom folder.

ComentáriosRemarks

Para obter informações sobre como configurar a política de gerenciamento de registros de mensagens (MRM), consulte como criar uma política de caixa de correio de pasta gerenciada.For information about how to set up messaging records management (MRM) policy, see How to Create a Managed Folder Mailbox Policy.

Para obter informações sobre como remover pastas personalizadas gerenciadas de uma caixa de correio, consulte Remove-ManagedFolder.For information about how to remove managed custom folders from a mailbox, see Remove-ManagedFolder.

Exemplo de solicitação CreateManagedFolderCreateManagedFolder request example

DescriçãoDescription

O exemplo a seguir de uma solicitação CreateManagedFolder mostra como adicionar uma pasta gerenciada chamada testar pasta gerenciada a uma caixa de correio.The following example of a CreateManagedFolder request shows how to add a managed folder named Test Managed Folder to a mailbox.

Observação

Você também pode usar o acesso de representante para adicionar pastas personalizadas gerenciadas.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 RequestRequest elements

Os seguintes elementos são usados na solicitação:The following elements are used in the request:

Para encontrar outras opções para a mensagem de solicitação da operação CreateManagedFolder, explore a hierarquia de esquema.To find other options for the request message of the CreateManagedFolder operation, explore the schema hierarchy. Inicie no elemento CreateManagedFolder .Start at the CreateManagedFolder element.

Resposta CreateManagedFolder bem-sucedidaSuccessful CreateManagedFolder Response

DescriçãoDescription

O exemplo de código a seguir mostra uma resposta bem-sucedida a uma solicitação CreateManagedFolder.The following code example shows a successful response to a CreateManagedFolder request.

Observação

Os valores de atributo ID e ChangeKey foram reduzidos para preservar a legibilidade.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 de resposta bem-sucedidosSuccessful response elements

Os seguintes elementos são usados na resposta:The following elements are used in the response:

Para encontrar outras opções para as mensagens de resposta da operação CreateManagedFolder, explore a hierarquia de esquema.To find other options for the response messages of the CreateManagedFolder operation, explore the schema hierarchy. Inicie no elemento CreateManagedFolderResponse .Start at the CreateManagedFolderResponse element.

Resposta de erro CreateManagedFolderCreateManagedFolder error response

DescriçãoDescription

O exemplo de código a seguir mostra uma resposta de erro a uma solicitação 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 resposta de erroError response elements

Os seguintes elementos são usados na resposta de erro:The following elements are used in the error response:

Confira tambémSee also

Operação GetFolderGetFolder operation

Operação FindFolderFindFolder operation

Localizando pastasFinding Folders

Adicionando pastas gerenciadasAdding Managed Folders