nscontrol create 命令

更新日期： 2005 年 12 月 5 日

创建新的 Microsoft SQL Server Notification Services 实例。

语法

nscontrol create 
    [-nologo]
    [-help]
        -in configFile
    [-sqlusername sqlUserName  -sqlpassword sqlPassword]
    [-argumentkey key]
    [param=value ...]

参数

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

• -help
  显示命令的语法。

• -inconfigFile
  指定用来定义实例的实例配置文件 (ICF) 的路径和文件名。如果该文件位于当前目录，则无需提供路径。

• -sqlusernamesqlUserName
  指定用于连接到 SQL Server 的 SQL Server 登录名。

  如果使用 SQL Server 身份验证连接到 SQL Server，请使用此参数指定登录 ID。此参数必须与 -sqlpassword 参数一起使用。

  如果要使用 Windows 身份验证连接到 SQL Server，则不要使用 -sqlusername 和 -sqlpassword 参数。

  注意：
  请尽可能使用 Windows 身份验证。

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

• -argumentkeykey
  指定用于加密存储在 Notification Services 数据库中的传递通道和事件提供程序参数的密钥。密钥是一个最多可有 2500 个字符的字符串。

  如果配置文件中的 EncryptArguments 值是 true，则该参数是必需的。在运行 nscontrol create 命令之后，无法更改实例所使用的密钥值。若要使用不同的密钥，必须先删除实例，然后重新创建实例。

  在运行 nscontrol register 命令和 nscontrol update 命令时，还必须指定相同的密钥值。nscontrol register 命令将加密密钥值，并将它存储在注册表中。

• param=value
  从命令提示符向 ICF 传递参数值的名称/值配对。

  在 ICF 中，出现在百分比符号 (%) 字符之间的任何字符串都是可替换的参数。如果 ICF 包含可替换的参数（如以下示例中的 DBSystem），则在命令行中（或在 ICF 的 ParameterDefaults 部分中）指定参数名称和值。例如，如果配置文件中包含下列 XML 代码：

  <SqlServerSystem>%DBSystem%</SqlServerSystem>
  

  然后可以按如下方式使用 nscontrol create 来指定名称和值：

  nscontrol create -in config.xml DBSystem=MySQLServer
  

  在命令提示符下提供的参数值将应用于 ICF 中的参数，但不直接应用于应用程序定义文件 (ADF) 中的参数。若要将参数值传递到 ADF，请将 Parameters 子段添加到 ICF 的 Application 段中。可以在命令提示符下使用可替换参数，并为这些参数提供值。

  除了在命令提示符下指定参数以外，还可以在 ICF 中使用环境变量，如 %COMPUTERNAME%。如果在 ICF 中使用环境变量，请注意，具有相同名称的命令提示符名称/值对优先于环境变量。

备注

nscontrol create 命令将对照其 XML 架构对 ICF 和 ADF 进行验证，并检查是否有非法值，如多播传递和摘要传递的值同时为 true。如果没有通过验证或检查，nscontrol create 将停止，并且不会创建实例。

nscontrol create 命令将打开实例和应用程序数据库中的跨数据库所有权链接。这些数据库需要跨数据库所有权链接，以便允许 Notification Services 存储过程访问这些实例和应用程序数据库中的对象。

如果使用的是 Notification Services 标准版，并且标准版不支持一个或多个元素，则 nscontrol create 将停止，并且不会创建实例。有关 Notification Services 标准版的详细信息，请参阅 Notification Services 版本。

可以从安装了 Notification Services 客户端组件并且有权访问将存储实例和应用程序元数据的 SQL Server 数据库引擎的任何计算机运行 nscontrol create。

必须使用 nscontrol register 注册该实例，才可以运行 Notification Services 实例。注册过程将创建注册表项，并选择性地创建可用于运行该实例的 Windows 服务。

不能使用 nscontrol create 来更新实例。而应当使用 nscontrol update。

权限

用于运行 nscontrol create 的帐户，或在 -sqlusername 参数中指定的 SQL Server 登录名，必须为 sysadmin 固定服务器角色的成员。该帐户还必须拥有执行 Notification Services 二进制文件的权限；Administrators 和 SQLServerNotificationServicesUser Windows 组的成员会被授予该权限。

示例

以下示例显示如何创建 Notification Services 实例。

A. 基本示例

该示例显示如何使用 ICF InstanceConfig.xml 创建新的 Notification Services 实例以及如何使用 Windows 身份验证连接到 SQL Server。

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml"

B. 为配置文件参数提供值

该示例显示如何向 ICF 中的参数 BaseDirectoryPath、NSHost 和 SqlServer 传递值。nscontrol 命令使用 Windows 身份验证连接到 SQL Server。

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    BaseDirectoryPath=C:\NS\Samples\Stock 
    NSHost=nsuetest SqlServer=nsuetest

C. 提供参数加密密钥

该示例显示如何在创建实例时提供参数加密密钥。注意，该密钥必须与注册实例时所使用的密钥匹配。

nscontrol 命令使用 Windows 身份验证连接到 SQL Server。

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    -argumentkey "MyArgumentKey"

D. 使用 SQL Server 身份验证

该示例显示如何使用 SQL Server 身份验证创建新的 Notification Services 实例，以便连接到 SQL Server。

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

请参阅

参考

nscontrol 实用工具

其他资源

EncryptArguments Element (ICF)
部署 Notification Services 实例

帮助和信息

获取 SQL Server 2005 帮助

更改历史记录

版本	历史记录
2005 年 12 月 5 日	新增内容： 添加了有关 SQLServerNotificationServicesUser Windows 组的信息。