Share via

MarkAsJunk 操作

  • 项目

查找有关 MarkAsJunk EWS 操作的信息。

MarkAsJunk 操作从阻止的电子邮件列表中添加和删除用户，并将电子邮件移动到“垃圾邮件Email”文件夹。

Exchange Server 2013 中引入了此操作。

使用 MarkAsJunk 操作

MarkAsJunk 操作包含两个布尔选项，用于指示是否应将电子邮件发件人添加到阻止的发件人列表，以及是否应将目标电子邮件移动到默认的“垃圾邮件Email”文件夹或“收件箱”文件夹。 操作由 IsJunk 和 MoveItem 属性的值确定。 以下是基于 IsJunk 和 MoveItem 属性的值组合可能执行的操作：

  • 如果 IsJunk 属性设置为 true，并且 MoveItem 属性设置为 true，则目标电子邮件的发件人将添加到阻止的发件人列表，并将电子邮件移动到垃圾邮件 Dmail 文件夹。

  • 如果 IsJunk 属性设置为 true，并且 MoveItem 属性设置为 false，则目标电子邮件的发件人将添加到阻止的发件人列表中，并且不会从文件夹中移动电子邮件。

  • 如果 IsJunk 属性设置为 false，并且 MoveItem 属性设置为 true，则会从阻止的发件人列表中删除目标电子邮件的发件人，并将电子邮件移动到“收件箱”文件夹。

  • 如果 IsJunk 属性设置为 false，并且 MoveItem 属性设置为 false，则会从阻止的发件人列表中删除目标电子邮件的发件人，并且不会从文件夹中移动电子邮件。

重要

阻止的发件人列表的内容无法从 EWS 中发现。 如果将发件人添加到阻止的发件人列表中，则需要保留受阻止发件人发送的电子邮件的副本，以便将来取消阻止该发件人。

MarkAsJunk 操作 SOAP 标头

MarkAsJunk 操作可以使用下表中列出的 SOAP 标头。

标头名称 元素 说明
模拟
ExchangeImpersonation
标识客户端应用程序正在模拟的用户。 此标头适用于请求。
MailboxCulture
MailboxCulture
标识要用于访问邮箱的区域性，如 RFC 3066“标识语言标记”中所述。 此标头适用于请求。
RequestVersion
RequestServerVersion
标识操作请求的架构版本。 此标头适用于请求。
ServerVersion
ServerVersionInfo
标识响应请求的服务器版本。 此标头适用于响应。

MarkAsJunk 操作请求示例：将发件人添加到阻止的发件人列表

以下 MarkAsJunk 操作请求示例演示如何将电子邮件的发件人添加到阻止的发件人列表，并将电子邮件移动到垃圾邮件文件夹。 MarkAsJunk 操作接受唯一的电子邮件标识符，以标识用于引用添加到阻止发件人列表的发件人的电子邮件。

注意

为了保持可读性，本文中的所有项标识符和更改键都已缩短。

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
        <t:RequestServerVersion Version="Exchange2013" />
    </soap:Header>
    <soap:Body>
        <m:MarkAsJunk IsJunk="true" MoveItem="true">
            <m:ItemIds>
                <t:ItemId Id="AAMkAD=" ChangeKey="CQAAABYA" />
            </m:ItemIds>
        </m:MarkAsJunk>
    </soap:Body>
</soap:Envelope>

请求 SOAP 正文包含以下元素：

成功的 MarkAsJunk 操作响应

以下示例显示了对 MarkAsJunk 操作请求的成功响应，请求将发件人添加到阻止的发件人列表，并将电子邮件移动到“垃圾邮件Email”文件夹。

<?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="545" 
                             MinorBuildNumber="11" 
                             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">
        <m:MarkAsJunkResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                              xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
           <m:ResponseMessages>
               <m:MarkAsJunkResponseMessage ResponseClass="Success">
                  <m:ResponseCode>NoError</m:ResponseCode>
                 <m:MovedItemId Id="AAMkAD=" ChangeKey="CQAAABYu" />
               </m:MarkAsJunkResponseMessage>
           </m:ResponseMessages>
        </m:MarkAsJunkResponse>
    </s:Body>
</s:Envelope>

响应 SOAP 正文包含以下元素：

MarkAsJunk 操作请求示例：从阻止的发件人列表中删除发件人

以下 MarkAsJunk 操作请求示例演示如何从阻止发件人列表中删除电子邮件的发件人，并将电子邮件移动到“收件箱”文件夹。 你需要保留被阻止发件人发送的电子邮件，才能从阻止的发件人列表中删除该发件人。 发件人的电子邮件地址与发件人发送的电子邮件相关联。 如果用户的邮箱中不再存在引用电子邮件，则从阻止的发件人列表中删除发件人不会成功。 用于将电子邮件与其发件人关联的项目标识符必须与 Exchange 邮箱中存在的项目相关联。 建议创建一个隐藏文件夹来存储以前阻止的发件人发送的项目，以便可以从客户端应用程序中取消阻止发件人。 如果某个项目已从 Exchange 邮箱中删除，管理员必须使用Exchange 管理控制台访问阻止的发件人列表，以从列表中删除发件人。 有关如何使用Exchange 管理控制台取消阻止用户的信息，请参阅如何在 Office 365 中配置安全发件人和阻止发件人设置。

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
    </soap:Header>
    <soap:Body>
      <m:MarkAsJunk IsJunk="false" MoveItem="true">
        <m:ItemIds>
          <t:ItemId Id="AAMkAD=" ChangeKey="CQAAABYu" />
        </m:ItemIds>
      </m:MarkAsJunk>
    </soap:Body>
 </soap:Envelope>

从阻止发件人列表中删除发件人的成功响应与将发件人添加到阻止发件人列表的响应相同。

请求 SOAP 正文包含以下元素：

MarkAsJunk 操作错误响应

以下示例显示了 对 MarkAsJunk 操作请求的错误响应。 这是对在邮箱中不再存在项目标识符指定的电子邮件时，在阻止发件人列表中添加或删除发件人的请求的响应。

<?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="545" 
                         MinorBuildNumber="11" 
                         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">
    <m:MarkAsJunkResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                          xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
      <m:ResponseMessages>
        <m:MarkAsJunkResponseMessage ResponseClass="Error">
          <m:MessageText>The specified object was not found in the store.</m:MessageText>
          <m:ResponseCode>ErrorItemNotFound</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
        </m:MarkAsJunkResponseMessage>
      </m:ResponseMessages>
    </m:MarkAsJunkResponse>
  </s:Body>
</s:Envelope>

错误响应 SOAP 正文包含以下元素：

另请参阅