Ajouter et supprimer des adresses e-mail de la liste des expéditeurs bloqués à l’aide d’EWS dans Exchange

  • Article

Découvrez comment utiliser l’API managée EWS ou EWS pour ajouter des adresses e-mail et les supprimer de la liste des expéditeurs bloqués.

Les options Liste des expéditeurs bloqués dans le Email indésirable d’un utilisateur permettent de déplacer tous les messages électroniques des expéditeurs spécifiés vers le dossier Email indésirables. Vous pouvez activer votre API managée EWS ou votre application EWS pour ajouter des adresses e-mail ou les supprimer de la liste des expéditeurs bloqués.

Notez qu’un message de l’adresse e-mail doit exister dans la boîte aux lettres de l’utilisateur avant que vous puissiez ajouter l’adresse e-mail à ou la supprimer de la liste des expéditeurs bloqués. La méthode d’API managée EWS ExchangeService.MarkAsJunk et l’opération EWS MarkAsJunk utilisent une collection d’ID d’élément. Les ID d’élément dans la collection indiquent les messages de la boîte aux lettres pour lesquels l’état du courrier indésirable doit être modifié.

Vous pouvez utiliser les applets de commande Get-MailboxJunkEmailConfiguration et Set-MailboxJunkEmailConfiguration Exchange Management Shell pour accéder directement à la liste des expéditeurs bloqués.

Ajoutez une adresse e-mail à ou supprimez-la de la liste des expéditeurs bloqués à l’aide de l’API managée EWS

Pour ajouter l’expéditeur d’un e-mail à la liste des expéditeurs bloqués, utilisez la méthode MarkAsJunk et définissez le paramètre isJunk sur true. Pour supprimer l’expéditeur d’un e-mail de la liste des expéditeurs bloqués, définissez le paramètre isJunk sur false.

L’exemple suivant montre comment utiliser la méthode MarkAsJunk pour modifier l’état du courrier indésirable d’un 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());
        }
    }
}

Ajouter une adresse e-mail à ou la supprimer de la liste des expéditeurs bloqués à l’aide d’EWS

La requête SOAP EWS suivante marque un élément comme indésirable en définissant l’attribut IsJunk sur l’élément MarkAsJunk sur true. Il déplace également le message vers le dossier Junk Email en définissant l’attribut MoveItem sur l’élément MarkAsJunk sur 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 réponse SOAP EWS suivante montre la réponse réussie. L’élément MovedItemId dans la réponse contient l’ID de l’élément après son déplacement.

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

Voir aussi