nscontrol register (Befehl)

Aktualisiert: 05. Dezember 2005

Erstellt oder aktualisiert Registrierungseinträge für eine Notification Services-Instanz, erstellt Leistungsindikatoren für die Instanz und erstellt optional einen Microsoft Windows-Dienst zum Ausführen der Instanz.

Syntax

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

Argumente

• -nologo
  Unterdrückt die Anzeige der Produkt- und Versionsangabe beim Ausführen eines nscontrol-Befehls.

• -help
  Zeigt die Befehlssyntax an.

• -nameinstanceName
  Der Name der zu registrierenden Instanz.

• -serverdatabaseServer
  Der Name des Servers, der die Instanzdatenbank hostet. Wenn Sie eine benannte SQL Server-Instanz zum Hosten der Instanzdatenbank verwenden, müssen Sie den Servernamen und den Instanznamen im Format <servername>\<instancename> angeben. Wenn Sie keinen Datenbank-Servernamen angeben, verwendet nscontrol register den Namen des lokalen Servers.

• -service
  Erstellt den Windows-Dienst NS$instance_name, der die Notification Services-Instanz auf dem Server steuert.

  Sie verwenden das -server-Argument üblicherweise für jeden Server, der einen gehosteten Ereignisanbieter, Generator oder Verteiler ausführt. Es ist nicht notwendig, dieses Argument für Server zu verwenden, die nur Schnittstellen für die Abonnementverwaltung, nicht gehostete Ereignisanbieter oder Verwaltungsanwendungen ausführen.

  Wenn Sie das Notification Services-Modul in einer eigenen Anwendung hosten, sollten Sie das -service-Argument nicht verwenden. Weitere Informationen zum Hosten des Moduls finden Sie unter Hosten des Notification Services-Moduls.

• -serviceusernameNSServiceUserName
  Das Windows-Konto, das der Windows-Dienst für den Zugriff auf lokale und Remoteressourcen verwendet. Wenn Sie die Windows-Authentifizierung verwenden, verwendet der Windows-Dienst dieses Konto zudem, um sich bei SQL Server anzumelden und auf Instanz- und Anwendungsdatenbanken zuzugreifen.

  Bei lokalen und Domänenkonten muss dieses Argument zusammen mit dem -servicepassword-Argument verwendet werden. Für integrierte Konten, wie z. B. das Konto Netzwerkdienst, wird kein Kennwort verwendet.

  Falls in Microsoft Windows XP die Argumente -serviceusername und -servicepassword nicht angegeben werden, wird das Standardkonto NT-AUTORITÄT\Netzwerkdienst verwendet. Bei anderen Betriebssystemen sind -serviceusername und -servicepassword erforderlich.

  Hinweis:
  Aus Sicherheitsgründen sollte das Dienstkonto nur über Mindestberechtigungen verfügen und weder mit einem Administratorkonto noch mit dem Dienstkonto Lokales System identisch sein. Weitere Informationen finden Sie unter Konfigurieren von Windows-Konten für eine Instanz von Notification Services.

  Wenn Sie die Windows-Authentifizierung verwenden, muss dieses Konto über Berechtigungen in den Instanz- und Anwendungsdatenbanken verfügen. Weitere Informationen finden Sie unter Konfigurieren von SQL Server-Berechtigungen für eine Instanz von Notification Services.

• -servicepasswordNSServicePwd
  Das Kennwort, das dem Konto in -serviceusername zugeordnet ist. Dieses Argument muss zusammen mit dem -serviceusername-Argument verwendet werden.

• -sqlusernameNSServiceSqlUserName
  Der SQL Server-Anmeldename, den der Windows-Dienst NS$instance_name für die Verbindung mit SQL Server verwendet.

  Wenn Sie die SQL Server-Authentifizierung für die Verbindung mit SQL Server verwenden, müssen Sie sowohl das -sqlusername- als auch das -sqlpassword-Argument angeben.

  Wenn Sie die Microsoft Windows-Authentifizierung verwenden, geben Sie die Argumente -sqlusername und -sqlpassword nicht an.

  Hinweis:
  Wenn Sie dem Dienst einen SQL Server-Benutzernamen und ein Kennwort zuweisen, werden diese Informationen verschlüsselt und in der Registrierung gespeichert. Wenn Sie das Speichern dieser Informationen vermeiden möchten, müssen Sie stattdessen die Windows-Authentifizierung verwenden.

• -sqlpasswordNSServiceSqlPwd
  Das Kennwort, das mit dem -sqlusername-Anmeldenamen verknüpft ist. Dieses Argument muss zusammen mit dem -sqlusername-Argument verwendet werden.

• -argumentkeykey
  Der Wert, der zum Verschlüsseln von Übermittlungskanal- und Ereignisanbieterargumenten verwendet wird, die in Notification Services-Datenbanken gespeichert sind. Der Schlüssel wird nur verwendet, wenn das -service-Argument angegeben wurde; andernfalls wird der Schlüssel ignoriert.

  Wenn Sie die Instanz mithilfe eines Verschlüsselungsschlüssels registrieren, müssen Sie denselben Schlüssel beim Erstellen und Aktualisieren der Instanz verwenden. Hierzu muss EncryptArguments in der Konfigurationsdatei den Wert true aufweisen.

  Der Schlüssel besteht aus einer Zeichenfolge von bis zu 2500 Zeichen. nscontrol register verschlüsselt den Schlüsselwert und speichert ihn in der Registrierung; dies ist erforderlich, damit der Windows-Dienst NS$instance_name die verschlüsselten Argumente lesen kann.

  Der Schlüssel kann nach dem Erstellen der Instanz (mithilfe von nscontrol create oder mit dem Befehl Neue Notification Services-Instanz in SQL Server Management Studio) nicht mehr geändert werden.

Hinweise

Der Befehl nscontrol register muss lokal ausgeführt werden. Sie können Notification Services nicht auf einem Remoteserver registrieren.

Wenn Sie die SQL Server-Authentifizierung für die Verbindung mit SQL Server verwenden und den vom Dienst verwendeten SQL Server-Benutzernamen und das zugehörige Kennwort aktualisieren müssen, dann müssen sie die Anmeldeinformationen mithilfe von nscontrol register oder mit dem Dialogfeld Registrieren für Notification Services in SQL Server Management Studio ändern. Notification Services verschlüsselt den Benutzernamen und das Kennwort und speichert die Informationen in der Registrierung, sodass nur Administratoren und der Windows-Dienst darauf zugreifen können.

Wenn Sie einen Schlüsselwert mit dem Argument -argumentkey angeben, verschlüsselt nscontrol register den Schlüssel und speichert ihn in der Registrierung. Der Schlüssel wird so gesichert, dass nur Mitglieder der lokalen Gruppe Administratoren und das Konto, über das der Dienst NS$instance_name ausgeführt wird, den Schlüssel lesen können.

Berechtigungen

Darüber hinaus muss das Konto, das zum Ausführen von nscontrol register verwendet wird, über die Berechtigung zum Ausführen der Notification Services-Binärdateien verfügen. Diese Berechtigung wird Mitgliedern der Windows-Gruppen Administratoren und SQLServerNotificationServicesUser erteilt. Beim Erstellen eines Windows-Dienstes und von Leistungsindikatoren muss das Konto ein Mitglied der lokalen Gruppe Administratoren sein.

Weitere Informationen zu den Berechtigungen, die der Windows-Dienst NS$instance_name für Notification Services benötigt, finden Sie unter Sichern von Notification Services.

Beispiele

Die folgenden Beispiele veranschaulichen drei verschiedene Formen der Registrierung einer Instanz.

A. Registrieren einer Instanz und Erstellen eines Windows-Dienstes

In diesem Beispiel wird gezeigt, wie Sie die Instanz mit dem Namen StockInstance registrieren, wobei die Windows-Authentifizierung für die Verbindung mit SQL Server verwendet wird. Durch das Registrieren der Instanz mithilfe der folgenden Argumente werden ein Windows-Dienst für die Instanz erstellt, der Benutzername und das Kennwort definiert, den bzw. das der Windows-Dienst für den Zugriff auf SQL Server (und für den Start und den Zugriff auf Windows-Ressourcen) verwendet, und der Name der SQL Server-Instanz bereitgestellt, die die Datenbanken hostet.

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

B. Registrieren einer Instanz, ohne einen Windows-Dienst zu erstellen

In diesem Beispiel wird gezeigt, wie die Instanz mit dem Namen StockInstance in den folgenden Szenarien registriert wird:

• Auf dem Server befindet sich eine Schnittstellen für die Abonnementverwaltung oder ein unabhängiger Ereignisanbieter. Der Server führt jedoch keinen gehosteten Ereignisanbieter, Generator oder Verteiler aus.
• Das Notification Services-Modul, das gehostete Ereignisanbieter, Generatoren und Verteiler ausführt, wird von einer benutzerdefinierten Anwendung gehostet; der Windows-Dienst ist somit nicht notwendig.

In diesen Szenarien müssen Sie die Instanz registrieren, damit Instanzkomponenten die Datenbanken finden können. Es ist jedoch nicht erforderlich, das -server-Argument zu verwenden, um einen Windows-Dienst zu erstellen.

Sie können dieses Beispiel auch verwenden, um den Datenbank-Servernamen in einem vorhandenen Registrierungseintrag zu aktualisieren.

nscontrol register -name StockInstance -server nsuetest

C. SQL Server-Authentifizierung

Wichtig:
Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.

In diesem Beispiel wird gezeigt, wie eine Notification Services-Instanz registriert, der Windows-Dienst erstellt und Informationen für die SQL Server-Authentifizierung bereitgestellt werden, die der Dienst für die Verbindung mit SQL Server verwendet. Beachten Sie, dass für den Dienst sowohl ein SQL Server-Konto und -Kennwort und als auch ein Windows-Konto und -Kennwort erforderlich sind. Der Dienst verwendet die Windows-Berechtigungen für den Start und den Zugriff auf datenbankfremde Ressourcen und das SQL Server-Konto für den Zugriff auf Datenbanken.

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

Siehe auch

Verweis

nscontrol (Dienstprogramm)

Andere Ressourcen

Bereitstellen einer Notification Services-Instanz
Aktualisieren von Registrierungsinformationen
EncryptArguments Element (ICF)
Hosten des Notification Services-Moduls

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf