nscontrol create 命令

發行項
12/15/2008

更新： 2005 年 12 月 5 日

建立 Microsoft SQL Server Notification Services 的新執行個體。

語法

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

引數

-nologo
隱藏執行 nscontrol 命令時所顯示的產品和版本聲明。

-help
顯示命令語法。

-inconfigFile
指定定義執行個體之執行個體組態檔 (ICF) 的路徑和檔案名稱。如果檔案在目前的目錄中，就不需要這個路徑。

-sqlusernamesqlUserName
指定用來連接 SQL Server 的 SQL Server 登入。

如果您利用 SQL Server 驗證來連接 SQL Server，請利用這個引數來指定登入識別碼。這個引數必須搭配 -sqlpassword 引數一起使用。

如果您利用 Windows 驗證來連接 SQL Server，請勿使用 -sqlusername 和 -sqlpassword 引數。

附註：

可能的話，請使用「Windows 驗證」。

附註：
可能的話，請使用「Windows 驗證」。

-sqlpasswordsqlPassword
指定與 -sqlusername 登入識別碼相關聯的密碼。這個引數必須搭配 -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，請在 ICF 的 Application 區段中加入 Parameters 子區段。您可以使用可取代的參數，並在命令提示字元之下提供這些參數的值。

除了在命令提示字元之下指定參數，您也可以在 ICF 中使用環境變數，如 %COMPUTERNAME%。如果您在 ICF 中使用環境變數，請注意，在命令提示字元之下同名的名稱/值組比環境變數優先。

備註

nscontrol create 命令根據 XML 結構描述驗證 ICF 和 ADF，並檢查不合法值，例如同時針對多重傳遞和摘要傳遞的 true 值。如果驗證或檢查不通過，nscontrol create 會停止作業，不會建立執行個體。

nscontrol create 命令會在執行個體和應用程式資料庫中，開啟跨資料庫擁有權鏈結。這些資料庫必須有跨資料庫擁有權鏈結，才能讓 Notification Services 預存程序存取執行個體和應用程式資料庫中的物件。

如果您使用 Notification Services Standard Edition，且有一或多個 Standard Edition 不支援的元素，nscontrol create 會停止作業，不會建立執行個體。如需有關 Notification Services Standard Edition 的詳細資訊，請參閱＜Notification Services 的版本＞。

您可以從安裝了 Notification Services 用戶端元件，且有權存取將用來儲存執行個體和應用程式中繼資料之 SQL Server Database Engine 的任何電腦上，執行 nscontrol create。

在執行 Notification Services 執行個體之前，您必須先利用 nscontrol register 來註冊執行個體。登錄會建立登錄項目，並選擇性地建立 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 驗證來連接 SQL Server，以建立新的 Notification Services 執行個體。

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

請參閱

變更歷程記錄

版本	歷程記錄
2005 年 12 月 5 日	新增內容：新增有關 SQLServerNotificationServicesUser Windows 群組的資訊。

共用方式為