Activité Query AD

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture

    • L’activité Query AD récupère les entrées de Windows Active Directory en fonction d’un filtre de recherche LDAP et stocke les résultats sous forme de chaîne JSON qui peut être utilisée dans le bus de données.

    Pour accéder à cette activité dans l’Éditeur de workflow, sélectionnez l’onglet Personnalisé , puis accédez à Activités personnalisées > Active Directory > .
    Remarque :
    Cette activité remplace une activité AD portant le même nom disponible dans les versions antérieures à Geneva. Si vous disposez d’un workflow qui utilise l’activité déconseillée, votre workflow continuera de fonctionner normalement après la mise à niveau vers Istanbul et continuera d’enregistrer les résultats de la requête dans le bloc-notes. Toutefois, tous les nouveaux workflows doivent utiliser la version personnalisée de cette activité. Cette activité a été créée avec le Créer une activité PowerShell, qui stocke les variables d’entrée et de sortie dans le bus de données au lieu du bloc-notes.

    Variables d'entrée

    Tableau 1. Interroger les variables d’entrée AD
    Variable Description
    Contrôleur de domaine Adresse IP de l’ordinateur du contrôleur de domaine.
    Propriétés Liste de propriétés Active Directory séparées par des virgules à renvoyer. Par exemple, givenName,SN,title. Si ce champ est vide, toutes les propriétés sont renvoyées.
    Filtre de recherche Une chaîne de filtre LDAP qui définit les paramètres de recherche. Utilisez n’importe quel critère de filtrage LDAP valide. Par exemple, pour trouver des comptes utilisateur correspondant à l’enregistrement d’entrée ServiceNow , utilisez :
    (samaccountname=${workflow.inputs.u_user.user_name})

    Variables de sortie

    Tableau 2. Interroger les variables de sortie AD
    Variable Description
    résultat Soit le succès, soit l’échec.
    errorMessage Le executionResult.errorMessages du Sources d’analyse de Concepteur d’activité.
    sortie Le résultat de la requête.

    Conditions

    Tableau 3. Conditions AD de requête
    Condition Description
    Succès La requête s’est terminée comme prévu.
    Échec Une erreur s’est produite lors du traitement de la requête. Des détails supplémentaires peuvent être disponibles dans le journal des workflows.