Aktivität „AD-Objekt aktualisieren“

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 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 im Workflow-Editor auf diese Aktivität zuzugreifen, wählen Sie die Registerkarte Anwenderdefiniert, und navigieren Sie dann zu Anwenderdefinierte Aktivitäten > Active Directory.
    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, Nachnamen und Titel eines Benutzers festzulegen, den Manager des Benutzers zu löschen und die VIP-Kennzeichnung auf „wahr“ zu setzen, geben 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 executionResult.errorMessages aus 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.