nscontrol register 命令

發行項
12/15/2008

更新： 2005 年 12 月 5 日

建立或更新 Notification Services 執行個體的登錄項目、建立執行個體的效能計數器，以及選擇性地建立一項 Microsoft Windows 服務來執行這個執行個體。

語法

nscontrol register 
    [-nologo]
    [-help]
    -name instanceName
    [-server databaseServer]
    [-service
        [-serviceusername NSServiceUserName [-servicepassword NSServicePwd]
        [-sqlusername NSServiceSqlUserName  -sqlpassword NSServiceSqlPwd]
        [-argumentkey key]]

引數

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

-help
顯示命令語法。

-nameinstanceName
這是要註冊的執行個體名稱。

-serverdatabaseServer
這是主控執行個體資料庫的伺服器名稱。如果您利用 SQL Server 的具名執行個體來主控執行個體資料庫，您必須利用 <servername>\<instancename> 格式來指定伺服器名稱和執行個體名稱。如果您沒有指定資料庫伺服器名稱，nscontrol register 會使用本機伺服器名稱。

-service
建立 NS$instance_name Windows 服務來控制伺服器中的 Notification Services 執行個體。

您通常會在執行主控的事件提供者、產生器或散發者的任何伺服器中使用 -server 引數。在只執行訂閱管理介面、非主控事件提供者或管理應用程式的伺服器中，您不需要使用這個引數。

如果您正在自己的應用程式中主控 Notification Services 引擎，請勿使用 -service 引數。如需有關主控引擎的詳細資訊，請參閱＜主控 Notification Services 引擎＞。

-serviceusernameNSServiceUserName
這是 Windows 服務用來存取本機和遠端資源的 Windows 帳戶。如果使用 Windows 驗證，Windows 服務也會利用這個帳戶來登入 SQL Server 以及存取執行個體和應用程式資料庫。

如果是本機和網域帳戶，這個引數必須搭配 -servicepassword 引數一起使用。內建的帳戶 (如 NetworkService) 沒有密碼。

在 Microsoft Windows XP 中，如果未指定 -serviceusername 和 -servicepassword 的話，會使用預設的 NT AUTHORITY\NetworkService 帳戶。其他作業系統則需要 -serviceusername 和 -servicepassword。

附註：
基於安全性的考量，您應該以最小的權限來執行這個服務帳戶，而不是以管理員或 LocalSystem 服務帳戶的身分來執行。如需詳細資訊，請參閱＜為 Notification Services 的執行個體設定 Windows 帳戶＞。

如果使用 Windows 驗證，這個帳戶必須有執行個體和應用程式資料庫中的權限。如需詳細資訊，請參閱＜為 Notification Services 的執行個體設定 SQL Server 權限＞。

-servicepasswordNSServicePwd
這是與 -serviceusername 相關聯的密碼。這個引數必須搭配 -serviceusername 引數一起使用。

-sqlusernameNSServiceSqlUserName
這是 NS$<instance_name> Windows 服務用來連接 SQL Server 的 SQL Server 登入。

如果您利用 SQL Server 驗證來連接 SQL Server，您必須同時指定 -sqlusername 和 -sqlpassword 引數。

如果您是使用 Windows 驗證，請勿指定 -sqlusername 和 -sqlpassword 引數。

附註：

如果您將 SQL Server 使用者名稱和密碼指派給服務，這項資訊會加密並儲存在登錄中。如果不要儲存這項資訊，請改用 Windows 驗證。

附註：
如果您將 SQL Server 使用者名稱和密碼指派給服務，這項資訊會加密並儲存在登錄中。如果不要儲存這項資訊，請改用 Windows 驗證。

-sqlpasswordNSServiceSqlPwd
這是與 -sqlusername 登入相關聯的密碼。這個引數必須搭配 -sqlpassword 引數一起使用。

-argumentkeykey
這是用來加密傳遞通道和 Notification Services 資料庫所儲存之事件提供者引數的值。只有在指定了 –service 引數的情況下，才使用這個金鑰；否則，便會忽略它。

如果您利用加密金鑰來註冊執行個體，在建立和更新執行個體時，您必須使用相同的金鑰。若要這麼做，組態檔中的 EncryptArguments 值必須是 true。

這個金鑰是最多 2500 個字元的字串。nscontrol register 會加密這個金鑰值，將它儲存在登錄中；如此 NS$instance_name Windows 服務才能夠讀取加密的引數。

利用 nscontrol create 或 SQL Server Management Studio 中的 [新的 Notification Services 執行個體] 命令建立好執行個體之後，就無法改變金鑰。

備註

nscontrol register 命令必須在本機執行。您不能在遠端伺服器註冊 Notification Services。

如果您利用 SQL Server 驗證來連接 SQL Server，且您需要更新服務所用的 SQL Server 使用者名稱或密碼，您必須利用 nscontrol register 或 SQL Server Management Studio 中之 Notification Services 的 [註冊] 對話方塊來變更登入資訊。Notification Services 會加密這個使用者名稱和密碼，並將它們儲存在只有管理員和 Windows 服務能夠存取的登錄中。

如果您利用 -argumentkey 來指定加密金鑰值，nscontrol register 命令會將這個金鑰加密，並將它儲存在登錄中。這個金鑰受到安全維護，只有本機管理員群組的成員及用來執行 NS$instance_name 服務的帳戶可以讀取這個金鑰。

權限

用來執行 nscontrol register 的帳戶也必須有權限執行 Notification Services 二進位檔；此權限已授與 Administrators 和 SQLServerNotificationServicesUser Windows 群組的成員。如果您建立 Windows 服務和效能計數器，則帳戶必須是 Administrators 群組的成員。

如需有關 Notification Services 中 NS$instance_name Windows 服務所需要之權限的資訊，請參閱＜保全 Notification Services＞。

範例

下列範例說明註冊執行個體的三種不同形式。

A. 註冊執行個體，建立一項 Windows 服務

這個範例會顯示如何利用 Windows 驗證來連接 SQL Server，以註冊名稱為 StockInstance 的執行個體。利用下列引數來註冊執行個體，會建立這個執行個體的一項 Windows 服務、定義這個 Windows 服務用來存取 SQL Server (以及啟動和存取 Windows 資源) 的使用者名稱和密碼，以及提供主控資料庫的 SQL Server 執行個體名稱。

nscontrol register -name StockInstance -server nsuetest -service 
    -serviceusername SvcAcct -servicepassword svC-P@sWd

B. 註冊執行個體，但不建立 Windows 服務

這個範例會顯示如何在下列狀況下，註冊名稱為 StockInstance 的執行個體：

訂閱管理介面或獨立的事件提供者在伺服器中，但伺服器不會執行主控的事件提供者、產生器或散發者。
執行主控的事件提供者、產生器和散發者的 Notification Services 引擎是在自訂應用程式中，因此，並不需要 Windows 服務。

在這些狀況中，您必須註冊執行個體，使執行個體元件能夠找到資料庫，但您並不利用 -server 引數來建立 Windows 服務。

您也可以利用這個範例來更新現有登錄項目中的資料庫伺服器名稱。

nscontrol register -name StockInstance -server nsuetest

C. SQL Server 驗證

重要事項：
可能的話，請使用「Windows 驗證」。

這個範例會顯示如何註冊 Notification Services 的執行個體、建立 Windows 服務，以及提供服務用來連接 SQL Server 的 SQL Server 驗證。請注意，這項服務同時需要 SQL Server 帳戶和密碼，以及 Windows 帳戶和密碼。這項服務利用 Windows 權限來啟動和存取非資料庫資源，並利用 SQL Server 帳戶來存取資料庫。

nscontrol register -name StockInstance -server nsuetest -service 
    -serviceusername SvcAcct -servicepassword svC-P@sWd 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

請參閱

變更歷程記錄

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

共用方式為