Ajouter et supprimer des délégués en utilisant EWS dans Exchange
Découvrez comment ajouter ou supprimer des délégués dans les boîtes aux lettres des utilisateurs à l’aide de l’API managée EWS ou d’EWS dans Exchange.
Vous pouvez utiliser l’API managée EWS ou EWS pour permettre aux délégués d’agir au nom d’un propriétaire de boîte aux lettres ou de supprimer l’accès d’un délégué à une boîte aux lettres. Les utilisateurs ajoutés en tant que délégués et disposant d’autorisations peuvent effectuer des tâches pour le compte du propriétaire de la boîte aux lettres. Par exemple, ils peuvent créer et envoyer des invitations à une réunion, envoyer des e-mails et répondre aux demandes de réunion au nom du propriétaire de la boîte aux lettres.
Tableau 1. Méthodes d’API managée EWS et opérations EWS pour ajouter et supprimer des délégués
| Tâche | Méthode d'API managée EWS | Opération EWS |
|---|---|---|
| Ajouter des délégués |
ExchangeService.AddDelegates |
AddDelegate |
| Supprimer des délégués |
ExchangeService.RemoveDelegates |
RemoveDelegate |
Une fois qu’un délégué dispose d’autorisations sur un dossier, il peut agir sur les éléments du dossier et sur tous les sous-dossiers, en fonction de ses autorisations déléguées. Les autorisations pour les délégués s’appliquent uniquement aux sous-dossiers créés après l’octroi de l’accès délégué. Pour mettre à jour les autorisations de dossier pour des dossiers préexistants ou d’autres dossiers, consultez Définir des autorisations de dossier pour un autre utilisateur à l’aide d’EWS dans Exchange.
Notez que les délégués ne peuvent être ajoutés qu’aux comptes avec boîte aux lettres, y compris aux groupes de sécurité à extension messagerie. Par défaut, un seul appel d’accès délégué EWS peut accéder à un maximum de 255 boîtes aux lettres différentes.
Ajouter des délégués à l’aide de l’API managée EWS
Vous pouvez ajouter des délégués à une boîte aux lettres à l’aide de la méthode d’API managée EWS AddDelegates . Dans cet exemple, un nouvel objet DelegateUser de calendrier, de contact et d’e-mail est créé, et chaque délégué reçoit des autorisations d’éditeur pour son dossier respectif. Vous pouvez modifier l’exemple pour ajouter un délégué à l’un des dossiers spécifiés par les propriétés DelegatePermissions, et vous pouvez définir les autorisations sur l’une des valeurs spécifiées par l’énumération DelegateFolderPermissionLevel .
Cet exemple suppose que le service est un objet ExchangeService valide pour le propriétaire de la boîte aux lettres et que l’utilisateur a été authentifié auprès d’un serveur Exchange.
public static Collection<DelegateUserResponse> AddDelegates(ExchangeService service)
{
// Create a list to hold the new delegates to add.
List<DelegateUser> newDelegates = new System.Collections.Generic.List<DelegateUser>();
// Create a new delegate that has editor access to the mailbox owner's Calendar folder.
DelegateUser calendarDelegate = new DelegateUser("calendardelegate@contoso.com");
calendarDelegate.Permissions.CalendarFolderPermissionLevel = DelegateFolderPermissionLevel.Editor;
// Add the delegate to the list of new delegates.
newDelegates.Add(calendarDelegate);
// Create a new delegate that has editor access to the mailbox owner's Contacts folder.
DelegateUser contactDelegate = new DelegateUser("contactdelegate@contoso.com");
contactDelegate.Permissions.ContactsFolderPermissionLevel = DelegateFolderPermissionLevel.Editor;
// Add the delegate to the list of new delegates.
newDelegates.Add(contactDelegate);
// Create a new delegate that has editor access to the mailbox owner's Inbox folder.
DelegateUser emailDelegate = new DelegateUser("emaildelegate@contoso.com");
emailDelegate.Permissions.InboxFolderPermissionLevel = DelegateFolderPermissionLevel.Editor;
// Add the delegate to the list of new delegates.
newDelegates.Add(emailDelegate);
// Create a mailbox object that represents the mailbox owner.
Mailbox mailbox = new Mailbox("primary@contoso.com");
// Call the AddDelegates method to add the delegates to the target mailbox.
Collection<DelegateUserResponse> response = service.AddDelegates(mailbox, MeetingRequestsDeliveryScope.DelegatesAndSendInformationToMe, newDelegates);
foreach (DelegateUserResponse resp in response)
{
// Print out the result and the last eight characters of the item ID.
Console.WriteLine("For delegate " + resp.DelegateUser.UserId.PrimarySmtpAddress.ToString());
Console.WriteLine("Result: {0}", resp.Result);
Console.WriteLine("Error Code: {0}", resp.ErrorCode);
Console.WriteLine("ErrorMessage: {0}\r\n", resp.ErrorMessage);
Console.WriteLine("\r\n");
}
return response;
}
Ajouter des délégués à l’aide d’EWS
L’exemple de code suivant montre comment ajouter des délégués de calendrier, de contact et d’e-mail distincts à l’aide de l’opération AddDelegate EWS. La boîte aux lettres à modifier est spécifiée par l’élément Mailbox , et les paramètres d’autorisation de chaque délégué sont contenus dans l’élément DelegateUser . Chacun des délégués a reçu des autorisations d’éditeur sur son dossier cible.
Il s’agit également de la requête XML que l’API managée EWS envoie lorsque vous utilisez la méthode AddDelegates pour ajouter des délégués.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<t:RequestServerVersion Version="Exchange2007_SP1" />
</soap:Header>
<soap:Body>
<m:AddDelegate>
<m:Mailbox>
<t:EmailAddress>primary@contoso.com</t:EmailAddress>
</m:Mailbox>
<m:DelegateUsers>
<t:DelegateUser>
<t:UserId>
<t:PrimarySmtpAddress>calendardelegate@contoso.com</t:PrimarySmtpAddress>
</t:UserId>
<t:DelegatePermissions>
<t:CalendarFolderPermissionLevel>Editor</t:CalendarFolderPermissionLevel>
<t:TasksFolderPermissionLevel>None</t:TasksFolderPermissionLevel>
<t:InboxFolderPermissionLevel>None</t:InboxFolderPermissionLevel>
<t:ContactsFolderPermissionLevel>None</t:ContactsFolderPermissionLevel>
<t:NotesFolderPermissionLevel>None</t:NotesFolderPermissionLevel>
<t:JournalFolderPermissionLevel>None</t:JournalFolderPermissionLevel>
</t:DelegatePermissions>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</t:DelegateUser>
<t:DelegateUser>
<t:UserId>
<t:PrimarySmtpAddress>contactdelegate@contoso.com</t:PrimarySmtpAddress>
</t:UserId>
<t:DelegatePermissions>
<t:CalendarFolderPermissionLevel>None</t:CalendarFolderPermissionLevel>
<t:TasksFolderPermissionLevel>None</t:TasksFolderPermissionLevel>
<t:InboxFolderPermissionLevel>None</t:InboxFolderPermissionLevel>
<t:ContactsFolderPermissionLevel>Editor</t:ContactsFolderPermissionLevel>
<t:NotesFolderPermissionLevel>None</t:NotesFolderPermissionLevel>
<t:JournalFolderPermissionLevel>None</t:JournalFolderPermissionLevel>
</t:DelegatePermissions>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</t:DelegateUser>
<t:DelegateUser>
<t:UserId>
<t:PrimarySmtpAddress>emaildelegate@contoso.com</t:PrimarySmtpAddress>
</t:UserId>
<t:DelegatePermissions>
<t:CalendarFolderPermissionLevel>None</t:CalendarFolderPermissionLevel>
<t:TasksFolderPermissionLevel>None</t:TasksFolderPermissionLevel>
<t:InboxFolderPermissionLevel>Editor</t:InboxFolderPermissionLevel>
<t:ContactsFolderPermissionLevel>None</t:ContactsFolderPermissionLevel>
<t:NotesFolderPermissionLevel>None</t:NotesFolderPermissionLevel>
<t:JournalFolderPermissionLevel>None</t:JournalFolderPermissionLevel>
</t:DelegatePermissions>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</t:DelegateUser>
</m:DelegateUsers>
<m:DeliverMeetingRequests>DelegatesAndSendInformationToMe</m:DeliverMeetingRequests>
</m:AddDelegate>
</soap:Body>
</soap:Envelope>
Le serveur répond à la requête AddDelegate avec un message AddDelegateResponse qui inclut une valeur d’élément ResponseCodenoError, ce qui indique que les délégués ont été créés avec succès.
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="https://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:ServerVersionInfo MajorVersion="15"
MinorVersion="0"
MajorBuildNumber="888"
MinorBuildNumber="9"
Version="V2_10"
xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
</s:Header>
<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<m:AddDelegateResponse ResponseClass="Success"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
<m:ResponseCode>NoError</m:ResponseCode>
<m:ResponseMessages>
<m:DelegateUserResponseMessageType ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:DelegateUser>
<t:UserId>
<t:SID>S-1-5-21-1337771579-694202782-848329751-1535221</t:SID>
<t:PrimarySmtpAddress>calendardelegate@contoso.com</t:PrimarySmtpAddress>
<t:DisplayName>calendardelegate</t:DisplayName>
</t:UserId>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</m:DelegateUser>
</m:DelegateUserResponseMessageType>
<m:DelegateUserResponseMessageType ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:DelegateUser>
<t:UserId>
<t:SID>S-1-5-21-1337771579-694202782-848329751-1535264</t:SID>
<t:PrimarySmtpAddress>contactdelegate@contoso.com</t:PrimarySmtpAddress>
<t:DisplayName>contactdelegate</t:DisplayName>
</t:UserId>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</m:DelegateUser>
</m:DelegateUserResponseMessageType>
<m:DelegateUserResponseMessageType ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:DelegateUser>
<t:UserId>
<t:SID>S-1-5-21-1337771579-694202782-848329751-1535223</t:SID>
<t:PrimarySmtpAddress>emaildelegate@contoso.com</t:PrimarySmtpAddress>
<t:DisplayName>emaildelegate</t:DisplayName>
</t:UserId>
<t:ReceiveCopiesOfMeetingMessages>false</t:ReceiveCopiesOfMeetingMessages>
<t:ViewPrivateItems>false</t:ViewPrivateItems>
</m:DelegateUser>
</m:DelegateUserResponseMessageType>
</m:ResponseMessages>
</m:AddDelegateResponse>
</s:Body>
</s:Envelope>
Supprimer des délégués à l’aide de l’API managée EWS
Vous pouvez supprimer des délégués d’une boîte aux lettres cible à l’aide de la méthode d’API managée EWS ExchangeService.RemoveDelegates . Dans cet exemple, les autorisations de délégué définies dans l’exemple Ajouter un délégué sont supprimées.
Cet exemple suppose que le service est un objet ExchangeService valide pour le propriétaire de la boîte aux lettres et que l’utilisateur a été authentifié auprès d’un serveur Exchange.
public static Collection<DelegateUserResponse> RemoveDelegates(ExchangeService service)
{
// Create a list to hold the delegates to delete.
List<UserId> deletedDelegates = new System.Collections.Generic.List<UserId>();
// Add the delegate to the list of new delegates.
deletedDelegates.Add("calendardelegate@contoso.com");
// Add the delegate to the list of new delegates.
deletedDelegates.Add("contactdelegate@contoso.com");
// Add the delegate to the list of new delegates.
deletedDelegates.Add("emaildelegate@contoso.com");
// Create a mailbox object that represents the mailbox owner.
Mailbox mailbox = new Mailbox("primary@contoso.com");
// Call the AddDelegates method to add the delegates to the target mailbox.
Collection<DelegateUserResponse> response = service.RemoveDelegates(mailbox, deletedDelegates);
foreach (DelegateUserResponse resp in response)
{
// Print out the result and the last eight characters of the item ID.
Console.WriteLine("Result: {0}", resp.Result);
Console.WriteLine("Error Code: {0}", resp.ErrorCode);
Console.WriteLine("ErrorMessage: {0}\r\n", resp.ErrorMessage);
}
return response;
}
Supprimer des délégués à l’aide d’EWS
Vous pouvez supprimer des délégués d’une boîte aux lettres à l’aide de l’opération RemoveDelegate EWS. Dans cet exemple, les autorisations de délégué définies dans l’exemple Ajouter un délégué sont supprimées.
Il s’agit également de la requête XML que l’API managée EWS envoie lorsque vous utilisez la méthode RemoveDelegates pour supprimer des délégués.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<t:RequestServerVersion Version="Exchange2007_SP1" />
</soap:Header>
<soap:Body>
<m:RemoveDelegate>
<m:Mailbox>
<t:EmailAddress>primary@contoso.com</t:EmailAddress>
</m:Mailbox>
<m:UserIds>
<t:UserId>
<t:PrimarySmtpAddress>calendardelegate@contoso.com</t:PrimarySmtpAddress>
</t:UserId>
<t:UserId>
<t:PrimarySmtpAddress>contactdelegate@contoso.com</t:PrimarySmtpAddress>
</t:UserId>
<t:UserId>
<t:PrimarySmtpAddress>emaildelegate@contoso.com</t:PrimarySmtpAddress>
</t:UserId>
</m:UserIds>
</m:RemoveDelegate>
</soap:Body>
</soap:Envelope>
Le serveur répond à la requête RemoveDelegate avec un message AddDelegateResponse qui inclut une valeur d’élément ResponseCodeNoError, ce qui indique que les délégués ont été supprimés avec succès.
Étapes suivantes
Une fois que vous avez ajouté des délégués aux dossiers de calendrier, de courrier électronique et de tâches, le délégué peut accéder aux éléments des dossiers. Pour en savoir plus, consultez les articles suivants :
Accéder à la messagerie en tant que délégué à l’aide d’EWS dans Exchange
Accéder à un calendrier en tant que délégué en utilisant EWS dans Exchange
Accéder aux contacts en tant que délégué à l’aide d’EWS dans Exchange
Si les dossiers pour lesquels vous avez ajouté des délégués incluent des dossiers enfants qui ont été créés avant l’octroi de l’accès délégué, le délégué ne pourra pas accéder à ces dossiers sans autorisations supplémentaires. Pour ajouter ces autorisations ou modifier des autorisations pour d’autres dossiers, consultez Définir des autorisations de dossier pour un autre utilisateur à l’aide d’EWS dans Exchange.
Voir aussi
- Accès délégué et EWS dans Exchange
- Exchange 2013 : Ajouter des utilisateurs délégués à un compte de messagerie par programmation
- Exchange 2013 : Mettre à jour les délégués associés aux comptes de messagerie par programme
- Exchange 2013 : Supprimer les délégués associés aux comptes de messagerie par programmation
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