Comando nscontrol enable

Data aggiornamento: 5 dicembre 2005

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

Sintassi

nscontrol enable 
    [-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 >
  Specifica il componente da attivare. È possibile specificare zero o più componenti quando si esegue il comando nscontrol enable.

  Se non si specifica il nome di un componente, verranno attivati tutti i componenti dell'istanza o dell'applicazione. Se si specifica un componente ma non si indica il nome di un'applicazione tramite l'argomento -application, tutti i componenti corrispondenti verranno attivati per tutte le applicazioni ospitate dall'istanza.

  < L'argomento component> può essere uno degli argomenti seguenti.

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

• -nameinstanceName
  Nome dell'istanza interessata dal comando nscontrol enable. Se si specifica l'argomento –name senza specificare –application o un componente, l'utilità nscontrol attiva tutte le applicazioni e tutti i componenti.

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

• -serverdatabaseServer
  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 enable in un sistema in cui l'istanza è stata precedentemente registrata utilizzando 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 enable 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
  Nome dell'applicazione per la quale uno o tutti i componenti verranno disattivati. Se non si specifica il nome di un'applicazione, i componenti specificati verranno attivati per tutte le applicazioni ospitate dall'istanza.

• -sqlusernamesqlUserName
  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 un 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
  Password associata all'account di accesso -sqlusername. Questo argomento deve essere utilizzato in combinazione con l'argomento -sqlusername.

Osservazioni

Il comando nscontrol enable imposta lo stato dei componenti specificati su Attivazione 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 enable, Notification Services trasmette le modifiche di stato desiderate a tutti i componenti. Lo stato passa da Attivazione in sospeso ad Attivato quando tutti i componenti in esecuzione hanno risposto alla modifica. Ad eccezione del Sottoscrittore e dei componenti di sottoscrizione, è necessario che il motore, in genere il servizio Windows NS$instance_name, sia in esecuzione affinché lo stato dei componenti venga modificato da Attivazione in sospeso ad Attivato. 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 enable 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 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 avviato.

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.

Lo stato dei Sottoscrittori e delle sottoscrizioni viene memorizzato nella cache del 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 enable oppure l'account 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 enable.

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: Attivazione di un'istanza di Notification Services

Nell'esempio seguente viene attivata l'intera istanza di Notification Services denominata StockInstance. È necessario che l'istanza sia registrata nel computer in cui si esegue il comando seguente.

nscontrol enable -name StockInstance

B. Attivazione di una singola applicazione

Nell'esempio seguente vengono attivati tutti i componenti dell'applicazione Stock ospitati 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 enable -name StockInstance -application Stock

C. Attivazione di tutti i provider di eventi hosted

Nell'esempio seguente vengono attivati tutti i provider di eventi hosted 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 enable -name StockInstance -events

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

Se si esegue il comando nscontrol enable 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 attivare 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 enable -name StockInstance -server nsuetest

E. Utilizzo dell'autenticazione di SQL Server per attivare un'istanza di Notification Services

Nell'esempio seguente viene attivata l'intera istanza di Notification Services denominata StockInstance, utilizzando l'autenticazione di SQL Server per connettersi a SQL Server. È necessario che l'istanza sia registrata nel computer in cui si esegue il comando seguente.

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

Vedere anche

Riferimento

Utilità nscontrol

Altre risorse

Attivazione e disattivazione di istanze, applicazioni o componenti

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche

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