Операция RemoveDistributionGroupFromImListRemoveDistributionGroupFromImList operation

Поиск сведений о RemoveDistributionGroupFromImListной операции EWS.Find information about the RemoveDistributionGroupFromImList EWS operation.

Операция RemoveDistributionGroupFromImList удаляет группу рассылки из списка мгновенных сообщений LYNC (IM), когда Lync использует Exchange для хранилища контактов.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.

Использование операции RemoveDistributionGroupFromImListUsing the RemoveDistributionGroupFromImList operation

Операция RemoveDistributionGroupFromImList принимает один аргумент, определяющий группу рассылки, которую необходимо удалить из списка обмена мгновенными сообщениями Lync, хранящегося на сервере Exchange.The RemoveDistributionGroupFromImList operation accepts a single argument that identifies a distribution group to remove from the Lync IM list stored on an Exchange server.

Заголовки SOAP операции RemoveDistributionGroupFromImListRemoveDistributionGroupFromImList 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
ексчанжеимперсонатионExchangeImpersonation
Идентифицирует пользователя, который олицетворяет клиентское приложение.Identifies the user whom the client application is impersonating. Этот заголовок является применимым для запроса.This header is applicable to a request.
маилбокскултуреMailboxCulture
маилбокскултуреMailboxCulture
Определяет язык и региональные параметры, определенные в документе 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.
рекуестверсионRequestVersion
рекуестсерверверсионRequestServerVersion
Определяет версию схемы для запроса операции.Identifies the schema version for the operation request. Этот заголовок является применимым для запроса.This header is applicable to a request.
серверверсионServerVersion
серверверсионинфоServerVersionInfo
Определяет версию сервера, который ответил на запрос.Identifies the version of the server that responded to the request. Этот заголовок является применимым для отклика.This header is applicable to a response.

Пример запроса операции RemoveDistributionGroupFromImList: Удаление группы рассылки из списка обмена мгновенными сообщениямиRemoveDistributionGroupFromImList operation request example: Remove a distribution group from an IM list

В следующем примере запроса операции RemoveDistributionGroupFromImList показано, как удалить группу рассылки из группы обмена мгновенными сообщениями.The following example of a RemoveDistributionGroupFromImList operation request shows how to remove a distribution group from an IM group. Операция RemoveDistributionGroupFromImList принимает уникальный идентификатор группы, чтобы определить группу рассылки, которую требуется удалить из списка обмена мгновенными сообщениями.The RemoveDistributionGroupFromImList operation accepts the unique group identifier to identify the distribution group to remove from the IM list. Элемент ексчанжестореид , который возвращается в ответе для операции GetImItemList , и Операция AddDistributionGroupToImList идентифицирует группы рассылки, которые можно удалить из списка мгновенных сообщений.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:

Успешный отклик операции RemoveDistributionGroupFromImListSuccessful RemoveDistributionGroupFromImList operation response

В следующем примере показан успешный ответ на запрос операции 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:

Пример ответа на сообщение об ошибке операции RemoveDistributionGroupFromImListRemoveDistributionGroupFromImList 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