nscontrol create (Befehl)

Aktualisiert: 05. Dezember 2005

Erstellt eine neue Instanz von Microsoft SQL Server Notification Services.

Syntax

nscontrol create 
    [-nologo]
    [-help]
        -in configFile
    [-sqlusername sqlUserName  -sqlpassword sqlPassword]
    [-argumentkey key]
    [param=value ...]

Argumente

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

• -help
  Zeigt die Befehlssyntax an.

• -inconfigFile
  Gibt den Pfad und den Dateinamen der Instanzkonfigurationsdatei (Instance Configuration File, ICF) an, die die Instanz definiert. Wenn sich die Datei im aktuellen Verzeichnis befindet, ist der Pfad nicht erforderlich.

• -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 mit diesem Argument eine Anmelde-ID an. Dieses Argument muss zusammen mit dem Argument -sqlpassword verwendet werden.

  Wenn Sie die Windows-Authentifizierung verwenden, um eine Verbindung mit SQL Server herzustellen, sollten Sie die Argumente -sqlusername und -sqlpassword nicht verwenden.

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

• -sqlpasswordsqlPassword
  Gibt das Kennwort an, das zu der mit -sqlusername angegebenen Anmelde-ID gehört. Dieses Argument muss zusammen mit dem -sqlusername-Argument verwendet werden.

• -argumentkeykey
  Gibt den Schlüssel an, der zum Verschlüsseln von Übermittlungskanal- und Ereignisanbieterargumenten verwendet wird, die in Notification Services-Datenbanken gespeichert sind. Der Schlüssel ist eine Zeichenfolge, die bis zu 2500 Zeichen umfassen kann.

  Dieses Argument ist erforderlich, wenn EncryptArguments in der Konfigurationsdatei den Wert true hat. Sie können den von der Instanz verwendeten Schlüsselwert nicht ändern, nachdem Sie den Befehl nscontrol create ausgeführt haben. Um einen anderen Schlüssel zu verwenden, müssen Sie die Instanz löschen und anschließend neu erstellen.

  Wenn Sie den Befehl nscontrol register und den Befehl nscontrol update ausführen, müssen Sie ebenfalls denselben Schlüsselwert angeben. Mit dem Befehl nscontrol register wird der Schlüsselwert verschlüsselt und in der Registrierung gespeichert.

• param=value
  Ein Name/Wert-Paar, mit dem Parameterwerte von der Eingabeaufforderung aus an die ICF übergeben werden.

  Jede Zeichenfolge, die in der ICF zwischen Prozentzeichen (%) angezeigt wird, ist ein ersetzbarer Parameter. Wenn die ICF ersetzbare Parameter enthält (z. B. DBSystem im folgenden Beispiel), geben Sie den Parameternamen und -wert in der Befehlszeile (oder im ParameterDefaults-Abschnitt der ICF) an. Wenn die Konfigurationsdatei z. B. folgenden XML-Befehl enthält:

  <SqlServerSystem>%DBSystem%</SqlServerSystem>
  

  Anschließend können Sie den Namen und den Wert mithilfe von nscontrol create wie folgt angeben:

  nscontrol create -in config.xml DBSystem=MySQLServer
  

  Parameterwerte, die Sie an der Eingabeaufforderung angeben, gelten für Parameter in der ICF, jedoch nicht direkt für Parameter in den Anwendungsdefinitionsdateien (Application Definition Files, ADFs). Zum Übergeben von Parameterwerten an eine ADF müssen Sie dem Application-Abschnitt der ICF einen Parameters-Unterabschnitt hinzufügen. Sie können ersetzbare Parameter verwenden und an der Eingabeaufforderung Werte für diese Parameter angeben.

  Zusätzlich zur Angabe von Parametern an der Eingabeaufforderung können Sie in der ICF auch Umgebungsvariablen verwenden, wie z. B. %COMPUTERNAME%. Wenn Sie eine Umgebungsvariable in der ICF verwenden, müssen Sie beachten, dass ein Name/Wert-Paar, das an der Eingabeaufforderung angegeben wird, Vorrang vor der Umgebungsvariablen hat.

Hinweise

Der Befehl nscontrol create überprüft die ICF und die ADFs auf Grundlage ihrer XML-Schemas und im Hinblick auf ungültige Werte (z. B. ob der Wert true sowohl für die Multicastübermittlung als auch für die Digestübermittlung angegeben ist). Wenn bei den Überprüfungen ein Fehler gefunden wird, wird die Ausführung von nscontrol create beendet, ohne dass die Instanz erstellt wird.

Der Befehl nscontrol create aktiviert die datenbankübergreifende Besitzverkettung in der Instanz- und der Anwendungsdatenbank. Für diese Datenbanken ist die datenbankübergreifende Besitzverkettung erforderlich, damit gespeicherte Prozeduren von Notification Services auf Objekte in der Instanz- und der Anwendungsdatenbank zugreifen können.

Wenn Sie Notification Services Standard Edition verwenden und ein oder mehrere Elemente von dieser Edition nicht unterstützt werden, wird die Ausführung von nscontrol create beendet, ohne dass die Instanz erstellt wird. Weitere Informationen zu Notification Services Standard Edition finden Sie unter Editionen von Notification Services.

Sie können nscontrol create von jedem Computer ausführen, auf dem die Notification Services-Clientkomponenten installiert sind und der auf das SQL Server-Datenbankmodul zugreifen kann, das die Instanz- und Anwendungsmetadaten speichert.

Bevor Sie die Notification Services-Instanz ausführen können, müssen Sie die Instanz mithilfe von nscontrol register registrieren. Bei diesem Vorgang wird ein Eintrag in der Registrierung und optional ein Windows-Dienst erstellt, mit dem Sie die Instanz ausführen können.

Sie können nscontrol create nicht zum Aktualisieren einer Instanz verwenden. Verwenden Sie stattdessen nscontrol update.

Berechtigungen

Das Konto, mit dem Sie nscontrol create ausführen, oder der SQL Server-Anmeldename, den Sie im -sqlusername-Argument angeben, muss Mitglied der festen Serverrolle sysadmin sein. 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

In den folgenden Beispielen wird gezeigt, wie eine Instanz von Notification Services erstellt wird.

A. Ausgangsbeispiel

In diesem Beispiel wird gezeigt, wie mit der ICF InstanceConfig.xml eine neue Notification Services-Instanz erstellt und mithilfe der Windows-Authentifizierung eine Verbindung mit SQL Server hergestellt wird.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml"

B. Angeben von Werten für Konfigurationsdateiparameter

In diesem Beispiel wird gezeigt, wie Werte an die in der ICF enthaltenen Parameter BaseDirectoryPath, NSHost und SqlServer übergeben werden. Der Befehl nscontrol stellt mithilfe der Windows-Authentifizierung eine Verbindung mit SQL Server her.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    BaseDirectoryPath=C:\NS\Samples\Stock 
    NSHost=nsuetest SqlServer=nsuetest

C. Angeben eines Argumentverschlüsselungsschlüssels

In diesem Beispiel wird gezeigt, wie beim Erstellen der Instanz ein Argumentverschlüsselungsschlüssel angegeben wird. Beachten Sie, dass der Schüssel mit dem Schlüssel übereinstimmen muss, der beim Registrieren der Instanz verwendet wurde.

Der Befehl nscontrol stellt mithilfe der Windows-Authentifizierung eine Verbindung mit SQL Server her.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    -argumentkey "MyArgumentKey"

D. Verwenden der SQL Server-Authentifizierung

In diesem Beispiel wird gezeigt, wie eine neue Notification Services-Instanz erstellt wird, wobei die SQL Server-Authentifizierung für die Verbindung mit SQL Server verwendet wird.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

Siehe auch

Verweis

nscontrol (Dienstprogramm)

Andere Ressourcen

EncryptArguments Element (ICF)
Bereitstellen einer Notification Services-Instanz

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf