Comando nscontrol register

Articolo
12/15/2008

Data aggiornamento: 5 dicembre 2005

Crea o aggiorna le voci del Registro di sistema per un'istanza di Notification Services, crea i contatori delle prestazioni per l'istanza e, come opzione facoltativa, crea un servizio Windows Microsoft per eseguire l'istanza.

Sintassi

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

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.

-nameinstanceName
Nome dell'istanza da registrare.

-serverdatabaseServer
Nome del server che ospita il database dell'istanza. Se si utilizza un'istanza denominata di SQL Server per ospitare il database dell'istanza, è necessario specificare il nome sia del server che dell'istanza utilizzando il formato <servername>\<instancename>. Se non si specifica un nome di server del database, il comando nscontrol register utilizzerà il nome del server locale.

-service
Crea il servizio Windows NS$instance_name che controlla l'istanza di Notification Services nel server.

In genere viene utilizzato l'argomento -server su qualsiasi server che esegue un provider di eventi hosted, un generatore o un server di distribuzione. Non è necessario utilizzare questo argomento su server che eseguono solo interfacce per la gestione delle sottoscrizioni, provider di eventi non hosted o applicazioni di gestione.

Se nell'applicazione è ospitato il motore di Notification Services, non utilizzare l'argomento -service. Per ulteriori informazioni sull'hosting del motore, vedere Hosting del motore di Notification Services.

-serviceusernameNSServiceUserName
Account di Windows utilizzato dal servizio Windows per accedere alle risorse locali e remote. Se si utilizza l'autenticazione di Windows, il servizio Windows utilizza questo account anche per accedere a SQL Server e connettersi ai database dell'istanza e dell'applicazione.

Per gli account locali e di dominio, questo argomento deve essere utilizzato in combinazione con l'argomento -servicepassword. Gli account predefiniti, ad esempio NetworkService, non dispongono di password.

In Microsoft Windows XP, se si omettono gli argomenti -serviceusername e -servicepassword verrà utilizzato l'account predefinito NT AUTHORITY\NetworkService. Per gli altri sistemi operativi, gli argomenti -serviceusername e -servicepassword sono obbligatori.

[!NOTA] Per motivi di sicurezza, è consigliabile eseguire il servizio nel contesto di un account con autorizzazioni minime, evitando di utilizzare un account del gruppo Administrators o l'account LocalSystem. Per ulteriori informazioni, vedere Configurazione degli account di Windows per un'istanza di Notification Services.

Se si utilizza l'autenticazione di Windows, questo account deve disporre delle autorizzazioni nei database dell'istanza e dell'applicazione. Per ulteriori informazioni, vedere Configurazione delle autorizzazioni di SQL Server per un'istanza di Notification Services.

-servicepasswordNSServicePwd
Password associata a -serviceusername. Questo argomento deve essere utilizzato in combinazione con l'argomento -serviceusername.

-sqlusernameNSServiceSqlUserName
Account di accesso di SQL Server utilizzato dal servizio Windows NS$<instance_name> per connettersi a SQL Server.

Se si utilizza l'autenticazione di SQL Server per connettersi a SQL Server, è necessario specificare sia l'argomento -sqlusername che l'argomento -sqlpassword.

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

[!NOTA] Se al servizio vengono assegnati un nome utente e una password di SQL Server, tali informazioni vengono crittografate e archiviate nel Registro di sistema. Per evitare l'archiviazione di queste informazioni, utilizzare l'autenticazione di Windows.

-sqlpasswordNSServiceSqlPwd
Password associata all'account di accesso -sqlusername. Questo argomento deve essere utilizzato in combinazione con l'argomento -sqlusername.

-argumentkeykey
Valore utilizzato per crittografare gli argomenti relativi al canale di recapito e al provider di eventi archiviati nei database di Notification Services. La chiave viene utilizzata solo se si specifica l'argomento –service. In caso contrario, la chiave viene ignorata.

Se si registra l'istanza utilizzando una chiave di crittografia, è necessario utilizzare la stessa chiave per la creazione o l'aggiornamento dell'istanza. A tale scopo, il valore dell'argomento EncryptArguments nel file di configurazione deve essere impostato su true.

La chiave è una stringa contenente un massimo di 2.500 caratteri. Il comando nscontrol register crittografa il valore della chiave e lo archivia nel Registro di sistema in modo da consentire al servizio Windows NS$instance_name di leggere gli argomenti crittografati.

Non è possibile modificare la chiave dopo avere creato l'istanza. Questa operazione viene infatti eseguita tramite il comando nscontrol create o Nuova istanza di Notification Services in SQL Server Management Studio.

Osservazioni

È necessario eseguire il comando nscontrol register a livello locale. Non è possibile registrare Notification Services in un server remoto.

Se si utilizza l'autenticazione di SQL Server per connettersi a SQL Server e se è necessario aggiornare il nome utente o la password di SQL Server utilizzati dal servizio, è necessario modificare le informazioni di accesso utilizzando il comando nscontrol register o la finestra di dialogo Registra per Notification Services in SQL Server Management Studio. Notification Services crittografa il nome utente e la password e archivia queste informazioni nel Registro di sistema, al quale solo gli amministratori e il servizio Windows possono accedere.

Se si specifica un valore di chiave di crittografia tramite l'argomento -argumentkey, il comando nscontrol register crittografa tale chiave e la archivia nel Registro di sistema. La chiave viene protetta in modo che sia leggibile solo dai membri del gruppo Administrators locale e dall'account utilizzato per l'esecuzione del servizio NS$instance_name.

Autorizzazioni

L'account utilizzato per eseguire nscontrol register 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. In caso di creazione di un servizio Windows e di contatori delle prestazioni, l'account deve essere un membro del gruppo Administrators.

Per ulteriori informazioni sulle autorizzazioni richieste dal servizio Windows NS$instance_name per Notification Services, vedere Protezione di Notification Services.

Esempi

Negli esempi seguenti vengono illustrati tre diversi metodi di registrazione di un'istanza.

A. Registrazione di un'istanza e creazione di un servizio Windows

In questo esempio viene illustrato come registrare un'istanza denominata StockInstance utilizzando l'autenticazione di Windows per connettersi a SQL Server. La registrazione dell'istanza con gli argomenti seguenti crea un servizio Windows per l'istanza, definisce il nome utente e la password utilizzati da tale servizio per accedere a SQL Server e per avviare e accedere alle risorse di Windows e restituisce il nome dell'istanza di SQL Server in cui si trovano i database.

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

B. Registrazione di un'istanza senza creare un servizio Windows

In questo esempio viene illustrato come registrare un'istanza denominata StockInstance negli scenari seguenti:

Un'interfaccia per la gestione delle sottoscrizioni o un provider di eventi indipendente si trova nel server, ma il server non esegue un provider di eventi hosted, un generatore o un server di distribuzione.
Il motore di Notification Services che esegue i provider di eventi hosted, i generatori e i server di distribuzione è ospitato da un'applicazione personalizzata e per tale motivo il servizio Windows non è necessario.

In questi scenari è necessario registrare l'istanza in modo che i relativi componenti siano in grado di individuare i database. Non utilizzare tuttavia l'argomento -server per creare il servizio Windows.

Questo esempio può inoltre essere utilizzato per aggiornare il nome del server di database in una voce del Registro di sistema esistente.

nscontrol register -name StockInstance -server nsuetest

C. Autenticazione di SQL Server

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

Nell'esempio seguente viene illustrato come registrare un'istanza di Notification Services, creare il servizio Windows e specificare un'autenticazione di SQL Server che il servizio utilizzerà per connettersi a SQL Server. Il servizio richiede un account e una password di SQL Server e un account e una password di Windows. Il servizio utilizza le autorizzazioni di Windows per l'avvio e per accedere alle risorse non del database, mentre utilizza l'account di SQL Server per accedere ai database.

nscontrol register -name StockInstance -server nsuetest -service 
    -serviceusername SvcAcct -servicepassword svC-P@sWd 
    -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.

Share via