RemoveDistributionGroupFromImList 操作RemoveDistributionGroupFromImList operation

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

RemoveDistributionGroupFromImList操作では、lync が連絡先ストアに対して Exchange を使用している場合に、lync インスタントメッセージング (IM) リストから配布グループを削除します。The RemoveDistributionGroupFromImList operation removes a distribution group from the Lync instant messaging (IM) list when Lync uses Exchange for the contact store.

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

RemoveDistributionGroupFromImList 操作の使用Using the RemoveDistributionGroupFromImList operation

RemoveDistributionGroupFromImList操作は、Exchange サーバーに格納されている Lync IM リストから削除する配布グループを識別する1つの引数を受け取ります。The RemoveDistributionGroupFromImList operation accepts a single argument that identifies a distribution group to remove from the Lync IM list stored on an Exchange server.

RemoveDistributionGroupFromImList 操作の SOAP ヘッダーRemoveDistributionGroupFromImList operation SOAP headers

RemoveDistributionGroupFromImList操作では、次の表に示す SOAP ヘッダーを使用できます。The RemoveDistributionGroupFromImList operation can use the SOAP headers that are listed in the following table.

ヘッダー名Header name 要素Element 説明Description
偽装Impersonation
ExchangeImpersonationExchangeImpersonation
クライアントアプリケーションが偽装しているユーザーを識別します。Identifies the user whom the client application is impersonating. このヘッダーは、要求に適用されます。This header 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 header is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
操作要求のスキーマバージョンを識別します。Identifies the schema version for the operation request. このヘッダーは、要求に適用されます。This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
要求に応答したサーバーのバージョンを識別します。Identifies the version of the server that responded to the request. このヘッダーは応答に適用されます。This header is applicable to a response.

RemoveDistributionGroupFromImList 操作要求の例: IM リストから配布グループを削除するRemoveDistributionGroupFromImList operation request example: Remove a distribution group from an IM list

次のRemoveDistributionGroupFromImList操作要求の例は、IM グループから配布グループを削除する方法を示しています。The following example of a RemoveDistributionGroupFromImList operation request shows how to remove a distribution group from an IM group. RemoveDistributionGroupFromImList操作は、IM リストから削除する配布グループを識別する一意のグループ識別子を受け入れます。The RemoveDistributionGroupFromImList operation accepts the unique group identifier to identify the distribution group to remove from the IM list. Getimitemlist 操作Adddistribution grouptoimlist 操作の応答で返されるExchangeStoreId要素は、IM リストから削除できる配布グループを識別します。The ExchangeStoreId element that is returned in the response for the GetImItemList operation and the AddDistributionGroupToImList operation identifies distribution groups that can be removed from the IM list.

注意

この記事のすべてのアイテム識別子と変更キーは、読みやすくするために短縮されています。All item identifiers and change keys in this article have been shortened to preserve readability.

<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:RemoveDistributionGroupFromImList>
         <m:GroupId Id="AAMkADEzO4QrAABmEh5oAAA="/>
      </m:RemoveDistributionGroupFromImList>
   </soap:Body>
</soap:Envelope>

要求 SOAP 本文では、次の要素が使用されます。The following elements are used in the request SOAP body:

成功した RemoveDistributionGroupFromImList 操作の応答Successful RemoveDistributionGroupFromImList operation response

次の例は、IM グループから配布グループを削除するためのRemoveDistributionGroupFromImList操作要求に対する正常な応答を示しています。The following example shows a successful response to a RemoveDistributionGroupFromImList operation request to a remove a distribution group from an IM group.

<?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="556" 
                           MinorBuildNumber="8" 
                           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">
      <RemoveDistributionGroupFromImListResponse ResponseClass="Success" 
                                                 xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
      </RemoveDistributionGroupFromImListResponse>
   </s:Body>
</s:Envelope>

応答 SOAP 本文では、次の要素が使用されます。The following elements are used in the response SOAP body:

RemoveDistributionGroupFromImList 操作エラー応答の例RemoveDistributionGroupFromImList operation error response example

次の例は、 RemoveDistributionGroupFromImList操作要求へのエラー応答を示しています。The following example shows an error response to a RemoveDistributionGroupFromImList operation request. これは、既にメールボックスから削除されている配布グループを削除する要求に対する応答です。This is a response to a request to remove a distribution group that has already been removed from the mailbox.

<?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="556" 
                           MinorBuildNumber="8" 
                           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">
      <RemoveDistributionGroupFromImListResponse ResponseClass="Error" 
                                                 xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>The specified object was not found in the store.</MessageText>
         <ResponseCode>ErrorItemNotFound</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </RemoveDistributionGroupFromImListResponse>
   </s:Body>
</s:Envelope>

エラー応答 SOAP 本文では、次の要素が使用されます。The following elements are used in the error response SOAP body:

関連項目See also