Freigeben über


Hinzufügen und Entfernen von E-Mail-Adressen von der Liste blockierter Absender mithilfe von EWS in Exchange

Erfahren Sie, wie Sie die verwaltete EWS-API oder EWS verwenden, um E-Mail-Adressen hinzuzufügen und aus der Liste blockierter Absender zu entfernen.

Die Liste blockierter Absender in den Junk-Email-Optionen eines Benutzers bietet eine Möglichkeit, alle E-Mail-Nachrichten von angegebenen Absendern in den Junk-Email Ordner zu verschieben. Sie können Ihre verwaltete EWS-API oder EWS-Anwendung aktivieren, um E-Mail-Adressen zur Liste blockierter Absender hinzuzufügen oder aus der Liste blockierter Absender zu entfernen.

Beachten Sie, dass eine Nachricht aus der E-Mail-Adresse im Postfach des Benutzers vorhanden sein muss, bevor Sie die E-Mail-Adresse der Liste blockierter Absender hinzufügen oder daraus entfernen können. Die ExchangeService.MarkAsJunk EWS Managed API-Methode und der EwS-Vorgang MarkAsJunk verwenden eine Auflistung von Element-IDs. Die Element-IDs in der Sammlung geben Nachrichten im Postfach an, für die der Junk-E-Mail-Status geändert werden soll.

Sie können die Exchange-Verwaltungsshell-Cmdlets Get-MailboxJunkEmailConfiguration und Set-MailboxJunkEmailConfiguration verwenden, um direkt auf die Liste blockierter Absender zuzugreifen.

Hinzufügen einer E-Mail-Adresse zu oder Entfernen der E-Mail-Adresse zur Liste blockierter Absender mithilfe der verwalteten EWS-API

Um den Absender einer E-Mail-Nachricht der Liste blockierter Absender hinzuzufügen, verwenden Sie die MarkAsJunk-Methode , und legen Sie den isJunk-Parameter auf true fest. Um den Absender einer E-Mail-Nachricht aus der Liste blockierter Absender zu entfernen, legen Sie den parameter isJunk auf false fest.

Das folgende Beispiel zeigt, wie Sie die MarkAsJunk-Methode verwenden, um den Junk-Status einer Nachricht zu ändern.

private static void MarkMessageAsJunk(ExchangeService service, ItemId messageId, bool isJunk, bool moveItem)
{
    List<ItemId> junkItemIds = new List<ItemId>();
    junkItemIds.Add(messageId);
    ServiceResponseCollection<MarkAsJunkResponse> responseCollection = null;
    try
    {
        // If isJunk is true, the sender of the email message is added to 
        // the Blocked Senders List. If isJunk is false, the sender is removed
        // from the list (if present).
        responseCollection = service.MarkAsJunk(junkItemIds, isJunk, moveItem);
    }
    catch (ServiceResponseException ex)
    {
        Console.WriteLine("Error marking item as junk: {0}", ex.ErrorCode);
        return;
    }
    foreach (MarkAsJunkResponse response in responseCollection)
    {
        if (response.Result == ServiceResult.Success)
        {
            Console.WriteLine("Successfully marked message as {0}junk.", isJunk ? "": "NOT ");
            if (moveItem)
            {
                Console.WriteLine("New item ID: {0}", response.MovedItemId.ToString());
            }
        }
        else
        {
            Console.WriteLine("[{0}]: {1}", response.Result.ToString(),
                response.ErrorCode.ToString());
        }
    }
}

Hinzufügen einer E-Mail-Adresse zu oder Entfernen der E-Mail-Adresse zur Liste blockierter Absender mithilfe von EWS

Die folgende EWS SOAP-Anforderung markiert ein Element als Junk-E-Mail, indem das IsJunk-Attribut für das MarkAsJunk-Element auf true festgelegt wird. Außerdem wird die Nachricht in den Ordner Junk Email verschoben, indem das MoveItem-Attribut für das MarkAsJunk-Element auf true festgelegt wird.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
    xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
    xmlns:soap="https://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="AAMkADg1OWUwODcyLTg4M2MtNDAyMS05YjI0LTI5ZGM5OTU4Njk3YwBGAAAAAADPriAxh444TpHj2GoQxWQNBwAN+VjmVZl5Rq1ymCq5eFKOAAAAAAENAAAN+VjmVZl5Rq1ymCq5eFKOAAAAAAEuAAA=" 
            ChangeKey="CQAAABYAAAAN+VjmVZl5Rq1ymCq5eFKOAAAAAADi" />
      </m:ItemIds>
    </m:MarkAsJunk>
  </soap:Body>
</soap:Envelope>

Die folgende EWS SOAP-Antwort zeigt die erfolgreiche Antwort. Das MovedItemId-Element in der Antwort enthält die Element-ID für das Element, nachdem es verschoben wurde.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="https://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:ServerVersionInfo MajorVersion="15" MinorVersion="0" MajorBuildNumber="712" MinorBuildNumber="22" Version="V2_3" 
        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">
    <m:MarkAsJunkResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
        xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
      <m:ResponseMessages>
        <m:MarkAsJunkResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:MovedItemId Id="AAMkADg1OWUwODcyLTg4M2MtNDAyMS05YjI0LTI5ZGM5OTU4Njk3YwBGAAAAAADPriAxh444TpHj2GoQxWQNBwAN+VjmVZl5Rq1ymCq5eFKOAAAAAAEbAAAN+VjmVZl5Rq1ymCq5eFKOAAAE59DIAAA="
              ChangeKey="CQAAABYAAAAN+VjmVZl5Rq1ymCq5eFKOAAAE59E+" />
        </m:MarkAsJunkResponseMessage>
      </m:ResponseMessages>
    </m:MarkAsJunkResponse>
  </s:Body>
</s:Envelope>

Siehe auch