Exchange の偽装を使用して予定を追加する

[アーティクル]
07/17/2024

Exchange の EWS マネージ API または EWS で偽造を使用し、ユーザーの予定表に予定を追加する方法について説明します。

ApplicationImpersonationロールが有効になっているサービスアカウントを使用して、予定を Exchange 予定表に直接挿入するサービスアプリケーションを作成できます。偽装を使用すると、アプリケーションがユーザーとして動作し、ユーザーが Outlook などのクライアントを使用して予定表に予定を追加するかのように動作します。

偽装を使用する場合は、次のことに注意してください。

ExchangeService オブジェクトは、サービスアカウントにバインドする必要があります。同じ ExchangeService オブジェクトを使用して、複数のアカウントを偽装できます。その場合、偽装する各アカウント用に ImpersonatedUserId プロパティを変更します。
偽装されたアカウントに保存するアイテムは、1 回のみ使用できます。たとえば、複数のアカウントで同じ予定を保存する場合は、アカウントごとに予定オブジェクトを作成する必要があります。

前提条件

アプリケーションでは、偽装を使用する前に、Exchange サーバーへの接続に使用するアカウントが必要です。アクセスするアカウントのアプリケーション偽装の役割が付与されているアプリケーションのサービスアカウントを使用することをお勧めします。詳細については、「偽装を構成する」を参照してください。

EWS マネージ API で偽装を使用して予定を追加する

次の例では、1 つ以上の Exchange アカウントの予定表に予定または会議を追加します。メソッドは、次の 3 つのパラメーターを受け取ります。

service — Exchange Server のサービスアプリケーションのアカウントにバインドされる ExchangeService オブジェクト。
emailAddresses — SMTP メールアドレスの文字列のリストを含む System.List オブジェクト。
factory — IAppointmentFactory インターフェイスを実装するオブジェクト。このインターフェイスには、ExchangeService オブジェクトをパラメータとして使用する GetAppointment という方法があり、予定オブジェクトを返します。 IAppointmentFactory のインターフェイスは、IAppointmentFactory インターフェイスと定義されます。

private static void CreateAppointments(ExchangeService service, List<string> emailAddresses, IAppointmentFactory factory)
{
  // Loop through the list of email addresses to add the appointment.
  foreach (var emailAddress in emailAddresses)
  {
    Console.WriteLine(string.Format("  Placing appointment in calendar for {0}.", emailAddress));
    // Set the email address of the account to get the appointment.
    service.ImpersonatedUserId = new ImpersonatedUserId(ConnectingIdType.SmtpAddress, emailAddress);
    // Get the appointment to add.
    Appointment appointment = factory.GetAppointment(service);
    // Save the appointment.
    try
    {
      if (appointment.RequiredAttendees.Count > 0)
      {
        // The appointment has attendees so send them the meeting request.
        appointment.Save(SendInvitationsMode.SendToAllAndSaveCopy);
      }
      else
      {
        // The appointment does not have attendees, so just save to calendar.
        appointment.Save(SendInvitationsMode.SendToNone);
      }
    }
    catch (ServiceResponseException ex)
    {
      Console.WriteLine(string.Format("Could not create appointment for {0}", emailAddress));
      Console.WriteLine(ex.Message);
    }
  }
}

予定を保存するときに、コードは、出席者が RequiredAttendees プロパティに追加されているかどうかを判断するための確認を行います。追加されている場合は、SendToAllAndSaveCopy 列挙値を指定して Appointment.Save メソッドが呼び出され、出席者は会議出席依頼を受信します。それ以外の場合、SendToNone 列挙値を指定して Appointment.Save メソッドが呼び出され、Appointment.IsMeeting プロパティが false に設定されて偽装されたユーザーの予定表に予定が保存されます。

IAppointmentFactory インターフェイス

偽装されたユーザーの予定表に予定を保存する場合は毎回新しい予定オブジェクトが必要なため、 IAppointmentFactory インターフェイスはそれぞれの予定オブジェクトの設定に使用されるオブジェクトを抽象化します。このバージョンは、ExchangeService オブジェクトをパラメータに使い、その ExchangeService オブジェクトにバインドされている新しい予定オブジェクトを返す、GetAppointment メソッドのみを含む単純なインターフェイスです。

interface IAppointmentFactory
{
  Appointment GetAppointment(ExchangeService service);
}

次の AppointmentFactory クラスの例は、今から 3 日の間に発生する単純な予定を返す IAppointmentFactory インターフェイスの実装を示しています。 appointment.RequiredAttendees.Add 行のコメントを解除すると、GetAppointment メソッドは会議を返し、その行に指定されたメールアドレスに、偽装されたユーザーを開催者とする会議出席依頼が届きます。

class AppointmentFactory : IAppointmentFactory
{
  public Appointment GetAppointment(ExchangeService service)
  {
    // First create the appointment to add.
    Appointment appointment = new Appointment(service);
    // Set the properties on the appointment.
    appointment.Subject = "Tennis lesson";
    appointment.Body = "Focus on backhand this week.";
    appointment.Start = DateTime.Now.AddDays(3);
    appointment.End = appointment.Start.AddHours(1);
    appointment.Location = "Tennis club";
    // appointment.RequiredAttendees.Add(new Attendee("sonyaf@contoso1000.onmicrosoft.com"));
    return appointment;
  }
}

EWS で偽装を使用して予定を追加する

EWS では、予定表の所有者の代わりにアプリケーションでカレンダーにアイテムを追加するために偽装を使用できます。次の例は、CreateItem 操作を使用して、偽装されたアカウントの予定表に予定を追加する方法を示します。

<?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="Exchange2013" />
    <t:TimeZoneContext>
      <t:TimeZoneDefinition Id="Pacific Standard Time" />
    </t:TimeZoneContext>
    <t:ExchangeImpersonation>
      <t:ConnectingSID>
        <t:SmtpAddress>alfred@contoso.com</t:SmtpAddress>
      </t:ConnectingSID>
    </t:ExchangeImpersonation>
  </soap:Header>
  <soap:Body>
    <m:CreateItem SendMeetingInvitations="SendToNone">
      <m:Items>
        <t:CalendarItem>
          <t:Subject>Tennis lesson</t:Subject>
          <t:Body BodyType="HTML">Focus on backhand this week.</t:Body>
          <t:ReminderDueBy>2013-09-19T14:37:10.732-07:00</t:ReminderDueBy>
          <t:Start>2013-09-21T19:00:00.000Z</t:Start>
          <t:End>2013-09-21T20:00:00.000Z</t:End>
          <t:Location>Tennis club</t:Location>
          <t:MeetingTimeZone TimeZoneName="Pacific Standard Time" />
        </t:CalendarItem>
      </m:Items>
    </m:CreateItem>
  </soap:Body>
</soap:Envelope>

偽装しているアカウントを指定するための SOAP ヘッダーの ExchangeImpersonation 要素の追加以外は、偽装を使用しないで予定を作成するための XML 要求と同じものを使用します。

次の例は、CreateItem 操作で返される応答 XML を表しています。

注:

ItemId 属性と ChangeKey 属性は読みやすいように短縮されています。

<?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="775" MinorBuildNumber="7" Version="V2_4" 
 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:CreateItemResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
  xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
      <m:ResponseMessages>
        <m:CreateItemResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Items>
            <t:CalendarItem>
              <t:ItemId Id="AAMkA" ChangeKey="DwAAA" />
            </t:CalendarItem>
          </m:Items>
        </m:CreateItemResponseMessage>
      </m:ResponseMessages>
    </m:CreateItemResponse>
  </s:Body>
</s:Envelope>

この場合も、偽装を使用せずに CreateItem 操作をするときに戻される XML と同じものが使用されます。

次の方法で共有

Exchange の偽装を使用して予定を追加する

前提条件

EWS マネージ API で偽装を使用して予定を追加する

IAppointmentFactory インターフェイス

EWS で偽装を使用して予定を追加する

関連項目

フィードバック

その他のリソース