nscontrol disable (Befehl)

Aktualisiert: 05. Dezember 2005

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

Syntax

nscontrol disable 
    [-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>
  Stellt eine zu deaktivierende Komponente dar. Beim Ausführen von nscontrol disable können Sie keine oder auch mehrere Komponenten angeben.

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

  <component> kann jedes der folgenden Argumente sein:

  Argument	Beschreibung
  -distributor [systemName]	Deaktiviert die Verteilung für die Instanz oder Anwendung. Wenn Sie einen Verteilersystemnamen angeben, werden nur die Verteiler dieses Systems deaktiviert. Andernfalls werden alle Verteiler für die Instanz oder Anwendung deaktiviert.
  -events [systemName]	Deaktiviert die gehosteten Ereignisanbieter für die Instanz oder Anwendung. Wenn Sie einen Systemnamen angeben, werden nur die gehosteten Ereignisanbieter dieses Systems deaktiviert. Andernfalls werden alle gehosteten Ereignisanbieter für die Instanz oder Anwendung deaktiviert.
  -generator	Deaktiviert den Generator.
  -subscriptions	Deaktiviert die Abonnementverwaltung.
  -subscribers	Deaktiviert die Abonnementverwaltung für die Notification Services-Instanz.

• -nameinstanceName
  Gibt den Namen der Instanz an, auf die sich nscontrol disable auswirkt. Wenn Sie das -name-Argument angeben, ohne -application oder eine Komponente anzugeben, werden alle Instanzanwendungen und -komponenten durch nscontrol deaktiviert.

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

• -serverdatabaseServer
  Gibt den Namen des Servers an, der die Instanz- und die Anwendungsdatenbank 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 disable auf einem System ausführen, auf dem die Instanz zuvor mithilfe von 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 disable 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 Namen der Notification Services-Instanz als auch den Namen der SQL Server-Instanz 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
  Gibt den Namen der Anwendung an, in der Sie eine oder mehrere Komponenten deaktivieren. Wenn Sie keinen Anwendungsnamen angeben, werden die Komponenten aller von dieser Instanz gehosteten Anwendungen deaktiviert.

• -sqlusernamesqlUserName
  Gibt den SQL Server-Anmeldenamen an, 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 den Anmeldenamen mit diesem Argument an. Geben Sie außerdem ein Kennwort mithilfe des -sqlpassword-Arguments an.

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

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

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

Hinweise

Durch den Befehl nscontrol disable wird der Status der angegebenen Komponenten in "Deaktivierung 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 disable 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 "Deaktivierung steht aus" in "Deaktiviert" geändert. Mit Ausnahme der Abonnenten- und Abonnementkomponenten muss eine Instanz aktiviert sein, damit der Komponentenstatus von "Deaktivierung steht aus" in "Deaktiviert" 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 disable 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 ein Modul (normalerweise der Windows-Dienst NS$instance_name) startet, bestimmt es 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 auf dem Server ausgeführt. Wenn eine Komponente deaktiviert ist, wird sie nicht ausgeführt.

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. Wenn Sie eine Änderung am Status einer dieser Komponenten vornehmen, kann es daher bis zu 30 Sekunden dauern, bevor diese Änderung wirksam wird.

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

Berechtigungen

Das zum Ausführen von nscontrol disable verwendete Konto oder die durch das -sqlusername-Argument angegebene SQL Server-Anmeldekennung kann durch die Mitgliedschaft in der NSAdmin-Datenbankrolle in einzelnen Anwendungs- und Instanzdatenbanken die geeigneten Berechtigungen erhalten. Mitglieder der db_owner-Datenbankrolle und der festen Serverrollen sysadmin und dbcreator können ebenfalls nscontrol disable 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. Deaktivieren der vollständigen Notification Services-Instanz

Im folgenden Beispiel wird eine vollständige Notification Services-Instanz mit dem Namen StockInstance deaktiviert. 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 disable -name StockInstance

B. Deaktivieren einer einzelnen Anwendung

Im folgenden Beispiel werden alle Komponenten der Anwendung Stock deaktiviert, die von der Notification Services-Instanz StockInstance gehostet wird. 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 disable -name StockInstance -application Stock

C. Deaktivieren aller gehosteten Ereignisanbieter

Im folgenden Beispiel wird die gesamte Ereignisauflistung für alle Anwendungen in der Notification Services-Instanz StockInstance deaktiviert. 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 disable -name StockInstance -events

D. Deaktivieren einer Instanz von einem Verwaltungscomputer

Wenn Sie nscontrol disable von 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 deaktiviert wird, wenn sich die Datenbanken auf einer SQL Server-Instanz mit dem Namen nsuetest befinden. Der Befehl nscontrol verwendet die Windows-Authentifizierung, um eine Verbindung mit SQL Server herzustellen.

nscontrol disable -name StockInstance -server nsuetest

E. Deaktivieren einer Instanz mithilfe der SQL Server-Authentifizierung

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

Im folgenden Beispiel wird eine vollständige Notification Services-Instanz mit dem Namen StockInstance deaktiviert. Der Befehl nscontrol verwendet die SQL Server-Authentifizierung, um eine Verbindung mit SQL Server herzustellen. Die Instanz muss auf dem Computer registriert sein, auf dem Sie den Befehl ausführen.

nscontrol disable -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.