管理场和节点

注:本页面内容可能不完全适用中国大陆地区运营的 Windows Azure服务。如要了解不同地区 Windows Azure 服务的差异, 请参考本网站.

此部分中介绍的 cmdlet 可创建或删除场及场包含的节点。

创建新的 Service Bus for Windows Server 场

New-SBFarm cmdlet 可创建一个由 Service Bus for Windows Server 节点组成的新场。若要使用自动生成的证书创建场,请使用以下格式:

New-SBFarm [-AdminGroup <String>] [-GatewayDBConnectionString <String>] [-HttpsPort <Int32>]
[-InternalPortRangeStart <Int32>] [-MessageBrokerPort <Int32>] [-MessageContainerDBConnectionString <String>]
[-RunAsAccount <String>] [-TcpPort <Int32>] -CertificateAutoGenerationKey <SecureString> -SBFarmDBConnectionString <String>

要使用自定义证书创建场,请使用以下格式:

New-SBFarm [-AdminGroup <String>] [-EncryptionCertificateThumbprint <String>] [-GatewayDBConnectionString
<String>] [-HttpsPort <Int32>] [-InternalPortRangeStart <Int32>] [-MessageBrokerPort <Int32>]
[-MessageContainerDBConnectionString <String>] [-RunAsAccount <String>] [-TcpPort <Int32>]
-FarmCertificateThumbprint <String> -SBFarmDBConnectionString <String>

如果在场创建期间发生错误或被强制重新启动,则所创建的场管理数据库可能会处于损坏状态。在这种情况下,当你尝试加入场时,进程可能会显示一个错误,指示你所尝试添加到该场的计算机不属于任何场。遇到此类错误时,你必须先删除场管理数据库并重新创建它,然后才能将任何新节点加入场。

下表介绍了此 cmdlet 的选项。

选项 效果

– SBFarmDBConnectionString <connectionstring>

表示配置数据库的连接字符串。

-Admingroup <adgroup>

指定其成员将收到对场中数据库的管理访问权限的用户组。默认为计算机上的 BuiltIn\Administrators 组。

-CertificateAutoGenerationKey <SecureString>]

指定安装程序用于生成新服务 SSL 证书以保护服务及其客户端之间的通信的密钥。

-MessageContainerDBConnectionString <connstring>

指定用作容器数据库的数据库实例的连接字符串。

-MessageBrokerPort <portno>

指定将用于消息代理通信的端口。默认值为 9356。

-HttpsPort <portno>

指定将用于 https 通信的端口。默认值为 9355。

-InternalPortRangeStart <portrange>

指定 Windows Fabric 内的 Service Bus for Windows Server 节点用于与其他节点通信的端口范围。portrange 参数是一个端口号,用于表示六个连续端口的范围内的第一个端口。

-GatewayDBConnectionString <connstring>

指定用作网关数据库的数据库实例的连接字符串。网关数据库对传入请求进行管理和负载平衡。

-TCPPort <portno>

指定 Service Bus for Windows Server 节点用来互相通信的端口。默认值为 9354。

-EncryptionCertificateThumbprint <string>

用于保护 SQL 连接字符串的证书。如果未提供,则将采用 SslCertificate 的值。表示加密证书。

-FarmCertificateThumbprint <string>

用于保护证书的证书。如果你要提供用于自动生成证书的 CertificateAutoGenerationKey,则无需提供此证书。

向场中添加新节点

Add-SBHost cmdlet 可向现有场添加节点。Add-SBHost cmdlet 采用以下格式:

Add-SBHost [-CertificateAutogenerationKey <SecureString>] [-ExternalBrokerPort <Int32>] [-ExternalBrokerUrl <Uri>] -EnableFirewallRules <Boolean> -RunAsPassword <SecureString> -SBFarmDBConnectionString <String>

下表介绍了此 cmdlet 的选项。

选项 效果

– SBFarmDBConnectionString <connectionstring>

指定要作为场管理数据库添加的 SQL Server 实例的连接字符串。

-RunAsPassword <SecureString>

指定在场中运行服务的用户帐户的密码。如果场中的所有计算机都共享同一服务帐户并且安全策略要求定期更改服务帐户密码,则必须在场中的每台计算机上执行特定操作才能继续在场中添加和删除节点。有关此过程的信息,请参阅标题为处理场密码更改的部分。

-CertificateAutoGenerationKey <SecureString>]

指定场用于保护自动生成的证书的密钥。

-EnableFirewallRules <Boolean>

如果为 true,则将在主机上启用防火墙规则。

-ExternalBrokerPort <Int32>

表示 Service Bus for Windows Server 用于 ExternalBroker 通信的端口。

-ExternalBrokerUrl <Uri>

指定区分大小写的 ExternalBroker URI。

安装程序在将节点添加场时,将根据你的选择自动生成以下证书:

证书类型 Name 颁发者

CA

AppServerGeneratedSBCA

FarmCertificate

AppServerGeneratedSBCA

AppServerGeneratedSBCA

从场中删除节点

Remove-SBHost cmdlet 可从现有场中删除节点。当场处于已停止状态时,如果你运行此 cmdlet,则可能会出现一些错误或警告。你可以忽略这些错误和警告,并在运行 Remove-SBHost 后运行 Start-SBFarm 以使更改生效。如果场处于运行状态,则不需要运行 Start-SBFarm

此 cmdlet 使用以下格式:

Remove-SBHost [-SBFarmDBConnectionString <string>] [-HostName <string>] [<CommonParameters>]

下表介绍了此 cmdlet 的选项。

选项 效果

– SBFarmDBConnectionString <connectionstring>

指定要从场中删除的 SQL Server 实例的连接字符串。如果你不提供此参数,cmdlet 将在注册表中查找该连接字符串。

-HostName<String>

要删除的主机的名称。如果你未提供此参数,则将删除在其上执行该 cmdlet 的主机。

备注

如果该主机不再可用,并且你希望清理场配置,则必须提供 HostName

如果你想要重命名某台属于场的计算机,则必须先使用此 cmdlet 将它从场中删除,然后进行重命名,之后使用 Add-SBHost cmdlet 将它添加回场中。如果此 cmdlet 遇到超时错误,你仍可以尝试运行 Add-SBHost cmdlet 以尝试将它添加回场中。如果 Add-SBHost 成功,则可以忽略前面的超时错误。

当你退出场时,卸载程序会保留你在计算机上安装的所有证书。如果你想要删除这些证书,则必须手动删除。

将场减少为单计算机场时,你必须从该场中删除所有计算机。然后必须再重新添加要属于该场的计算机。