nscontrol export 命令

项目
12/15/2008

更新日期： 2005 年 12 月 5 日

通过从数据库导出元数据，创建 XML 实例配置文件 (ICF) 以及一个或多个 XML 应用程序定义文件 (ADF)（一个应用程序一个文件）。生成的文件是运行导出命令时该实例和各应用程序的有效定义。可以使用此信息来备份实例和应用程序定义，或者生成可用于创建或更新实例的文件。

语法

nscontrol export 
    [-nologo]
    [-help] 
        -name instanceName
    [-server databaseServer]
    [-sqlusername sqlUserName -sqlpassword sqlPassword]
    [-out directory]
    [-force]

参数

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

-help
显示命令的语法。

-nameinstanceName
从中创建配置文件和应用程序定义文件的实例的名称。

-serverdatabaseServer
承载实例和应用程序数据库的服务器的名称。只有未在本地计算机上注册实例时，才提供此参数。如果已注册实例并且提供了 -server 参数，则会忽略实例的注册表值。

如果使用 SQL Server 的命名实例承载实例数据库，则请使用 <servername>\<instancename> 格式指定服务器名和实例名。

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

重要提示：

Windows 身份验证比 SQL Server 身份验证更加安全。请尽可能使用 Windows 身份验证。

如果使用 SQL Server 身份验证连接到 SQL Server，则请使用此参数指定登录名。也可以使用 -sqlpassword 参数指定密码。

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

重要提示：
Windows 身份验证比 SQL Server 身份验证更加安全。请尽可能使用 Windows 身份验证。

-sqlpasswordsqlPassword
与 -sqlusername 登录名相关联的密码。应仅在使用 SQL Server 身份验证进行连接时使用此参数。

-outdirectory
要写入文件的目录。默认目录为当前目录。

-force
指定覆盖输出目录中名称相同的现有文件。

备注

实例在运行时，可以使用 nscontrol export 命令。不需要禁用或停止实例。

生成的配置文件命名为 <instance_name>.config.xml。每个生成的 ADF 命名为 <instance_name>.<application_name>.adf.xml。

nscontrol export 命令使用 UTF-8 编码写文件。若要使用其他编码导出配置文件和应用程序定义文件，请使用 SQL Server Management Studio 中的**“导出”**命令。

nscontrol export 命令不会重新创建原始配置文件和应用程序定义文件。该命令创建的文件将包含当前实例和应用程序设置，其中包括可能已通过可替换参数提供的值。因此，我们建议您保留原始配置文件和应用程序定义文件。在需要确定当前实例和应用程序设置时，使用 nscontrol export 命令。

nscontrol export 命令将修改配置文件中的 ApplicationDefinitionFilePath 值以指向导出的 ADF；修改该路径即可使用配置文件。所有其他路径设置（包括 BaseDirectoryPath）都保留不变，因为它们可以指向实例所需的其他文件（例如内容格式化程序文件）。

权限

通过各应用程序和实例数据库的 NSReader 数据库角色的成员资格，运行 nscontrol export 的帐户或由 -sqlusername 参数指定的 SQL Server 登录名均可获得数据库权限。db_owner 数据库角色的成员及 sysadmin 和 dbcreator 固定服务器角色的成员也可运行 nscontrol export 命令。

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

示例

以下示例阐释了将元数据导出为 XML 文件的方式。

A. 将文件导出到当前目录

此示例说明如何导出 StockInstance 实例的实例信息和应用程序信息。nscontrol 实用工具通过 Windows 身份验证连接到 SQL Server，并将配置文件和应用程序定义文件写入当前目录。如果这些文件已经存在，nscontrol 将显示错误消息。

nscontrol export -name StockInstance

B. 将文件导出到指定的目录，覆盖现有文件

此示例说明如何为生成的实例和应用程序文件指定目录，还说明如何使用 –force 参数覆盖同名的现有文件。

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

nscontrol export -name StockInstance -out "C:\NS\Export" -force

C. 通过管理计算机导出文件

此示例说明未在计算机上注册实例时，如何导出实例和应用程序信息。必须使用 –server 参数指定 SQL Server 实例名称。此示例还指定了一个输出目录，并指定要覆盖同名的现有文件。

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

nscontrol export -name StockInstance -server nsuetest 
    -out "C:\NS\Export" -force

D. 使用 SQL Server 身份验证导出文件

此示例显示如何使用 SQL Server 身份验证连接到 SQL Server，以导出 StockInstance 实例的实例信息。配置文件和应用程序定义文件在 C:\NS\Export 目录中创建。如果已经存在同名文件，该文件不会被覆盖。

nscontrol export -name StockInstance -out "C:\NS\Export" 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

请参阅

更改历史记录

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