Opération CreateManagedFolderCreateManagedFolder operation

L’opération CreateManagedFolder crée un dossier géré dans la Banque d’Exchange.The CreateManagedFolder operation creates a managed folder in the Exchange store.

Utilisation de l’opération CreateManagedFolderUsing the CreateManagedFolder Operation

L’opération CreateManagedFolder ajoute un dossier personnalisé géré à la boîte aux lettres d’un utilisateur.The CreateManagedFolder operation adds a managed custom folder to a user's mailbox. Vous pouvez utiliser la cmdlet Get-ManagedFolder de l’environnement de commande Exchange Management Shell pour rechercher les dossiers gérés à ajouter.You can use the Exchange Management Shell Get-ManagedFolder cmdlet to find available managed folders to add. Bien que cette applet de commande renvoie les dossiers personnalisés gérés et les dossiers par défaut gérés, seuls les dossiers personnalisés gérés peuvent être ajoutés.Although this cmdlet returns both managed custom folders and managed default folders, only managed custom folders can be added. Les dossiers personnalisés gérés sont identifiés par le type de dossier ManagedCustomFolder.Managed custom folders are identified by the ManagedCustomFolder folder type. L’espace de noms System. DirectoryServices inclut également des types qui peuvent être utilisés pour découvrir les noms des dossiers gérés disponibles.The System.DirectoryServices namespace also includes types that can be used to discover the names of available managed folders.

Notes

Vous ne pouvez pas utiliser les services Web Exchange pour rechercher les noms des dossiers gérés disponibles à ajouter à une boîte aux lettres.You cannot use Exchange Web Services to find the names of available managed folders to add to a mailbox.

Vous pouvez utiliser les opérations FindFolder et GetFolder pour accéder aux dossiers gérés.You can use the FindFolder and GetFolder operations to access managed folders. FindFolder permet de rechercher des dossiers dans un dossier parent spécifié.FindFolder is used to search for folders in a specified parent folder. Cela peut être utilisé afin que les dossiers gérés puissent être découverts dans un dossier avant d’essayer d’ajouter un dossier personnalisé géré en double dans le même répertoire.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 est utilisé après l’opération FindFolder pour obtenir plus d’informations sur un dossier personnalisé géré.GetFolder is used after the FindFolder operation to get more information about a managed custom folder.

RemarquesRemarks

Pour plus d’informations sur la configuration de la stratégie de gestion des enregistrements de messagerie (MRM), voir comment créer une stratégie de boîte aux lettres de dossier géré.For information about how to set up messaging records management (MRM) policy, see How to Create a Managed Folder Mailbox Policy.

Pour plus d’informations sur la suppression de dossiers personnalisés gérés d’une boîte aux lettres, consultez la rubrique Remove-ManagedFolder.For information about how to remove managed custom folders from a mailbox, see Remove-ManagedFolder.

Exemple de requête CreateManagedFolderCreateManagedFolder request example

DescriptionDescription

L’exemple de requête CreateManagedFolder suivant montre comment ajouter un dossier géré nommé test du dossier géré à une boîte aux lettres.The following example of a CreateManagedFolder request shows how to add a managed folder named Test Managed Folder to a mailbox.

Notes

Vous pouvez également utiliser l’accès délégué pour ajouter des dossiers personnalisés gérés.You can also use delegate access to add managed custom folders.

CodeCode

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

Demander des élémentsRequest elements

Les éléments suivants sont utilisés dans la demande :The following elements are used in the request:

Pour trouver d’autres options pour le message de demande de l’opération CreateManagedFolder, explorez la hiérarchie du schéma.To find other options for the request message of the CreateManagedFolder operation, explore the schema hierarchy. Commencez par l’élément CreateManagedFolder .Start at the CreateManagedFolder element.

Réponse CreateManagedFolder réussieSuccessful CreateManagedFolder Response

DescriptionDescription

L’exemple de code suivant montre une réponse réussie à une demande CreateManagedFolder.The following code example shows a successful response to a CreateManagedFolder request.

Notes

Les valeurs d’attribut ID et ChangeKey ont été raccourcies afin de préserver la lisibilité.The Id and ChangeKey attribute values have been shortened to preserve readability.

CodeCode

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

Éléments de réponse réussisSuccessful response elements

Les éléments suivants sont utilisés dans la réponse :The following elements are used in the response:

Pour rechercher d’autres options pour les messages de réponse de l’opération CreateManagedFolder, explorez la hiérarchie du schéma.To find other options for the response messages of the CreateManagedFolder operation, explore the schema hierarchy. Commencez par l’élément CreateManagedFolderResponse .Start at the CreateManagedFolderResponse element.

Réponse d’erreur CreateManagedFolderCreateManagedFolder error response

DescriptionDescription

L’exemple de code suivant montre une réponse d’erreur à une demande CreateManagedFolder.The following code example shows an error response to a CreateManagedFolder request.

CodeCode

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

Éléments de réponse d’erreurError response elements

Les éléments suivants sont utilisés dans la réponse d'erreur :The following elements are used in the error response:

Voir aussiSee also

Opération GetFolderGetFolder operation

Opération FindFolderFindFolder operation

Recherche de dossiersFinding Folders

Ajout de dossiers gérésAdding Managed Folders