AddImGroup 操作
查找有关 AddImGroup EWS 操作的信息。
AddImGroup Exchange Web Services (EWS) 操作将新的即时消息 (IM) 组添加到邮箱。
Exchange Server 2013 中引入了此操作。
使用 AddImGroup 操作
AddImGroup 操作仅采用单个显示名称参数。
此操作返回新组的显示名称、组类型和 Exchange 存储标识符。
AddImGroup 操作可以使用下表中列出的 SOAP 标头。
表 1. AddImGroup 操作 SOAP 标头
| 标头名称 | 元素 | 说明 |
|---|---|---|
| 模拟 |
ExchangeImpersonation |
标识客户端应用程序正在模拟的用户。 这适用于请求。 |
| MailboxCulture |
MailboxCulture |
标识要用于访问邮箱的区域性，如 RFC 3066“标识语言标记”中所述。 这适用于请求。 |
| RequestVersion |
RequestServerVersion |
标识操作请求的架构版本。 这适用于请求。 |
| ServerVersion |
ServerVersionInfo |
标识响应请求的服务器版本。 这适用于响应。 |
AddImGroup 操作请求示例：创建新的 IM 组
下面的 AddImGroup 操作请求示例演示如何创建名为 MyCustomerGroup 的 IM 组。
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013" />
<t:MailboxCulture>en-US</t:MailboxCulture>
</soap:Header>
<soap:Body >
<m:AddImGroup>
<m:DisplayName>MyCustomGroup</m:DisplayName>
</m:AddImGroup>
</soap:Body>
</soap:Envelope>
请求 SOAP 正文包含以下元素：
成功的 AddImGroup 操作响应
以下示例显示了 对 AddImGroup 操作请求的成功响应。
<?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="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">
<AddImGroupResponse ResponseClass="Success"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<ResponseCode>NoError</ResponseCode>
<ImGroup>
<DisplayName xmlns="http://schemas.microsoft.com/exchange/services/2006/types">MyCustomGroup</DisplayName>
<GroupType xmlns="http://schemas.microsoft.com/exchange/services/2006/types">IPM.DistList.MOC.UserGroup</GroupType>
<ExchangeStoreId Id="AAMkAGQ1MjJjMTBkLTc4Y2UtNDA5Ny04ZjU5LWI3MAAA="
ChangeKey="EgAAAA=="
xmlns="http://schemas.microsoft.com/exchange/services/2006/types"/>
</ImGroup>
</AddImGroupResponse>
</s:Body>
</s:Envelope>
响应 SOAP 正文包含以下元素：
AddImGroup 操作错误响应
以下示例显示了 对 AddImGroup 操作请求的错误响应。 这是对包含不能在显示名称中使用的字符的请求的响应。 请注意，这是 SOAP 错误，而不是基于架构的错误消息。 请求中提交的显示名称为 ~！@#$%^&，& 字符上发生错误。 & 字符出现在请求有效负载中的第 11 行和第 33 个字符上。 响应是使用 HTTP 500 代码返回的。
<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<s:Fault>
<faultcode xmlns:a="http://schemas.microsoft.com/exchange/services/2006/types">a:ErrorSchemaValidation</faultcode>
<faultstring xml:lang="en-US">The request failed schema validation: An error occurred while parsing EntityName. Line 11, position 33.</faultstring>
<detail>
<e:ResponseCode xmlns:e="http://schemas.microsoft.com/exchange/services/2006/errors">ErrorSchemaValidation</e:ResponseCode>
<e:Message xmlns:e="http://schemas.microsoft.com/exchange/services/2006/errors">The request failed schema validation.</e:Message>
<t:MessageXml xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<t:LineNumber>11</t:LineNumber>
<t:LinePosition>33</t:LinePosition>
<t:Violation>An error occurred while parsing EntityName. Line 11, position 33.</t:Violation>
</t:MessageXml>
</detail>
</s:Fault>
</s:Body>
</s:Envelope>