nscontrol disable 命令

發行項
12/15/2008

更新： 2005 年 12 月 5 日

停用指定的 Microsoft SQL Server Notification Services 執行個體、應用程式或元件。

語法

nscontrol disable 
    [-nologo]
    [-help]
    [<component> [...n ]]
        -name instanceName
    [-server databaseServer]
    [-application applicationName]
    [-sqlusername sqlUserName -sqlpassword sqlPassword]

< component > ::=
    -events [systemName]
    | -generator
    | -distributor [systemName]
    | -subscriptions
    | -subscribers

引數

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

-help
顯示命令語法。

<component>
代表要停用的元件。當您執行 nscontrol disable 時，您可以指定零或多個元件。

如果您沒有指定元件，就會停用執行個體或應用程式的所有元件。如果您指定元件，但沒有利用 -application 引數來指定應用程式名稱，就會停用執行個體所主控之所有應用程式中的所有相符元件。

<component> 可以是下列中的任何引數：

引數	描述
-distributor [systemName]	停用執行個體或應用程式的散發。如果您指定了散發者系統名稱，便只會停用這個系統的散發者。否則，會停用執行個體或應用程式的所有散發者。
-events [systemName]	停用執行個體或應用程式的主控事件提供者。如果您指定了系統名稱，便只會停用這個系統的主控事件提供者。否則，會停用執行個體或應用程式的所有主控事件提供者。
-generator	停用產生器。
-subscriptions	停用訂閱管理。
-subscribers	停用 Notification Services 執行個體的訂閱者管理。

-nameinstanceName
指定 nscontrol disable 所影響的執行個體名稱。如果您指定 -name 引數，但沒有指定 -application 或元件，nscontrol 會停用所有執行個體應用程式和元件。

請參閱 -server 引數，以取得搭配 -server 引數來使用 -name 引數的相關資訊。

-serverdatabaseServer
指定主控執行個體和應用程式資料庫的伺服器名稱。如果您利用 SQL Server 的具名執行個體來主控資料庫，您必須利用 <servername>\<instancename> 格式來指定伺服器名稱和執行個體名稱。

當您在先前利用 nscontrol register 命令將執行個體登錄在其中的系統上執行 nscontrol disable 時，請使用 -name 引數，不要用 -server 引數。nscontrol 公用程式會讀取執行個體的登錄資訊來確定 SQL Server 執行個體的名稱。

當您在執行個體尚未登錄在其中的系統上執行 nscontrol disable 時，您必須同時使用 -name 和 -server 引數，因為 nscontrol 公用程式同時需要 Notification Services 和 SQL Server 的執行個體名稱，才能找到執行個體資料庫。

當您指定 -server 引數時，nscontrol 公用程式會忽略執行個體的任何登錄值。

-applicationapplicationName
指定要停用一或多個元件的應用程式名稱。如果您沒有指定應用程式名稱，就會停用執行個體所主控的所有應用程式的元件。

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

如果您利用 SQL Server 驗證來連接 SQL Server，請利用這個引數來指定登入。另外，也請利用 -sqlpassword 引數來指定密碼。

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

重要事項：

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

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

備註

nscontrol disable 命令會更新資料庫中的值，而將指定元件的狀態改成「停用暫止」。執行個體狀態儲存在執行個體資料庫中。個別元件狀態儲存在應用程式資料庫中。

當您執行 nscontrol disable 時，Notification Services 會向所有元件廣播所需要的狀態變更。所有執行中的元件都回應這項變更之後，「停用暫止」狀態會改成「已停用」。除了訂閱者和訂閱元件，執行個體必須在執行中，元件狀態才能從「停用暫止」改成「已停用」。不過，將狀態從「啟用暫止」改成「已停用」，或從「停用暫止」改成「已啟用」，服務並不需要在執行中，因為這些動作只會取消暫止作業。

在 nscontrol disable 修改資料庫之後，它會顯示執行個體、應用程式和元件目前的狀態。如需狀態值的描述，請參閱＜檢視執行個體、應用程式與元件的狀態＞。

當引擎 (通常是 NS$instance_name Windows 服務) 啟動時，它會先判斷執行所在的位置 (它的主機名稱)，再比較這個值和每個散發者、主控事件提供者以及產生器的 SystemName 值。如果主機名稱符合 SystemName 值，服務會檢查元件的狀態。如果元件已啟用，便會在伺服器中執行它。如果元件已停用，便不會執行它。

當服務在執行中，它會每隔 30 秒檢查一次資料庫來判斷主控事件提供者、產生器和散發者的狀態。因此，如果您變更任何這些元件的狀態，可能需要花 30 秒，變更才會生效。

訂閱者和訂閱狀態儲存在資料庫伺服器中，訂閱管理物件會檢查這個狀態，再執行訂閱或訂閱者作業。

權限

用來執行 nscontrol disable 的帳戶，或 -sqlusername 引數所指定的 SQL Server 登入識別碼，可以利用個別應用程式和執行個體資料庫中之 NSAdmin 資料庫角色的成員資格來取得適當的權限。db_owner 資料庫角色以及系統管理員 (sysadmin) 和資料庫建立者 (dbcreator) 固定伺服器角色的成員，也可以執行 nscontrol disable。

此帳戶也必須有權限執行 Notification Services 二進位檔；此權限已授與 Administrators 和 SQLServerNotificationServicesUser Windows 群組的成員。

範例

A. 停用整個 Notification Services 執行個體

下列範例會停用名稱為 StockInstance 的整個 Notification Services 執行個體。nscontrol 命令會利用 Windows 驗證來連接 SQL Server。您必須在執行命令的電腦中登錄這個執行個體。

nscontrol disable -name StockInstance

B. 停用單一應用程式

下列範例會停用 Notification Services 的 StockInstance 執行個體所主控之 Stock 應用程式的所有元件。nscontrol 命令會利用 Windows 驗證來連接 SQL Server。您必須在執行命令的電腦中登錄這個執行個體。

nscontrol disable -name StockInstance -application Stock

C. 停用所有主控事件提供者

下列範例會停用 Notification Services 的 StockInstance 執行個體中之所有應用程式的所有事件集合。nscontrol 命令會利用 Windows 驗證來連接 SQL Server。您必須在執行命令的電腦中登錄這個執行個體。

nscontrol disable -name StockInstance -events

D. 從管理電腦中停用執行個體

如果您從尚未登錄 StockInstance 的電腦中執行 nscontrol disable，您必須利用 -server 引數來提供 SQL Server 執行個體名稱。下列範例顯示，當資料庫位於 SQL Server 的執行個體 nsuetest 中時，應如何停用執行個體。nscontrol 命令會利用 Windows 驗證來連接 SQL Server。

nscontrol disable -name StockInstance -server nsuetest

E. 利用 SQL Server 驗證來停用執行個體

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

下列範例會停用名稱為 StockInstance 的整個 Notification Services 執行個體。nscontrol 命令會利用 SQL Server 驗證來連接 SQL Server。您必須在執行命令的電腦中登錄這個執行個體。

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

請參閱

變更歷程記錄

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

共用方式為