Aktivität „Mailbox festlegen“

Die Aktivität „Mailbox festlegen“ ändert die Einstellungen einer vorhandenen Microsoft Exchange-Mailbox.

Verwenden Sie die Variable für optionale Parameter, um bestimmte Werte an den Exchange-Server zu übergeben. Diese Aktivität implementiert den Microsoft Exchange-Befehl Set-Mailbox.

Um auf diese Aktivität im Workflow-Editor zuzugreifen, wählen Sie aus Anwenderdefiniert Registerkarte und navigieren Sie dann zu Anwenderdefinierte Aktivitäten > Exchange > Mailboxan.

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 festlegen“

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	Active Directory-Anwender, dessen Postfach Sie ändern möchten. 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 festlegen“

Variable	Beschreibung
result	Entweder success oder failure
error	Fehlermeldung, wenn der Vorgang fehlschlägt

Bedingungen

Tabelle : 3. Bedingungen für „Mailbox festlegen“

Bedingungen	Beschreibung
Success	Die Aktivität konnte die Einstellungen der angegebenen Mailbox ändern.
Failure	Die Aktivität konnte die Einstellungen der angegebenen Mailbox nicht ändern.