Adddeploy Grouptoimlist 操作AddDistributionGroupToImList operation

Adddeploy Grouptoimlist EWS 操作についての情報を検索します。Find information about the AddDistributionGroupToImList EWS operation.

Adddistribution Grouptoimlist Exchange Web SERVICES (EWS) 操作は、統合連絡先ストアのインスタントメッセージング (IM) リストに配布グループを追加します。The AddDistributionGroupToImList Exchange Web Services (EWS) operation adds a distribution group to the instant messaging (IM) list in the Unified Contact Store.

この操作は Exchange Server 2013 で導入されました。This operation was introduced in Exchange Server 2013.

Adddeploy Grouptoimlist 操作の使用Using the AddDistributionGroupToImList operation

Adddistribution Grouptoimlist操作は、IM リストに追加する配布グループを識別する1つの引数を受け取ります。The AddDistributionGroupToImList operation takes a single argument that identifies a distribution group to add to the IM list. この操作では、配布グループは作成されません。配布グループは既に作成されている必要があります。This operation does not create a distribution group; the distribution group must already be created.

この操作では、次の表に記載されている SOAP ヘッダーを使用できます。This operation can use the SOAP headers that are listed in the following table.

表1Adddeploy Grouptoimlist 操作 SOAP ヘッダーTable 1. AddDistributionGroupToImList operation SOAP headers

ヘッダー名Header name 要素Element 説明Description
偽装Impersonation
ExchangeImpersonationExchangeImpersonation
クライアントアプリケーションが偽装しているユーザーを識別します。Identifies the user whom the client application is impersonating. これは要求に適用されます。This is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
RFC 3066 で定義されているように、メールボックスへのアクセスに使用されるカルチャ (言語の識別用のタグ) を識別します。Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. これは要求に適用されます。This is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
操作要求のスキーマバージョンを識別します。Identifies the schema version for the operation request. これは要求に適用されます。This is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
要求に応答したサーバーのバージョンを識別します。Identifies the version of the server that responded to the request. これは応答に適用されます。This is applicable to a response.

Adddeploy Grouptoimlist 操作要求の例AddDistributionGroupToImList operation request example

次のAdddistribution Grouptoimlist操作要求の例は、配布グループを IM リストに追加する方法を示しています。The following example of an AddDistributionGroupToImList operation request shows how to add a distribution group to the IM list.

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
      <t:MailboxCulture>en-US</t:MailboxCulture>
   </soap:Header>
   <soap:Body >
      <m:AddDistributionGroupToImList>
         <m:SmtpAddress>distributionlist1@example.com</m:SmtpAddress>
      </m:AddDistributionGroupToImList>
   </soap:Body>
</soap:Envelope>

要求 SOAP 本文には、次の要素が含まれています。The request SOAP body contains the following elements:

Adddeploy Grouptoimlist 操作応答の成功Successful AddDistributionGroupToImList operation response

次の例は、 Adddeploy Grouptoimlist操作要求に対する正常な応答を示しています。The following example shows a successful response to an AddDistributionGroupToImList operation request.

成功した応答には、配布グループの表示名、配布グループの Exchange ストアクラス、および新しい配布グループの EWS 識別子が含まれます。The successful response contains the distribution group display name, the Exchange store class for the distribution group, and the EWS identifier of the new distribution group.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
            xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
            xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
   <s:Header>
      <t:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="349" 
                           MinorBuildNumber="0" 
                           Version="Exchange2013"/>
   </s:Header>
   <s:Body>
      <m:AddDistributionGroupToImListResponse ResponseClass="Success">
         <m:ResponseCode>NoError</m:ResponseCode>
         <m:ImGroup>
            <t:DisplayName>distributionlist1@example.com</t:DisplayName>
            <t:GroupType>IPM.DistList.MOC.DG</t:GroupType>
            <t:ExchangeStoreId Id="AAMkAGQ1MjJjAA=" 
                             ChangeKey="EgAAAA=="/>
      </m:ImGroup>
      </m:AddDistributionGroupToImListResponse>
   </s:Body>
</s:Envelope>

応答 SOAP 本文には、次の要素が含まれています。The response SOAP body contains the following elements:

Adddeploy Grouptoimlist 操作 ErrorInvalidImDistributionGroupSmtpAddress エラー応答AddDistributionGroupToImList operation ErrorInvalidImDistributionGroupSmtpAddress error response

次の例は、 Adddeploy Grouptoimlist操作要求へのエラー応答を示しています。The following example shows an error response to an AddDistributionGroupToImList operation request. Exchange ストアに存在しない配布グループを追加しようとすると、次のエラー応答が発生します。The following error response occurs when an attempt is made to add a distribution group that does not exist in the Exchange store.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="349" 
                           MinorBuildNumber="0" 
                           Version="Exchange2013" 
                           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">
      <AddDistributionGroupToImListResponse ResponseClass="Error" 
                                            xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>The specified IM distribution group SMTP address is invalid.</MessageText>
         <ResponseCode>ErrorInvalidImDistributionGroupSmtpAddress</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </AddDistributionGroupToImListResponse>
   </s:Body>
</s:Envelope>

エラー応答 SOAP 本文には、次の要素が含まれています。The error response SOAP body contains the following elements:

関連項目See also