Aktivität „Mailbox erstellen“

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer

    • Die Aktivität „Mailbox erstellen“ erstellt einen neuen Active Directory-Benutzer, sofern dieser noch nicht vorhanden ist, und eine Microsoft Exchange-Mailbox für diesen Benutzer.

    Diese Aktivität implementiert den Microsoft Exchange-Befehl New-Mailbox.

    Um im Workflow-Editor auf diese Aktivität zuzugreifen, wählen Sie die Registerkarte Benutzerdefiniert aus und navigieren dann zu Benutzerdefinierte Aktivitäten > Exchange > Mailbox.
    Hinweis:
    Diese Aktivität ersetzt eine Exchange-Aktivität mit demselben Namen, die in Releases vor Geneva verfügbar ist. Wenn ein in einer früheren Version erstellter Workflow die veraltete Aktivität verwendet, funktioniert dieser Workflow nach dem Upgrade auf Geneva weiterhin normal. Alle neuen Workflows müssen jedoch die benutzerdefinierte Version dieser Aktivität verwenden. Diese Aktivität wurde mit dem PowerShell-Aktivitätsdesigner erstellt, wodurch Workflow-Administratoren die Möglichkeit haben, Eingabe- und Ausgabevariablen im Datenbus zu speichern.

    Eingabevariablen

    Tabelle : 1. Eingabevariablen für „Mailbox erstellen“
    Variable Beschreibung
    hostname Der Hostname des Exchange-Servers, mit dem die Aktivität interagiert. Geben Sie in diese Variable keine IP-Adresse ein.
    domain Der Name der dem Exchange-Server zugewiesenen Domäne
    Wichtig:
    Der MID Server muss sich in derselben Domäne wie der Exchange-Server befinden.
    first_name Vorname des Benutzers
    middle_initial Erster Buchstabe des zweiten Vornamens des Benutzers
    last_name Nachname des Benutzers
    alias Der Anzeigename für die Mailboxadresse (der Teil der E-Mail-Adresse, der sich links des @-Symbols befindet). Ohne Angabe eines Alias verwendet die Aktivität für den Alias das Format „Vorname.Nachname“. Der Alias wird auch als Benutzerprinzipalname (UPN) verwendet, wenn in den optionalen Parametern kein Name angegeben ist.
    password Passwort, das für die neue Mailbox verwendet werden soll. Das Passwort wird verschlüsselt, wenn es an den Zielhost gesendet wird.
    parameters Optionale Parameter in der JavaScript Object Notation (JSON), die an den Exchange-Server übergeben werden. Exchange-Aktivitäten können keine Parameter übergeben, die auf ein Objekt verweisen, z. B. ein PSCredential-Objekt. Für Parameter, die diesen Datentyp erfordern, wird Klartext automatisch in SecureString-Objekte konvertiert.
    Beim Versuch, eine Aktivität zu speichern, die doppelte Parameter angibt, einschließlich Parametern aus Aktivitätsvariablen oder falsch formatiertem JSON, wird eine Warnmeldung angezeigt.
    Hinweis:
    Wenn Sie einen Switch-Parameter übergeben, z. B. ForceUpgrade, müssen Sie das Format "parameter":"true" verwenden.

    Ausgabevariablen

    Tabelle : 2. Ausgabevariablen für „Mailbox erstellen“
    Variable Beschreibung
    result Entweder success oder failure
    error Fehlermeldung, wenn der Vorgang fehlschlägt
    Ausgabe XML-Roh-Payload vom Exchange-Server. Diese Daten umfassen alle Exchange-Attribute.

    Bedingungen

    Tabelle : 3. Bedingungen für „Mailbox erstellen“
    Bedingung Beschreibung
    Success Die Aktivität konnte eine neue Mailbox für den angegebenen Benutzer erstellen. Wenn für diesen Benutzer kein Active Diectory-Account vorhanden ist, konnte mit dieser Aktivität ein neuer Account erstellt werden.
    Failure Die Aktivität konnte keine neue Mailbox oder einen Active Directory-Account für den angegebenen Benutzer erstellen.