使用配对的 cmdlet Register-SPWorkflowService

了解如何使用 cmdlet Register-SPWorkflowService,成功配对 SharePoint 和工作流管理器。 若要安装和配置 Microsoft SharePoint 以支持工作流开发,必须“配对”安装的 SharePoint 和工作流管理器。 在大多数情况下,可以使用 SharePoint 安装随附的 cmdlet Register-SPWorkflowService 轻松完成配对。

注意

自 2020 年 8 月 1 日起,SharePoint 2010 工作流已对新租户停用,并于 2020 年 11 月 1 日从现有租户中删除。 如果你使用的是 SharePoint 2010 工作流,我们建议迁移到 Power Automate 或其他支持的解决方案。 有关详细信息,请参阅 SharePoint 2010 工作流停用

重要的是,此 cmdlet 并非对每个配对方案都有用。 Register-SPWorkflowService 仅在以下配对方案中可用:

  • 包含一台计算机的服务器场,其中 SharePoint 与工作流管理器在服务器盒上同地协作。

  • 包含三台计算机的服务器场,其中 SharePoint 与工作流管理器在全部三台计算机上同地协作。 (如果需要在单独的计算机上执行搜索,并且必须使用工作流管理器 HA,请添加第四台计算机。 如果需要满足后一种要求,必须在全部三台计算机上安装它。

  • 包含三台计算机的 SharePoint 场,与非同地协作的工作流管理器服务器场配对。

另请注意,Register-SPWorkflowService 使用当前用户的凭据。

Cmdlet 设计

详细信息 说明
Verb
注册
名词
SPWorkflowService
说明
将 sps15short 场与工作流管理器场配对。 必须为每个服务器场运行一次此 cmdlet。 在运行 cmdlet 之前,必须在计算机证书存储和 SharePoint 证书存储中安装根 CA 证书。 为此,请使用 cmdlet New-SPTrustedRootAuthority。 (请参阅下面的说明。)
Output type
无。
语法
Register-SPWorkflowService -SPSite <URI or GUID representing an SPSite object> -WorkflowHostUri <workflow service endpoint URL> -ScopeName <string> [-PartitionMode] [-AllowOAuthHttp] [-Force]

Cmdlet 参数

参数 类型 说明
SPSite (必需)
SPSitePipeBind
在用作配对端点的 SharePoint Server 场上的长久网站集的 URL。 从此 URL 可以推断出用于配对的信息。
WorkflowHostUri (必需)
String
用于配对的工作流管理器端点的 URL。 提供工作流主机 URI 以及端口号。
ScopeName
String
工作流服务要用于标识已配对 SharePoint Server 场的名称。 默认值是"SharePoint"。 如果尝试将多个 SharePoint 场与一个工作流管理器场配对,您只需指定此参数。
PartitionMode
SwitchParameter
此参数仅适用于多租户 SharePoint 场。 分区模式要针对每个 SharePoint 服务指定。 请注意,在运行此 cmdlet 之后,您可以在 SharePoint 场中创建多租户;因此,cmdlet 无法从现有 SharePoint 场状态中隐式推断出此参数的值。
AllowOAuthHttp
SwitchParameter
使 OAuth 与元数据通过 HTTP 进行交换。 这在测试中很有用,但在生产模式中没有用。 只有在将 SharePoint 配置为支持 HTTP 时才可以使用此参数。 不必将工作流管理器配置为使用 HTTP。
Force
SwitchParameter
强制使用 ScopeName 参数创建范围,或更新与同一 ScopeName 对应的现有范围。 如果没有指定,且存在同名的范围,cmdlet 将抛出一个错误。

示例


PS> Register-SPWorkflowService -SPSite "https://myserver/mysitecollection" -WorkflowHostUri "http://workflow.example.com:12291" -ScopeName "SharePoint2" -PartitionMode -AllowOAuthHttp  -Force

另请参阅