了解如何使用 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