Microsoft Exchange : workflow de recherche et de suppression d’e-mails

Rversion finale: Washingtondc

Mis à jour 1 févr. 2024

7 minutes de lecture

Lorsque le workflow Microsoft Exchange - Effectuer une recherche et une suppression d’e-mail est exécuté, il recherche le serveur Exchange à l’aide de la requête de recherche fournie et renvoie les détails à l’instance locale.

Avant de commencer

Rôle requis : sn_si.analyst

Pourquoi et quand exécuter cette tâche

Le workflow Microsoft Exchange - Effectuer une recherche et une suppression d’e-mails est exécuté lorsque les recherches d’e-mails sont configurées et que le bouton Supprimer des serveurs de messagerie ou Rechercher sur les serveurs de messagerie est enfoncé.

Les activités spécifiques à cette intégration sont décrites ici. Pour plus d’informations sur d’autres activités, voir Activités courantes du workflow d’intégration.

Créer une activité de recherche de conformité

L’activité Créer une recherche de conformité crée une recherche de conformité pour les e-mails dans le ou les serveurs Exchange désignés à l’aide des requêtes de recherche définies et renvoie le nom de la recherche de conformité créée.

Variables d'entrée

Les variables d'entrée déterminent le comportement initial de l'activité.


Variable	Description
search_query	Requête de recherche obligatoire utilisée pour trouver des e-mails dans Exchange Server dans toutes les boîtes aux lettres.
Emplacement d’échange	Champ d’emplacement obligatoire utilisé pour effectuer des recherches dans différents emplacements définis. Les valeurs possibles sont les suivantes : Tous Nom de la boîte de réception spécifique
targetId	Champ d’identificateur d’hôte cible obligatoire où se trouve Exchange Server.

Variables de sortie

Les variables de sortie contiennent des données qui peuvent être utilisées dans les activités suivantes.

Tableau 1. Variables de sortie
Variable	Description
response	Nom de la recherche de conformité créée.

Conditions de sortie

Les conditions de sortie possibles pour cette activité sont les suivantes :

Tableau 2. Conditions de sortie
Variable	Description
Échec de la création de la recherche	Lorsque la création de la recherche échoue en raison d’une exception dans le serveur Exchange.
Recherche créée avec succès	Lorsque la création de la recherche est réussie.
Échec de la création de la recherche en raison d’une erreur d’analyse	Lorsque la création d’une recherche échoue en raison d’un problème d’analyse.
« Erreur »	Lorsqu’une exception se produit dans l’activité du workflow.

Vérifier l’activité de l’état de la recherche de conformité

L’activité Vérifier l’état de la recherche de conformité vérifie l’état de la recherche de conformité créée sur le serveur Exchange et, si l’état est terminé, renvoie les informations relatives à la recherche d’e-mails trouvées pour la recherche de conformité.

Variables d'entrée

Les variables d'entrée déterminent le comportement initial de l'activité.


Variable	Description
targetId	Champ d’identificateur d’hôte cible obligatoire où se trouve Exchange Server.
searchName	Nom obligatoire de la recherche de conformité créée sur le serveur Exchange.

Variables de sortie

Les variables de sortie contiennent des données qui peuvent être utilisées dans les activités suivantes.

Tableau 3. Variables de sortie
Variable	Description
response	Contient l’état de la recherche de conformité et le nombre d’e-mails trouvés sur le serveur Exchange pour la recherche de conformité.

Conditions de sortie

Les conditions de sortie possibles pour cette activité sont les suivantes :

Tableau 4. Conditions de sortie
Variable	Description
Recherche en cours	Lorsque l’état de la recherche de conformité est en cours.
Recherche terminée : aucun e-mail de menace trouvé	Lorsque l’état de la recherche de conformité est terminé et qu’aucun e-mail n’est trouvé dans le cadre de la recherche de conformité.
Recherche terminée : e-mails de menace trouvés	Lorsque l’état de la recherche de conformité est terminé et que des e-mails sont trouvés dans le cadre de la recherche de conformité.
Erreur lors de la vérification de l’état	Lorsque la vérification de l’état échoue en raison d’une exception dans le serveur Exchange.
« Erreur »	Lorsqu’une exception se produit dans l’activité du workflow.

Créer une activité d’action d’aperçu de recherche de conformité

L’activité Créer une action d’aperçu de recherche de conformité crée une nouvelle action de recherche de conformité de type aperçu sur le serveur Exchange pour la recherche de conformité créée.

Variables d'entrée

Les variables d'entrée déterminent le comportement initial de l'activité.


Variable	Description
targetId	Champ d’identificateur d’hôte cible obligatoire où se trouve Exchange Server.
searchName	Nom obligatoire de la recherche de conformité créée sur le serveur Exchange.

Conditions de sortie

Les conditions de sortie possibles pour cette activité sont les suivantes :

Tableau 5. Conditions de sortie
Variable	Description
Terminé	Lorsque l’action de recherche de conformité est créée avec succès.
Erreur lors de la création de l’action	Lors de l’échec de la création de l’action de recherche de conformité en raison d’une exception dans le serveur Exchange.
« Erreur »	Lorsqu’une exception se produit dans l’activité du workflow.

Vérifier l’activité du statut de l’action d’aperçu

L’activité Aperçu de l’état de l’action vérifie l’état de l’action de recherche de conformité de type aperçu et renvoie les informations d’aperçu des e-mails trouvés comme le destinataire, l’expéditeur, l’objet et la date de réception de l’e-mail.

Variables d'entrée

Les variables d'entrée déterminent le comportement initial de l'activité.


Variable	Description
targetId	Champ d’identificateur d’hôte cible obligatoire où se trouve Exchange Server.
searchName	Nom obligatoire de la recherche de conformité créée sur le serveur Exchange.

Variables de sortie

Les variables de sortie contiennent des données qui peuvent être utilisées dans les activités suivantes.

Tableau 6. Variables de sortie
Variable	Description
response	Contient l’état de l’action de recherche de conformité et les informations d’aperçu de l’e-mail trouvé dans le cadre de la recherche de conformité.

Conditions de sortie

Les conditions de sortie possibles pour cette activité sont les suivantes :

Tableau 7. Conditions de sortie
Variable	Description
Aperçu en cours	Lorsque l’état de l’action de recherche de conformité est en cours.
Aucun e-mail trouvé	Lorsque l’état de l’action de recherche de conformité est terminé et qu’aucun e-mail n’est trouvé dans le cadre de la recherche de conformité.
Aperçu terminé	Lorsque l’état de l’action de recherche de conformité est terminé et que des e-mails sont trouvés dans le cadre de la recherche de conformité.
Erreur lors de la vérification de l’état	Lorsque la vérification de l’état échoue en raison d’une exception dans le serveur Exchange.
« Erreur »	Lorsqu’une exception se produit dans l’activité du workflow.

Créer une activité d’action de suppression de recherche de conformité

L’activité Créer une action de suppression de recherche de conformité crée une nouvelle action de recherche de conformité de type purge sur le serveur Exchange pour la recherche de conformité créée.

Variables d'entrée

Les variables d'entrée déterminent le comportement initial de l'activité.


Variable	Description
targetId	Champ d’identificateur d’hôte cible obligatoire où se trouve Exchange Server.
searchName	Nom obligatoire de la recherche de conformité créée sur le serveur Exchange.

Conditions de sortie

Les conditions de sortie possibles pour cette activité sont les suivantes :

Tableau 8. Conditions de sortie
Variable	Description
Terminé	Lorsque l’action de recherche de conformité est créée avec succès.
Erreur lors de la création de l’action	Lors de l’échec de la création de l’action de recherche de conformité en raison d’une exception dans le serveur Exchange.
« Erreur »	Lorsqu’une exception se produit dans l’activité du workflow.

Vérifier l’activité de statut de l’action Supprimer

L’activité Vérifier le statut de l’action Supprimer vérifie l’état de l’action de recherche de conformité de type purge et effectue une opération de suppression réversible sur le serveur Exchange pour les e-mails trouvés dans le cadre de la recherche de conformité.

Variables d'entrée

Les variables d'entrée déterminent le comportement initial de l'activité.


Variable	Description
targetId	Champ d’identificateur d’hôte cible obligatoire où se trouve Exchange Server.
searchName	Nom obligatoire de la recherche de conformité créée sur le serveur Exchange.

Variables de sortie

Les variables de sortie contiennent des données qui peuvent être utilisées dans les activités suivantes.

Tableau 9. Variables de sortie
Variable	Description
response	Contient l’état de l’action de recherche de conformité et le nombre d’e-mails supprimés, qui ont été trouvés dans le cadre de la recherche de conformité.

Conditions de sortie

Les conditions de sortie possibles pour cette activité sont les suivantes :

Tableau 10. Conditions de sortie
Variable	Description
Suppression en cours	Lorsque l’état de l’action de recherche de conformité est en cours.
Aucun e-mail trouvé	Lorsque l’état de l’action de recherche de conformité est terminé et qu’aucun e-mail n’est supprimé dans le cadre de la recherche de conformité.
Suppression terminée	Lorsque l’état de l’action de recherche de conformité est terminé et que les e-mails sont supprimés dans le cadre de la recherche de conformité.
Erreur lors de la vérification de l’état	Lorsque la vérification de l’état échoue en raison d’une exception dans le serveur Exchange.
« Erreur »	Lorsqu’une exception se produit dans l’activité du workflow.

Supprimer l’activité de recherche de conformité

L’activité Supprimer la recherche de conformité supprime la recherche de conformité créée du serveur Exchange.

Variables d'entrée

Les variables d'entrée déterminent le comportement initial de l'activité.


Variable	Description
targetId	Champ d’identificateur d’hôte cible obligatoire où se trouve Exchange Server.
searchName	Nom obligatoire de la recherche de conformité créée sur le serveur Exchange.