Opération CreateManagedFolder
L’opération CreateManagedFolder crée un dossier managé dans le magasin Exchange.
Utilisation de l’opération CreateManagedFolder
L’opération CreateManagedFolder ajoute un dossier personnalisé managé à la boîte aux lettres d’un utilisateur. Vous pouvez utiliser l’applet de commande Get-ManagedFolder de l’environnement de ligne de commande Exchange Management Shell pour rechercher les dossiers managés disponibles à ajouter. Bien que cette applet de commande retourne à la fois des dossiers personnalisés managés et des dossiers managés par défaut, seuls les dossiers personnalisés managés peuvent être ajoutés. Les dossiers personnalisés managés sont identifiés par le type de dossier ManagedCustomFolder. L’espace de noms System.DirectoryServices inclut également des types qui peuvent être utilisés pour découvrir les noms des dossiers managés disponibles.
Remarque
Vous ne pouvez pas utiliser les services web Exchange pour rechercher les noms des dossiers managés disponibles à ajouter à une boîte aux lettres.
Vous pouvez utiliser les opérations FindFolder et GetFolder pour accéder aux dossiers managés. FindFolder est utilisé pour rechercher des dossiers dans un dossier parent spécifié. Il peut être utilisé pour que les dossiers managés puissent être découverts dans un dossier avant d’essayer d’ajouter un dossier personnalisé managé en double au même répertoire. GetFolder est utilisé après l’opération FindFolder pour obtenir plus d’informations sur un dossier personnalisé managé.
Remarques
Pour plus d’informations sur la configuration de la stratégie de gestion des enregistrements de messagerie (MRM), consultez How to Create a Managed Folder Mailbox Policy.
Pour plus d’informations sur la suppression de dossiers personnalisés managés d’une boîte aux lettres, consultez Remove-ManagedFolder.
Exemple de requête CreateManagedFolder
Description
L’exemple suivant de requête CreateManagedFolder montre comment ajouter un dossier managé nommé Test Managed Folder à une boîte aux lettres.
Remarque
Vous pouvez également utiliser l’accès délégué pour ajouter des dossiers personnalisés managés.
Code
<?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>
Éléments de requête
Les éléments suivants sont utilisés dans la demande :
Pour trouver d’autres options pour le message de demande de l’opération CreateManagedFolder, explorez la hiérarchie de schéma. Commencez par l’élément CreateManagedFolder .
Réponse CreateManagedFolder réussie
Description
L’exemple de code suivant montre une réponse réussie à une requête CreateManagedFolder.
Remarque
Les valeurs d’attribut Id et ChangeKey ont été raccourcies pour préserver la lisibilité.
Code
<?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éussis
Les éléments suivants sont utilisés dans la réponse :
Pour trouver d’autres options pour les messages de réponse de l’opération CreateManagedFolder, explorez la hiérarchie de schéma. Commencez à l’élément CreateManagedFolderResponse .
Réponse d’erreur CreateManagedFolder
Description
L’exemple de code suivant montre une réponse d’erreur à une requête CreateManagedFolder.
Code
<?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’erreur
Les éléments suivants sont utilisés dans la réponse d'erreur :
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour