管理场和节点 (Workflow Manager 1.0)
Service Bus 是 Workflow Manager 的必备组件。你必须先创建并配置 Service Bus 场,然后配置 Workflow Manager 场。
创建新 Service Bus 场需要执行的 Workflow Manager 步骤为:
创建 Service Bus 场。
将计算机添加到 Service Bus 场。
创建将由 Service Bus 使用的 Workflow Manager 服务命名空间。
获取将由 Service Bus 使用的服务命名空间的 Workflow Manager 客户端配置。
本部分所述的 cmdlet 可以创建或删除 Workflow Manager 场以及它们包含的节点。
创建新的 Workflow Manager 场
New-WFFarm cmdlet 可以创建 Workflow 节点的新场。要使用自动生成的证书创建场,请使用以下格式:
New-WFFarm -WFFarmMgmtDBConnectionString <string> [-AdminGroup <string>] [-CertificateAutogenerationKey <SecureString>] [-HTTPPort <int>] [-HTTPSPort <int>] [-InstanceMgmtDBConnectionString <string>] [-ResourceMgmtDBConnectionString <string>] [-RunAsAccount <string>]
若要使用自定义证书创建场,请使用以下格式:
New-WFFarm -WFFarmMgmtDBConnectionString <string> [-EncryptionCertificateThumbprint <String>] [-AdminGroup <string>] [-HTTPPort <int>] [-HTTPSPort <int>] [-InstanceMgmtDBConnectionString <string>] [-OutboundCertificateThumbprint <thumbprint>] [-ResourceMgmtDBConnectionString <string>] [-RunAsAccount <string>] [-SSLCertificateThumbprint <Thumbprint>]
如果在场创建期间发生错误或被强制重新启动,则所创建的场管理数据库可能会处于损坏状态。在这种情况下,当你尝试加入场时,进程可能会显示一个错误,指示你所尝试添加到该场的计算机不属于任何场。遇到此类错误时,你必须先删除场管理数据库并重新创建它,然后才能将任何新节点加入场。
下表描述了此 cmdlet 的选项。
选项 |
效果 |
---|---|
–WFFarmMgmtDBConnectionString <connectionstring> |
表示配置数据库的连接字符串。 |
[-RunAsAccount <string> |
指定将在其下运行服务的用户帐户。 |
-Admingroup <adgroup> |
指定用户组,其成员获得场中数据库的管理访问权限。 默认为计算机上的 BuiltIn\Administrators 组。 |
-CertificateAutogenerationKey <SecureString>] |
指定一个密钥,安装程序使用该密钥来生成新的服务 SSL 证书,以保护服务与其客户端之间的通信。 |
-InstanceMgmtDBConnectionString <string> |
指定要用于实例管理数据库的 SQL Server 数据库实例的连接字符串。实例管理数据库包含当前正在运行的每个 Workflow 实例的数据。 |
-ResourceMgmtDBConnectionString <string> |
指定要用于资源管理数据库的 SQL Server 数据库实例的连接字符串。资源管理数据库管理工作流。 |
-HttpPort <portno> |
指定将用于 HTTP 通信的端口。 默认值为 12291。 |
-HttpsPort <portno> |
指定将用于 HTTPS 通信的端口。 默认值为 12290。 |
-EncryptionCertificateThumbprint <string> |
此证书用于保护 SQL 连接字符串。如果未提供此参数,则将采用 SslCertificate 的值。表示加密证书。 |
-SslCertificateThumbprint <String> |
此证书用于保护服务通信。如果你要提供用于自动生成证书的 CertificateAutogenerationKey,则无需提供此证书。 |
-OutboundCertificateThumbprint <String> |
此证书用于保护出站通信。如果你要提供用于自动生成证书的 CertificateAutogenerationKey,则无需提供此证书。 |
向场中添加新节点
Add-WFHost cmdlet 可向现有场中添加节点。Add-WFHost cmdlet 使用以下格式:
Add-WFHost [-EnableFirewallRules [<Boolean>]] [-EnableHttpPort [<SwitchParameter>]] [-SBClientConfiguration <String>] -CertificateAutoGenerationKey <SecureString> -RunAsPassword <SecureString> -WFFarmDBConnectionString
<String> [<CommonParameters>]
下表描述了此 cmdlet 的选项。
选项 |
效果 |
---|---|
–WFFarmDBConnectionString <connectionstring> |
指定要添加为场管理数据库的 SQL Server 实例的连接字符串。 |
-RunAsPassword <SecureString> |
指定在场中运行服务的用户帐户的密码。如果场中的所有计算机都共享同一服务帐户并且安全策略要求定期更改服务帐户密码,则必须在场中的每台计算机上执行特定操作才能继续在场中添加和删除节点。对于此过程,请参阅标题为处理场密码更改的部分。 |
-CertificateAutogenerationKey <SecureString>] |
指定场用于保护自动生成的证书的密钥。此密钥与传入 New-WFFarm 的密钥相同。 |
-enableHttpPort |
指定是否需要在此计算机上启用 HTTP。默认情况下会禁用 HTTP。 |
-SBClientConfiguration |
Workflow Manager 必须了解它将要使用的 Service Bus 场信息。你必须使用 Workflow Manager 将要使用的服务命名空间运行 Get-SBClientConfig,然后传入此 cmdlet 返回的文本作为此参数的值。 |
在将节点添加到场时,安装程序会根据你的选择自动生成以下证书:
证书类型 |
名称 |
颁发者 |
---|---|---|
CA |
AppServerGeneratedWFCA |
|
出站证书 |
Workflow Manager出站 |
AppServerGeneratedWFCA |
SSL 计算机证书 |
计算机的完全限定域名。 |
AppServerGeneratedWFCA |
从场中删除节点
Remove-WFHost cmdlet 可以从现有场中删除节点。
此 cmdlet 采用以下格式:
Remove-WFHost [-WFFarmDBConnectionString <connectionstring>]
如果你想要重命名某台属于场的计算机,则必须先使用此 cmdlet 将它从场中删除,在重命名后,使用 Add-WFHost cmdlet 将它加回到场中。如果此 cmdlet 遇到超时错误,你仍可以尝试运行 Add-WFHost cmdlet 以尝试将它加回到场中。如果 Add-WFHost 成功,则可以忽略前面的超时错误。
下表描述了此 cmdlet 的选项。
选项 |
效果 |
---|---|
-WFFarmDBConnectionString <connectionstring> |
指定要从场中删除的 SQL Server 实例的连接字符串。如果你不提供此参数,cmdlet 将在注册表中查找该连接字符串。 |
-HostName<string> |
指定要作为 Service Bus for Windows Server 管理数据库删除的 SQL Server 实例的连接字符串。 |
当你退出场时,你在计算机上安装的所有证书将会保留。如果想要删除这些证书,你必须手动删除。