Verwenden des passenden Register-SPWorkflowService-Cmdlets
Erfahren Sie, wie Sie das Cmdlet Register-SPWorkflowService verwenden, um SharePoint erfolgreich mit dem Workflow-Manager zu koppeln. Wenn Sie Microsoft SharePoint installieren und für die Workflowentwicklung nutzen möchten, müssen Sie die Installationen von SharePoint und des Workflow-Managers koppeln. In den meisten Szenarien erfolgt diese Kopplung problemlos mit dem Cmdlet Register-SPWorkflowService, das in der SharePoint-Installation enthalten ist.
Hinweis
SharePoint 2010-Workflows wurden am 1. August 2020 für neue Mandanten eingestellt und am 1. November 2020 aus bestehenden Mandanten entfernt. Wenn Sie SharePoint 2010-Workflows verwenden, empfehlen wir die Migration zu Power Automate oder anderen unterstützten Lösungen. Weitere Informationen hierzu finden Sie unter Einstellung von SharePoint 2010-Workflows.
Dieses Cmdlet ist wichtiger, nicht für jede paarungs Szenario hilfreich. Register-SPWorkflowService ist nur in den folgenden paarungs Szenarien hilfreich:
1-Computer-Serverfarm, bei der sich SharePoint und der Workflow-Manager auf dem gleichen Server befinden.
3-Computer-Serverfarm, bei der sich SharePoint und der Workflow-Manager auf allen drei Computern befinden. (Fügen Sie einen vierten Computer hinzu, wenn sich Suche auf einem separaten Computer befinden muss und der Workflow-Manager HA benötigt wird. Falls Letzteres der Fall ist, muss der Workflow-Manager HA auf allen drei Computern installiert werden.
3-Computer-SharePoint-Farm gekoppelt mit einer Workflow-Manager-Serverfarm, die sich nicht auf dem gleichen Server befindet.
Beachten Sie zudem, dass Register-SPWorkflowService die Anmeldeinformationen des aktuellen Benutzers verwendet.
Cmdlet-Entwurf
| Detail | Beschreibung |
|---|---|
| Verb |
Registrieren |
| Name |
SPWorkflowService |
| Beschreibung |
-Paare eine sps15short-Farm mit einer Workflow-Manager Farm aus. Sie müssen dieses Cmdlet einmal pro Farm ausführen. Bevor Sie das Cmdlet ausführen, müssen Sie im Zertifikatspeicher des Computers und SharePoint-Zertifikatspeicher Stammzertifikat der Zertifizierungsstelle installieren. Verwenden Sie hierzu das Cmdlet New-SPTrustedRootAuthority. (Siehe unten). |
| Ausgabetyp |
Keine. |
| Syntax |
Register-SPWorkflowService -SPSite <URI or GUID representing an SPSite object> -WorkflowHostUri <workflow service endpoint URL> -ScopeName <string> [-PartitionMode] [-AllowOAuthHttp] [-Force] |
Cmdlet-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
| SPSite (erforderlich) |
SPSitePipeBind |
Die URL einer Websitesammlung langfristig in der SharePoint Server-Farm, die als paarungs Endpunkt fungiert. Informationen für die Bildung wird von dieser URL abgeleitet. |
| WorkflowHostUri (erforderlich) |
Zeichenfolge |
Die URL des Endpunkts Workflow-Manager für die Verbindung. Ermöglicht es dem Workflowhost URI zusammen mit der Portnummer. |
| ScopeName |
String |
Der Name, der vom Workflowdienst zum Identifizieren der kombinierte SharePoint Server Farm verwendet werden. Der Standardwert ist "SharePoint". Sie müssen nur diesen Parameter angeben, wenn Sie mehrere SharePoint-Serverfarmen zu einer Farm Workflow-Manager Kopplung möchten. |
| PartitionMode |
SwitchParameter |
Verwenden Sie diesen Parameter nur für mehrinstanzenfähige SharePoint-Farmen. Der Partitionsmodus wird pro SharePoint-Dienst angegeben. Beachten Sie, dass Sie mehrinstanzenfähige Mandanten in einer SharePoint-Farm erstellen können, nachdem dieses Cmdlet ausgeführt wurde. Daher kann das Cmdlet diesen Parameterwert nicht implizit aus dem vorhandenen Zustand der SharePoint-Farm ableiten. |
| AllowOAuthHttp |
SwitchParameter |
Ermöglicht Exchange OAuth und Metadaten über HTTP. Dies ist nützlich, testen, aber nicht in den Produktionsmodus versetzen. Verwenden Sie diese nur, wenn SharePoint zur Unterstützung von HTTP konfiguriert ist. Es ist nicht erforderlich, dass die Workflow-Manager für die Verwendung von HTTP konfiguriert werden. |
| Force |
SwitchParameter |
Erzwingt die Erstellung des Bereichs mithilfe des ScopeName-Parameters oder aktualisiert einen vorhandenen Bereich, der demselben ScopeName entspricht. Wenn der Parameter nicht angegeben wird und bereits ein Bereich mit dem gleichen Namen vorhanden ist, gibt das Cmdlet einen Fehler zurück. |
Beispiel
PS> Register-SPWorkflowService -SPSite "https://myserver/mysitecollection" -WorkflowHostUri "http://workflow.example.com:12291" -ScopeName "SharePoint2" -PartitionMode -AllowOAuthHttp -Force