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="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 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="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 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="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 resposta de erro
Os seguintes elementos são usados na resposta de erro: