Agregar y quitar direcciones de correo electrónico de la lista de remitentes bloqueados mediante el uso de EWS en ExchangeAdd and remove email addresses from the Blocked Senders List by using EWS in Exchange

Descubra cómo usar la API administrada de EWS o EWS para agregar direcciones de correo electrónico y quitarlas de la lista de remitentes bloqueados.Find out how to use the EWS Managed API or EWS to add email addresses to and remove them from the Blocked Senders List.

La lista de remitentes bloqueados de las opciones de correo no deseado de un usuario proporciona una forma de mover todos los mensajes de correo electrónico de los remitentes especificados a la carpeta de correo no deseado.The Blocked Senders List in a user's Junk Email options provides a way to move all email messages from specified senders to the Junk Email folder. Puede habilitar la API administrada de EWS o la aplicación EWS para agregar direcciones de correo electrónico o quitarlas de la lista de remitentes bloqueados.You can enable your EWS Managed API or EWS application to add email addresses to or remove them from the Blocked Senders List.

Tenga en cuenta que debe haber un mensaje de la dirección de correo electrónico en el buzón del usuario para poder agregar la dirección de correo electrónico o quitarla de la lista de remitentes bloqueados.Note that a message from the email address must exist in the user's mailbox before you can add the email address to or remove it from the Blocked Senders List. El método de la API administrada de EWS ExchangeService. MarkAsJunk y la operación de EWS MarkAsJunk usan una colección de identificadores de elemento.The ExchangeService.MarkAsJunk EWS Managed API method and the MarkAsJunk EWS operation use a collection of item IDs. Los identificadores de elemento de la colección indican los mensajes del buzón para el que se debe cambiar el estado del correo no deseado.The item IDs in the collection indicate messages in the mailbox for which the junk mail status should be changed.

Puede usar los cmdlets del shell de administración de Exchange Get-MailboxJunkEmailConfiguration y set-MailboxJunkEmailConfiguration directamente para acceder a la lista de remitentes bloqueados.You can use the Get-MailboxJunkEmailConfiguration and Set-MailboxJunkEmailConfiguration Exchange Management Shell cmdlets to access the Blocked Senders List directly.

Agregar una dirección de correo electrónico o quitarla de la lista de remitentes bloqueados mediante la API administrada de EWSAdd an email address to or remove it from the Blocked Senders List by using the EWS Managed API

Para agregar el remitente de un mensaje de correo electrónico a la lista de remitentes bloqueados, use el método MarkAsJunk y establezca el parámetro isJunk en true.To add the sender of an email message to the Blocked Senders List, use the MarkAsJunk method and set the isJunk parameter to true. Para quitar el remitente de un mensaje de correo electrónico de la lista de remitentes bloqueados, establezca el parámetro isJunk en false.To remove the sender of an email message from the Blocked Senders List, set the isJunk parameter to false.

En el ejemplo siguiente se muestra cómo usar el método MarkAsJunk para cambiar el estado de correo no deseado de un mensaje.The following example shows how to use the MarkAsJunk method to change the junk status of a message.

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());
        }
    }
}

Agregar una dirección de correo electrónico o quitarla de la lista de remitentes bloqueados mediante EWSAdd an email address to or remove it from the Blocked Senders List by using EWS

La siguiente solicitud SOAP de EWS marca un elemento como no deseado estableciendo el atributo IsJunk en el elemento MarkAsJunk en true.The following EWS SOAP request marks an item as junk by setting the IsJunk attribute on the MarkAsJunk element to true. También mueve el mensaje a la carpeta correo electrónico no deseado estableciendo el atributo MoveItem del elemento MarkAsJunk en true.It also moves the message to the Junk Email folder by setting the MoveItem attribute on the MarkAsJunk element to true.

<?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="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>

La siguiente respuesta SOAP de EWS muestra la respuesta correcta.The following EWS SOAP response shows the successful response. El elemento MovedItemId de la respuesta contiene el identificador de elemento del elemento después de su traslado.The MovedItemId element in the response contains the item ID for the item after it was moved.

<?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="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="AAMkADg1OWUwODcyLTg4M2MtNDAyMS05YjI0LTI5ZGM5OTU4Njk3YwBGAAAAAADPriAxh444TpHj2GoQxWQNBwAN+VjmVZl5Rq1ymCq5eFKOAAAAAAEbAAAN+VjmVZl5Rq1ymCq5eFKOAAAE59DIAAA="
              ChangeKey="CQAAABYAAAAN+VjmVZl5Rq1ymCq5eFKOAAAE59E+" />
        </m:MarkAsJunkResponseMessage>
      </m:ResponseMessages>
    </m:MarkAsJunkResponse>
  </s:Body>
</s:Envelope>

Vea tambiénSee also