Aktivität „Mailbox abrufen“

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 1 Minute Lesedauer

    • Die Aktivität „Mailbox abrufen“ ruft die Mailbox für den angegebenen Benutzer oder alle Mailboxen auf einem MicrosoftMicrosoft Azure Event Hubs Exchange-Server ab.

    Diese Aktivität implementiert den MicrosoftMicrosoft Azure Event Hubs Exchange-Befehl Get-Mailbox.

    Um im Workflow-Editor auf diese Aktivität zuzugreifen, wählen Sie die Registerkarte Anwenderdefiniert, und navigieren Sie dann zu Anwenderdefinierte 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 abrufen“
    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
    user Benutzer, dessen Mailbox diese Aktivität abrufen soll. Wenn kein Benutzer angegeben ist, ruft die Aktivität alle Mailboxen auf dem Exchange-Server ab. Die Aktivität übergibt diesen Wert an Exchange als Exchange-Identitätsvariable.
    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 abrufen“
    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 abrufen“
    Bedingung Beschreibung
    Success Die Aktivität konnte die Attribute der angegebenen Mailbox abrufen.
    Failure Die Aktivität konnte die Attribute der angegebenen Mailbox nicht abrufen.