Exchange で EWS を使用して代理人を追加および削除する
Exchange の EWS マネージ API または EWS を使用してユーザーのメールボックスに対して代理人を追加または削除する方法について説明します。
EWS マネージ API または EWS を使用して、メールボックス所有者の代わりに代理人がアクションを実行できるようにしたり、メールボックスに対する代理人のアクセス権限を削除したりできます。 代理人として追加されてアクセス許可が付与されたユーザーは、メールボックス所有者の代理としてタスクを実行できます。 たとえば、会議出席依頼の作成と送信、メールの送信、会議出席依頼への応答を、メールボックス所有者に代わって行うことができます。
表 1. 代理人を追加および削除するための EWS マネージ API メソッドと EWS 操作
タスク | EWS マネージ API メソッド | EWS 操作 |
---|---|---|
代理人を追加する |
ExchangeService.AddDelegates |
AddDelegate |
代理人を削除する |
ExchangeService.RemoveDelegates |
RemoveDelegate |
フォルダーに対するアクセス許可が与えられた代理人は、その代理人アクセス許可に従って、フォルダーおよびサブフォルダー内のアイテムに対してアクションを実行できるようになります。 代理人のアクセス許可は、代理人アクセス権限が付与された後に作成されるサブフォルダーにのみ適用されます。 既存のフォルダーや他のフォルダーに対するフォルダー アクセス許可を更新するには、「Exchange で EWS を使用して別のユーザーのフォルダーのアクセス許可を設定する」を参照してください。
メールが有効なセキュリティ グループなど、メールボックスが有効なアカウントにのみ代理人を追加できます。 既定では、1 つの EWS 代理人アクセス権限呼び出しで、最大 255 の異なるメールボックスにアクセスできます。
EWS マネージ API を使用して代理人を追加する
AddDelegates EWS マネージ API メソッドを使用して、メールボックスに代理人を追加できます。 この例では、予定表、連絡先、およびメールの DelegateUser オブジェクトが新規に作成され、それぞれのフォルダーに対する編集者アクセス許可が各代理人に付与されます。 この例を変更して、DelegatePermissions プロパティで指定されたどのフォルダーにも代理人を追加できます。また、DelegateFolderPermissionLevel 列挙体で指定されたどの値にもアクセス許可を設定できます。
この例では、service はメールボックス所有者の有効な ExchangeService オブジェクトであり、ユーザーは 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;
}
EWS を使用して代理人を追加する
次のコード例は、AddDelegate EWS 操作を使用して予定表、連絡先、およびメールの別々の代理人を追加する方法を示しています。 変更するメールボックスは Mailbox 要素で指定され、各代理人のアクセス許可の設定は DelegateUser 要素に含まれます。 それぞれの代理人に、対象となるフォルダーに対する編集者アクセス許可が与えられます。
これは、AddDelegates メソッドを使用して代理人を追加するときに EWS マネージ API が送信する XML 要求でもあります。
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://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>
サーバーは、ResponseCode 要素値 NoError (代理人が正常に作成されたことを示す) を含む AddDelegateResponse メッセージで、AddDelegate 要求に応答します。
<?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="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://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="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://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>
EWS マネージ API を使用して代理人を削除する
ExchangeService.RemoveDelegates EWS マネージ API メソッドを使用して、対象のメールボックスから代理人を削除できます。 この例では、代理人の追加の例で設定された代理人アクセス許可が削除されます。
この例では、service はメールボックス所有者の有効な ExchangeService オブジェクトであり、ユーザーは 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;
}
EWS を使用して代理人を削除する
RemoveDelegate EWS 操作を使用して、メールボックスから代理人を削除できます。 この例では、代理人の追加の例で設定された代理人アクセス許可が削除されます。
これは、RemoveDelegates メソッドを使用して代理人を削除するときに EWS マネージ API が送信する XML 要求でもあります。
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://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>
サーバーは、値が (代理人が正常に削除されたことを示す) NoError に設定された ResponseCode 要素を含む AddDelegateResponse メッセージで、RemoveDelegate 要求に応答します。
次の手順
予定表、メール、およびタスクのフォルダーに代理人を追加すると、代理人はフォルダー内のアイテムにアクセスできるようになります。 詳細については、次の記事を参照してください。
代理人を追加したフォルダーに、代理人にアクセス権限を付与する前に作成された子フォルダーが含まれている場合、代理人は追加のアクセス許可がなければ、それらの子フォルダーにアクセスできません。 他のフォルダーに対するアクセス許可を追加または更新するには、「Exchange で EWS を使用して別のユーザーのフォルダーのアクセス許可を設定する」を参照してください。