Comando nscontrol disable

Articolo
12/15/2008

Data aggiornamento: 5 dicembre 2005

Disattiva l'istanza, l'applicazione o il componente specificato di Microsoft SQL Server Notification Services.

Sintassi

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

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

Argomenti

-nologo
Disattiva la visualizzazione delle informazioni relative al prodotto e alla versione quando si esegue un comando nscontrol.

-help
Visualizza la sintassi del comando.

<component>
Rappresenta un componente da disattivare. È possibile specificare zero o più componenti quando si esegue il comando nscontrol disable.

Se non si specifica un componente, vengono disattivati tutti i componenti dell'istanza o dell'applicazione. Se si specifica un componente ma si omette il nome di un'applicazione tramite l'argomento -application, vengono disattivati tutti i componenti corrispondenti per tutte le applicazioni incluse nell'istanza.

L'argomento <component> può essere rappresentato dagli argomenti seguenti.

Argomento	Descrizione
-distributor [systemName]	Disattiva la distribuzione dell'istanza o dell'applicazione. Se si specifica il nome di un sistema di server di distribuzione, vengono disattivati solo i server di distribuzione in tale sistema. In caso contrario, vengono disattivati tutti i server di distribuzione per l'istanza o l'applicazione.
-events [systemName]	Disattiva i provider di eventi hosted per l'istanza o l'applicazione. Se si specifica il nome di un sistema, vengono disattivati solo i provider di eventi hosted in tale sistema. In caso contrario, vengono disattivati tutti i provider di eventi hosted per l'istanza o l'applicazione.
-generator	Disattiva il generatore.
-subscriptions	Disattiva la gestione delle sottoscrizioni.
-subscribers	Disattiva la gestione dei Sottoscrittori per l'istanza di Notification Services.

-nameinstanceName
Specifica il nome dell'istanza interessata dal comando nscontrol disable. Se si specifica l'argomento -name senza specificare -application o un componente, il comando nscontrol disattiva tutte le applicazioni e tutti i componenti.

Vedere l'argomento -server per ulteriori informazioni sull'utilizzo dell'argomento --name con l'argomento --server.

-serverdatabaseServer
Specifica il nome del server che ospita i database dell'istanza e dell'applicazione. Se si utilizza un'istanza denominata di SQL Server per ospitare i database, è necessario specificare il nome del server e dell'istanza utilizzando il formato <servername>\<instancename>.

Se si esegue il comando nscontrol disable in un sistema in cui l'istanza è stata precedentemente registrata tramite il comando nscontrol register, utilizzare l'argomento -name ma non l'argomento -server. L'utilità nscontrol determina il nome dell'istanza di SQL Server grazie alla lettura delle informazioni del Registro di sistema relative all'istanza.

Se si esegue il comando nscontrol disable in un sistema in cui l'istanza non è registrata, è necessario utilizzare entrambi gli argomenti -name e -server in quanto l'utilità nscontrol richiede sia il nome dell'istanza di Notification Services che il nome dell'istanza di SQL Server per individuare il database dell'istanza.

Se si specifica l'argomento -server, l'utilità nscontrol ignora i valori del Registro di sistema per l'istanza specifica.

-applicationapplicationName
Specifica il nome dell'applicazione in cui vengono disattivati uno o più componenti. Se non si specifica il nome di un'applicazione, vengono disattivati i componenti per tutte le applicazioni incluse nell'istanza.

-sqlusernamesqlUserName
Specifica l'account di accesso di SQL Server utilizzato per connettersi a SQL Server.

Se si utilizza l'autenticazione di SQL Server per connettersi a SQL Server, specificare l'account di accesso tramite questo argomento. Specificare inoltre una password tramite l'argomento -sqlpassword.

Se si utilizza l'autenticazione di Windows, non specificare gli argomenti -sqlusername e -sqlpassword.

Importante:

Se possibile, utilizzare l'autenticazione di Windows.

-sqlpasswordsqlPassword
Specifica la password associata all'account di accesso -sqlusername. Questo argomento deve essere utilizzato in combinazione con l'argomento -sqlusername.

Osservazioni

Il comando nscontrol disable modifica lo stato dei componenti specificati in Disattivazione in sospeso mediante l'aggiornamento di un valore in un database. Lo stato dell'istanza viene archiviato nel database dell'istanza, mentre lo stato dei singoli componenti viene archiviato nel database dell'applicazione.

Quando si esegue il comando nscontrol disable, Notification Services trasmette le modifiche di stato desiderate a tutti i componenti. Lo stato passa da "Disattivazione in sospeso" a "Disattivato" quando tutti i componenti in esecuzione hanno risposto alla modifica. A eccezione dei componenti dei Sottoscrittori e delle sottoscrizioni, l'istanza deve essere in esecuzione affinché lo stato dei componenti venga modificato da Disattivazione in sospeso a Disattivato. La variazione dello stato da Attivazione in sospeso a Disattivato oppure da Disattivazione in sospeso ad Attivato non richiede tuttavia che il servizio sia in esecuzione poiché queste azioni annullano eventuali operazioni in sospeso.

In seguito alla modifica del database, il comando nscontrol disable visualizza lo stato corrente dell'istanza, delle applicazioni e dei componenti. Per una descrizione dei valori relativi allo stato, vedere Visualizzazione dello stato delle istanze, delle applicazioni e dei componenti.

Quando un motore, in genere il servizio Windows NS$instance_name, viene avviato, esso determina la posizione (il relativo nome host) in cui è in esecuzione e quindi confronta questo valore con il valore SystemName per ogni server di distribuzione, provider di eventi hosted e generatore. Se il nome host corrisponde al valore SystemName, il servizio verifica lo stato del componente. Se il componente è attivato, esso viene eseguito nel server. Se invece è disattivato, il componente non è in esecuzione.

Il servizio in esecuzione controlla il database ogni 30 secondi per determinare lo stato dei provider di eventi hosted, il generatore e i server di distribuzione. Se vengono apportate modifiche allo stato di uno qualsiasi dei componenti, sono quindi necessari fino a 30 secondi per rendere effettive tali modifiche.

Lo stato dei Sottoscrittori e delle sottoscrizioni viene archiviato nel server di database e gli oggetti per la gestione delle sottoscrizioni controllano tale stato prima di eseguire le operazioni di sottoscrizione o dei Sottoscrittori.

Autorizzazioni

L'account utilizzato per l'esecuzione di nscontrol disable oppure l'ID di accesso di SQL Server specificato dall'argomento -sqlusername può ottenere le autorizzazioni appropriate tramite l'appartenenza al ruolo di database NSAdmin nei singoli database dell'applicazione e dell'istanza. Anche i membri del ruolo di database db_owner e dei ruoli predefiniti del server sysadmin e dbcreator possono eseguire il comando nscontrol disable.

L'account deve inoltre disporre delle autorizzazioni necessarie per eseguire i file binari di Notification Services. Tali autorizzazioni vengono concesse ai membri dei gruppi di Windows Administrators e SQLServerNotificationServicesUser.

Esempi

A. Disattivazione dell'intera istanza di Notification Services

Nell'esempio seguente viene disattivata l'intera istanza di Notification Services denominata StockInstance. Il comando nscontrol utilizza l'autenticazione di Windows per la connessione a SQL Server. È necessario che l'istanza sia registrata nel computer in cui si esegue il comando.

nscontrol disable -name StockInstance

B. Disattivazione di una singola applicazione

Nell'esempio seguente vengono disattivati tutti i componenti dell'applicazione Stock ospitati dall'istanza StockInstance di Notification Services. Il comando nscontrol utilizza l'autenticazione di Windows per la connessione a SQL Server. È necessario che l'istanza sia registrata nel computer in cui si esegue il comando.

nscontrol disable -name StockInstance -application Stock

C. Disattivazione di tutti i provider di eventi hosted

Nell'esempio seguente vengono disattivate tutte le raccolte di eventi per tutte le applicazioni nell'istanza StockInstance di Notification Services. Il comando nscontrol utilizza l'autenticazione di Windows per la connessione a SQL Server. È necessario che l'istanza sia registrata nel computer in cui si esegue il comando.

nscontrol disable -name StockInstance -events

D. Disattivazione di un'istanza da un computer di amministrazione

Se si esegue il comando nscontrol disable da un computer in cui l'istanza StockInstance non è registrata, è necessario specificare il nome dell'istanza di SQL Server tramite l'argomento -server. Nell'esempio seguente viene illustrato come disattivare un'istanza se i database si trovano in un'istanza di SQL Server denominata nsuetest. Il comando nscontrol utilizza l'autenticazione di Windows per la connessione a SQL Server.

nscontrol disable -name StockInstance -server nsuetest

E. Disattivazione di un'istanza tramite l'autenticazione di SQL Server

Importante:
Se possibile, utilizzare l'autenticazione di Windows.

Nell'esempio seguente viene disattivata l'intera istanza di Notification Services denominata StockInstance. Il comando nscontrol utilizza l'autenticazione di SQL Server per la connessione a SQL Server. È necessario che l'istanza sia registrata nel computer in cui si esegue il comando.

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

Vedere anche

Cronologia modifiche

Versione	Cronologia
5 dicembre 2005	Nuovo contenuto Aggiunta di informazioni sul gruppo di Windows SQLServerNotificationServicesUser.

Condividi tramite