Aktivität „AD-Objekt aktualisieren“

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer

    • Die Aktivität „AD-Objekt aktualisieren“ aktualisiert ein Objekt in Windows Active Directory.

    Diese Aktivität ersetzt nur vorhandene Werte durch neue Werte. Damit können keine neuen Werte zu AD-Datensätzen hinzugefügt werden, z. B. zum Hinzufügen eines neuen Gruppenmitglieds zu einer AD-Gruppe. Verwenden Sie für komplexe AD-Vorgänge stattdessen die Aktivität „PowerShell ausführen“. Die Aktivität schlägt fehl, wenn kein Account mit übereinstimmendem Objektnamen und Daten gefunden wird.

    Um auf diese Aktivität im Workflow-Editor zuzugreifen, wählen Sie aus Anwenderdefiniert Registerkarte und navigieren Sie dann zu Anwenderdefinierte Aktivitäten > Active Directoryan.
    Hinweis:
    Diese Aktivität ersetzt eine AD-Aktivität aus früheren Releases mit denselben Namen. Wenn Sie über einen Workflow verfügen, der die veraltete Aktivität verwendet, funktioniert Ihr Workflow nach dem Upgrade auf Istanbul weiterhin normal. Für alle neuen Workflows muss jedoch die benutzerdefinierte Version dieser Aktivität verwendet werden, die mit dem PowerShell-Aktivitätsdesigner erstellt wurde.

    Eingabevariablen

    Tabelle : 1. Eingabevariablen für „AD-Objekt aktualisieren“
    Variable Beschreibung
    DomainController IP-Adresse des Computers mit dem Domänencontroller.
    ObjectName Der sAMAccountName des Active Directory-Objekts.
    ObjectData Ein JSON-Objekt, das Active Directory-Eigenschaften und ihre Werte enthält. Um beispielsweise den Vornamen, den Nachnamen und den Titel eines Anwenders festzulegen, den Manager des Anwenders zu löschen und die VIP-Kennzeichnung auf „wahr“ festzulegen, gibt die Objektdaten Folgendes an:
    { "givenName" : "John", "SN" : "Doe", "title" : "Sr. Account Specialist", "manager" : null, "msTSAllowLogon" : false }
    Type Der zu aktualisierende Objekttyp: Benutzer, Gruppe oder Computer.

    Ausgabevariablen

    Tabelle : 2. Ausgabevariablen für „AD-Objekt aktualisieren“
    Variable Beschreibung
    result Entweder success oder failure
    errorMessage Die executionResult.errorMessagesVon Analysequellen des Aktivitätendesigners.

    Bedingungen

    Tabelle : 3. Bedingungen für „AD-Objekt aktualisieren“
    Bedingung Beschreibung
    Success Das AD-Objekt wurde erfolgreich aktualisiert.
    Failure Beim Versuch, ein AD-Objekt zu aktualisieren, ist ein Fehler aufgetreten. Weitere Details sind möglicherweise im Workflow-Protokoll verfügbar.