nscontrol status 命令

更新日期： 2005 年 12 月 5 日

显示指定实例、应用程序及其组件的启用或禁用状态。该命令还可以显示 NS$<instance_name> Windows 服务的状态或与实例相关的服务的状态。

语法

nscontrol status 
    [-nologo]
    [-help]
        -name instanceName
    [-server databaseServer] 
    [-application applicationName] 
    [-sqlusername sqlUserName -sqlpassword sqlPassword]

参数

• -nologo
  取消运行 nscontrol 命令时显示的产品和版本声明。

• -help
  显示命令的语法。

• -nameinstanceName
  要报告其状态的实例的名称。

• -serverdatabaseServer
  承载实例和应用程序数据库的服务器的名称。

  如果对已注册了实例的系统运行 scontrol status，则可使用 -name 参数，而不使用 -server 参数。nscontrol 实用工具通过读取 Microsoft SQL Server 实例的注册表信息来确定该实例的名称。

  如果对尚未注册实例的系统运行 nscontrol status，则必须同时使用 -name 和 -server 参数，因为 nscontrol 同时需要 Notification Services 实例名称和 SQL Server 实例名称。

• -applicationapplicationName
  要报告其状态的应用程序的名称。如果不指定应用程序名称，则 nscontrol status 将报告该实例承载的所有应用程序的状态。

• -sqlusernamesqlUserName
  如果使用 SQL Server 身份验证连接到 SQL Server，则必须同时指定 -sqlusername 和 -sqlpassword 参数。

  如果使用的是 Windows 身份验证，则无需指定 -sqlusername 和 -sqlpassword 参数。

• -sqlpasswordsqlPassword
  是与 -sqlusername 登录 ID 关联的密码。此参数必须与 -sqlusername 参数一起使用。

备注

nscontrol status 命令显示各组件的状态，并在括号中指出系统名。

宿主事件提供程序、生成器和分发服务器可以有下列状态值：启用、启用挂起、禁用和禁用挂起。有关可能的状态值的说明，请参阅查看实例、应用程序和组件的状态。

启动服务时，组件状态将被更新。如果在多台计算机间扩展实例，则必须启动所有 Windows 服务来更新所有状态。

订阅服务器和订阅可以有“启用”或“禁用”状态。这些组件不依赖于 NS$instance_name Windows 服务。

nscontrol enable 命令和 nscontrol disable 命令也可以显示状态信息。

权限

用于运行 nscontrol status 的帐户或者由 -sqlusername 参数指定的 SQL Server 登录 ID，必须为下列数据库角色之一的成员：NSAnalysis、NSDistributor、NSEventProvider、NSGenerator、NSReader、NSRunService、NSSubscriberAdmin 或 NSVacuum。

该帐户还必须拥有执行 Notification Services 二进制文件的权限；Administrators 和 SQLServerNotificationServicesUser Windows 组的成员会被授予该权限。

如果使用 NS$<instanceName> Windows 服务运行 Notification Services 实例，nscontrol status 将显示服务的状态，因此该帐户必须是运行 Windows 服务的所有计算机上的管理员。

示例

以下示例阐释多种情况下的状态显示方式。

A. 显示实例的状态

此示例说明如何显示名为 StockInstance 的实例的状态。nscontrol 实用工具使用 Windows 身份验证连接到 SQL Server。

nscontrol status -name StockInstance

A. 显示实例的状态

此示例说明如何显示名为 StockInstance 的实例中的 Stock 应用程序的状态。nscontrol 实用工具使用 Windows 身份验证连接到 SQL Server。

nscontrol status -name StockInstance -application Stock

C. 通过管理计算机显示实例的状态

此示例说明未在计算机上注册实例时，如何显示实例的状态。若要显示状态，必须使用 –server 参数提供数据库服务器名称。

nscontrol 实用工具使用 Windows 身份验证连接到 SQL Server。

nscontrol status -name StockInstance -server nsuetest 
    -application Stock 

D. 使用 SQL Server 身份验证来显示实例的状态

重要提示：
请尽可能使用 Windows 身份验证。

此示例说明如何使用 SQL Server 身份验证连接到 SQL Server 来显示名为 StockInstance 的实例的状态。

nscontrol status -name StockInstance -sqlusername SqlUser 
    -sqlpassword sQl-P@sWd

请参阅

参考

nscontrol 实用工具

其他资源

查看实例、应用程序和组件的状态

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录