Compartilhar via


Operação CreateManagedFolder

A operação CreateManagedFolder cria uma pasta gerenciada no repositório Exchange.

Usando a operação CreateManagedFolder

A operação CreateManagedFolder adiciona uma pasta personalizada gerenciada à caixa de correio de um usuário. Você pode usar o cmdlet Get-ManagedFolder do Shell do Exchange Management para encontrar pastas gerenciadas disponíveis para adicionar. Embora esse cmdlet retorne pastas personalizadas gerenciadas e pastas padrão gerenciadas, somente pastas personalizadas gerenciadas podem ser adicionadas. As pastas personalizadas gerenciadas são identificadas pelo tipo de pasta ManagedCustomFolder. O namespace System.DirectoryServices também inclui tipos que podem ser usados para descobrir os nomes das pastas gerenciadas disponíveis.

Observação

Você não pode usar o Exchange Web Services para localizar os nomes das pastas gerenciadas disponíveis para adicionar a uma caixa de correio.

Você pode usar as operações FindFolder e GetFolder para acessar pastas gerenciadas. FindFolder é usado para pesquisar pastas em uma pasta pai especificada. Isso pode ser usado para que pastas gerenciadas possam ser descobertas em uma pasta antes de tentar adicionar uma pasta personalizada gerenciada duplicada ao mesmo diretório. GetFolder é usado após a operação FindFolder para obter mais informações sobre uma pasta personalizada gerenciada.

Comentários

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.

Para obter informações sobre como remover pastas personalizadas gerenciadas de uma caixa de correio, consulte Remove-ManagedFolder.

Exemplo de solicitação CreateManagedFolder

Descrição

O exemplo a seguir de uma solicitação CreateManagedFolder mostra como adicionar uma pasta gerenciada chamada Pasta Gerenciada de Teste a uma caixa de correio.

Observação

Você também pode usar o acesso de delegado para adicionar pastas personalizadas gerenciadas.

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="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 solicitação

Os seguintes elementos são usados na solicitação:

Para encontrar outras opções para a mensagem de solicitação da operação CreateManagedFolder, explore a hierarquia de esquema. Comece no elemento CreateManagedFolder .

Resposta CreateManagedFolder bem-sucedida

Descrição

O exemplo de código a seguir mostra uma resposta bem-sucedida a uma solicitação CreateManagedFolder.

Observação

Os valores de atributo Id e ChangeKey foram abreviados para preservar a legibilidade.

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="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-sucedidos

Os seguintes elementos são usados na resposta:

Para encontrar outras opções para as mensagens de resposta da operação CreateManagedFolder, explore a hierarquia de esquema. Comece no elemento CreateManagedFolderResponse .

Resposta de erro CreateManagedFolder

Descrição

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

Os seguintes elementos são usados na resposta de erro:

Confira também

Operação GetFolder

Operação FindFolder

Encontrar pastas

Adicionar pastas gerenciadas