nscontrol enable (Befehl)

Aktualisiert: 05. Dezember 2005

Aktiviert die angegebene Instanz, Anwendung oder Komponente von SQL Server Notification Services.

Syntax

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

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

Argumente

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

• -help
  Zeigt die Befehlssyntax an.

• < Komponente >
  Gibt eine zu aktivierende Komponente an. Beim Ausführen von nscontrol enable können Sie keine oder auch mehrere Komponenten angeben.

  Wenn Sie keinen Komponentennamen angeben, werden alle Komponenten der Instanz oder Anwendung aktiviert. Wenn Sie eine Komponente, jedoch keinen Anwendungsnamen mithilfe des -application-Arguments angeben, werden alle entsprechenden Komponenten in allen von dieser Instanz gehosteten Anwendungen aktiviert.

  < component> kann jedes der folgenden Argumente sein:

  Argument	Beschreibung
  -distributor [systemName]	Aktiviert die Verteilung für die Instanz oder Anwendung. Wenn Sie einen Verteilersystemnamen angeben, werden nur die Verteiler auf diesem System aktiviert. Andernfalls werden alle Verteiler für die Instanz oder Anwendung aktiviert.
  -events [systemName]	Aktiviert die gehosteten Ereignisanbieter für die Instanz oder Anwendung. Wenn Sie -events mit einem Systemnamen angeben, werden nur die gehosteten Ereignisanbieter auf diesem System aktiviert. Andernfalls werden alle gehosteten Ereignisanbieter für die Instanz oder Anwendung aktiviert.
  -generator	Aktiviert den Generator.
  -subscriptions	Aktiviert die Abonnementverwaltung.
  -subscribers	Aktiviert die Abonnementverwaltung für die Notification Services-Instanz.

• -nameinstanceName
  Der Name der Instanz, auf die sich nscontrol enable auswirkt. Wenn Sie das -name-Argument angeben, ohne -application oder eine Komponente anzugeben, aktiviert das Dienstprogramm nscontrol alle Instanzanwendungen und -komponenten.

  Informationen zum Verwenden des -name-Arguments mit dem -server-Argument finden Sie unter dem Thema zum -server-Argument.

• -serverdatabaseServer
  Der Name des Servers, der die Instanz- und Anwendungsdatenbanken hostet. Wenn Sie eine benannte SQL Server-Instanz zum Hosten der Datenbanken verwenden, müssen Sie den Servernamen und den Instanznamen im Format <servername>\<instancename> angeben.

  Wenn Sie nscontrol enable auf einem System ausführen, auf dem die Instanz zuvor mithilfe des Befehls nscontrol register registriert wurde, verwenden Sie das -name-Argument, jedoch nicht das -server-Argument. Das Dienstprogramm nscontrol bestimmt den Namen der SQL Server-Instanz, indem die Registrierungsinformationen der Instanz gelesen werden.

  Wenn Sie nscontrol enable auf einem System ausführen, auf dem die Instanz nicht registriert wurde, müssen Sie sowohl das -name-Argument als auch das -server-Argument verwenden, da das Dienstprogramm nscontrol sowohl den Notification Services-Instanznamen als auch den SQL Server-Instanznamen benötigt, um die Instanzdatenbank finden zu können.

  Wenn Sie das -server-Argument angeben, werden sämtliche Registrierungswerte für die Instanz vom Dienstprogramm nscontrol ignoriert.

• -applicationapplicationName
  Der Name der Anwendung, für die eine oder alle Komponenten aktiviert werden. Wenn Sie keinen Anwendungsnamen angeben, werden die angegebenen Komponenten für alle von dieser Instanz gehosteten Anwendungen aktiviert.

• -sqlusernamesqlUserName
  Der SQL Server-Anmeldename, der zum Herstellen einer Verbindung mit SQL Server verwendet wird.

  Wenn Sie die SQL Server-Authentifizierung verwenden, um eine Verbindung mit SQL Server herzustellen, geben Sie mit diesem Argument einen Anmeldenamen an. Geben Sie außerdem ein Kennwort mithilfe des -sqlpassword-Arguments an.

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

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

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

Hinweise

Durch den Befehl nscontrol enable wird der Status der angegebenen Komponenten in "Aktivierung steht aus" geändert, indem ein Wert in einer Datenbank aktualisiert wird. Der Instanzstatus wird in der Instanzdatenbank gespeichert. Der Status einzelner Komponenten wird in der Anwendungsdatenbank gespeichert.

Wenn Sie nscontrol enable ausführen, sendet Notification Services die gewünschte Statusänderung als Broadcast an alle Komponenten. Nachdem alle aktiven Komponenten auf die Änderung reagiert haben, wird der Status von "Aktivierung steht aus" in "Aktiviert" geändert. Mit Ausnahme der Abonnenten- und Abonnementkomponenten muss das Modul (üblicherweise der Windows-Dienst NS$instance_name) aktiviert sein, damit der Komponentenstatus von "Aktivierung steht aus" in "Aktiviert" geändert werden kann. Für eine Statusänderung von "Aktivierung steht aus" in "Deaktiviert" oder von "Deaktivierung steht aus" in "Aktiviert" muss der Dienst nicht ausgeführt werden, da bei diesen Aktionen lediglich ein ausstehender Vorgang abgebrochen wird.

Nachdem die Datenbank durch nscontrol enable geändert wurde, wird der aktuelle Status der Instanz, der Anwendungen und der Komponenten angezeigt. Beschreibungen der Statuswerte finden Sie unter Anzeigen des Status von Instanzen, Anwendungen und Komponenten.

Wenn der Windows-Dienst NS$<instance_name> startet, bestimmt er seinen Ausführungsort (den Namen des Hosts) und vergleicht diesen Wert mit dem SystemName-Wert für jeden Verteiler, gehosteten Ereignisanbieter und Generator. Wenn der Hostname mit dem SystemName-Wert übereinstimmt, überprüft der Dienst den Komponentenstatus. Wenn die Komponente aktiviert ist, wird sie gestartet.

Während der Dienst ausgeführt wird, überprüft er die Datenbank alle 30 Sekunden, um den Status der gehosteten Ereignisanbieter, des Generators und der Verteiler zu bestimmen.

Der Abonnenten- und Abonnementstatus wird auf dem Datenbankserver zwischengespeichert und von den Abonnementverwaltungsobjekten überprüft, bevor sie Abonnement- oder Abonnentenvorgänge ausführen.

Berechtigungen

Das zum Ausführen von nscontrol enable verwendete Konto oder der durch das -sqlusername-Argument angegebene SQL Server-Anmeldename kann durch die Mitgliedschaft in der NSAdmin-Datenbankrolle entsprechende Berechtigungen in einzelnen Anwendungs- und Instanzdatenbanken erhalten. Mitglieder der db_owner-Datenbankrolle und der festen Serverrollen sysadmin und dbcreator können ebenfalls nscontrol enable ausführen.

Darüber hinaus muss das Konto über die Berechtigung zum Ausführen der Notification Services-Binärdateien verfügen. Diese Berechtigung wird Mitgliedern der Windows-Gruppen Administratoren und SQLServerNotificationServicesUser erteilt.

Beispiele

A. Aktivieren einer Notification Services-Instanz

Im folgenden Beispiel wird eine vollständige Notification Services-Instanz mit dem Namen StockInstance aktiviert. Die Instanz muss auf dem Computer registriert sein, auf dem Sie den folgenden Befehl ausführen.

nscontrol enable -name StockInstance

B. Aktivieren einer einzelnen Anwendung

Im folgenden Beispiel werden alle Komponenten der Anwendung Stock auf der Notification Services-Instanz StockInstance aktiviert. Der Befehl nscontrol verwendet die Windows-Authentifizierung, um eine Verbindung mit SQL Server herzustellen. Die Instanz muss auf dem Computer registriert sein, auf dem Sie den Befehl ausführen.

nscontrol enable -name StockInstance -application Stock

C. Aktivieren aller gehosteten Ereignisanbieter

Im folgenden Beispiel werden gehostete Ereignisanbieter für alle Anwendungen in der Notification Services-Instanz StockInstance aktiviert. Der Befehl nscontrol****verwendet die Windows-Authentifizierung, um eine Verbindung mit SQL Server herzustellen. Die Instanz muss auf dem Computer registriert sein, auf dem Sie den Befehl ausführen.

nscontrol enable -name StockInstance -events

D. Aktivieren einer Instanz von einem Verwaltungscomputer

Wenn Sie nscontrol enable auf einem Computer ausführen, auf dem StockInstance nicht registriert ist, müssen Sie den Namen der SQL Server-Instanz mithilfe des -server-Arguments angeben. Im folgenden Beispiel wird gezeigt, wie eine Instanz aktiviert wird, wenn sich die Datenbanken auf einer Instanz von SQL Server mit dem Namen nsuetest befinden. Der Befehl nscontrol verwendet die Windows-Authentifizierung, um eine Verbindung mit SQL Server herzustellen.

nscontrol enable -name StockInstance -server nsuetest

E. Verwenden der SQL Server-Authentifizierung, um eine Notification Services-Instanz zu aktivieren

In den folgenden Beispielen wird die Notification Services-Instanz StockInstance vollständig aktiviert, wobei die SQL Server-Authentifizierung für die Verbindung mit SQL Server verwendet wird. Die Instanz muss auf dem Computer registriert sein, auf dem Sie den folgenden Befehl ausführen.

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

Siehe auch

Verweis

nscontrol (Dienstprogramm)

Andere Ressourcen

Aktivieren und Deaktivieren von Instanzen, Anwendungen oder Komponenten

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version	Verlauf
05. Dezember 2005	Neuer Inhalt: Informationen zur Windows-Gruppe SQLServerNotificationServicesUser wurden hinzugefügt.