nscontrol upgrade (Befehl)

Aktualisiert: 05. Dezember 2005

Führt ein Update für Instanzen von Microsoft SQL Server Notification Services von einer früheren Version oder niedrigeren Edition auf die aktuelle Version und Edition aus.

Es ist nicht möglich, eine Notification Services-Instanz auf eine frühere Version oder niedrigere Edition herabzustufen.

Syntax

nscontrol upgrade
    [-nologo]
    [-help]
        –name instanceName
    [-server databaseServer]
    [-sqlusername sqlUserName -sqlpassword sqlPassword]
    [-timeout seconds]

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 aktualisierenden Instanz.

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

  Wenn Sie nscontrol upgrade 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 upgrade 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.

• -sqlusernamesqlUserName
  Gibt den von nscontrol verwendeten SQL Server-Anmeldenamen an, der zum Herstellen einer Verbindung mit SQL Server verwendet wird.

  Wichtig:
  Die Windows-Authentifizierung bietet eine höhere Sicherheit als die SQL Server-Authentifizierung. Verwenden Sie nach Möglichkeit immer die Windows-Authentifizierung.

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

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

• -sqlpasswordsqlPassword
  Gibt das Kennwort an, das zu der mit -sqlusername angegebenen Anmeldekennung gehört. Sie sollten dieses Argument nur verwenden, wenn Sie mithilfe der SQL Server-Authentifizierung eine Verbindung herstellen.

• -timeout seconds
  Gibt das Timeout (in Sekunden) für den Abschluss jeder einzelnen Aktualisierungsaktion an. Der Standardwert beträgt 30 Sekunden. Falls Sie beim Aktualisieren einer Notification Services-Instanz Timeoutfehler erhalten, legen Sie einen höheren Timeoutwert fest.

Hinweise

Wichtig:
Es empfiehlt sich, die Instanz- und die Anwendungsdatenbank zu sichern, bevor Sie das Update ausführen.

Wichtig:
Führen Sie nach dem Ausführen von nscontrol upgrade den Befehl nscontrol register aus, um die Registrierungsinformationen für diese Instanz zu aktualisieren.

Wenn Sie nscontrol upgrade ausführen, bestimmt die Version bzw. Edition von nscontrol die Version bzw. Edition des Updates. Wenn eine Instanz beispielsweise mit der Version 2.0.3008.0 von Notification Services erstellt wurde und Sie ein Update auf Version 9.0.242 ausführen möchten, müssen Sie nscontrol upgrade vom Ordner 9.0.242\bin ausführen, um das Update auszuführen.

Der Befehl nscontrol upgrade überprüft die Instanzdatenbank, um die Metadatenversion und -edition zu bestimmen. Wenn die Metadaten eine frühere Version oder niedrigere Edition angeben, überprüft nscontrol upgrade anschließend, ob die Instanz deaktiviert ist. Ist dies der Fall, führt nscontrol das Update aus.

Hinweis:
nscontrol upgrade legt den Datenbank-Kompatibilitätsmodus auf den Wert 90 fest.

Der Befehl nscontrol upgrade dient dazu, ein Update für eine Notification Services-Instanz am vorhandenen Ort auszuführen. Wenn Sie die Instanz während des Updates verschieben, müssen Sie die SystemName-Werte in der Anwendungsdefinitionsdatei (ADF) ändern und anschließend nscontrol update verwenden, um die Werte in den Datenbanken zu aktualisieren. Wenn die SystemName-Werte in den Datenbanken nicht mit den tatsächlichen Systemnamen übereinstimmen, werden die Komponenten nicht ausgeführt und Notification Services kann keine Benachrichtigungen verarbeiten. Weitere Informationen zum Verschieben von Instanzen finden Sie unter Verschieben von Notification Services-Instanzen.

Berechtigungen

Das zum Ausführen von nscontrol upgrade verwendete Konto oder der vom -sqlusername-Argument verwendete SQL Server-Anmeldename muss ein Mitglied der festen Datenbankrolle db_owner oder 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

Die folgenden Beispiele veranschaulichen die Aktualisierung einer Instanz in zwei verschiedenen Szenarien.

A. Aktualisieren einer Instanz mithilfe der Windows-Authentifizierung

In diesem Beispiel wird gezeigt, wie Sie ein Update für eine Notification Services-Instanz mit dem Namen StockInstance ausführen, wobei die Windows-Authentifizierung für die Verbindung mit SQL Server verwendet wird.

nscontrol upgrade -name StockInstance -server nsuetest

B. Aktualisieren einer Instanz mithilfe der SQL Server-Authentifizierung

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

In diesem Beispiel wird gezeigt, wie Sie ein Update für eine Notification Services-Instanz mit dem Namen StockInstance ausführen, wobei die SQL Server-Authentifizierung für die Verbindung mit SQL Server verwendet wird.

nscontrol upgrade -name StockInstance -server nsuetest
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

Siehe auch

Verweis

nscontrol (Dienstprogramm)

Andere Ressourcen

Migrieren von Notification Services-Instanzen

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf