nscontrol export (Befehl)

Aktualisiert: 05. Dezember 2005

Erstellt eine XML-Instanzkonfigurationsdatei (Instance Configuration File, ICF) und mindestens eine XML-Anwendungsdefinitionsdatei (Application Definition File, ADF) (eine Datei je Anwendung), indem die Metadaten aus den Datenbanken exportiert werden. Die sich daraus ergebenden Dateien sind gültige Definitionen der Instanz und der Anwendungen zu dem Zeitpunkt, an dem Sie den Exportbefehl ausführen. Sie können diese Informationen verwenden, um Ihre Instanz- und Anwendungsdefinitionen zu sichern oder um Dateien zu generieren, mit deren Hilfe Sie die Instanz erstellen oder aktualisieren können.

Syntax

nscontrol export 
    [-nologo]
    [-help] 
        -name instanceName
    [-server databaseServer]
    [-sqlusername sqlUserName -sqlpassword sqlPassword]
    [-out directory]
    [-force]

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 Instanz, auf deren Grundlage Konfigurations- und Anwendungsdefinitionsdateien erstellt werden.

• -serverdatabaseServer
  Der Name des Servers, der die Instanz- und Anwendungsdatenbanken hostet. Geben Sie dieses Argument nur an, wenn die Instanz nicht auf dem lokalen Computer registriert ist. Wenn die Instanz registriert wurde und Sie das -server-Argument trotzdem angeben, werden die Registrierungswerte für die Instanz ignoriert.

  Wenn Sie eine benannte Instanz von SQL Server zum Hosten der Instanzdatenbank verwenden, geben Sie den Server- und den Instanznamen im Format <servername>\<instancename> an.

• -sqlusernamesqlUserName
  Der SQL Server-Anmeldename, 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 daher nach Möglichkeit die Windows-Authentifizierung.

  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 die Argumente -sqlusername und -sqlpassword nicht an.

• -sqlpasswordsqlPassword
  Das Kennwort, das mit dem -sqlusername-Anmeldenamen verknüpft ist. Sie sollten dieses Argument nur verwenden, wenn Sie mithilfe der SQL Server-Authentifizierung eine Verbindung herstellen.

• -outdirectory
  Das Verzeichnis, in das die Dateien geschrieben werden sollen. Das Standardverzeichnis ist das aktuelle Verzeichnis.

• -force
  Gibt an, dass vorhandene Dateien desselben Namens im Ausgabeverzeichnis überschrieben werden.

Hinweise

Sie können den Befehl nscontrol export verwenden, während die Instanz ausgeführt wird. Sie müssen die Instanz nicht deaktivieren oder beenden.

Die sich daraus ergebende Konfigurationsdatei erhält den Namen <instance_name>.config.xml. Jede sich ergebende ADF erhält den Namen <instance_name>.<application_name>.adf.xml.

Der Befehl nscontrol export verwendet die UTF-8-Codierung beim Schreiben der Dateien. Wenn Sie die Konfigurations- und Anwendungsdefinitionsdateien exportieren und dabei andere Codierungen verwenden möchten, müssen Sie den Befehl Exportieren in SQL Server Management Studio verwenden.

Mit dem Befehl nscontrol export werden die ursprünglichen Konfigurations- und Anwendungsdefinitionsdateien nicht neu erstellt. Stattdessen werden Dateien erstellt, die die aktuellen Instanz- und Anwendungseinstellungen enthalten. Dies schließt Werte ein, die möglicherweise durch ersetzbare Parameter bereitgestellt wurden. Aus diesem Grund empfiehlt es sich, die ursprünglichen Konfigurations- und Anwendungsdefinitionsdateien beizubehalten und den Befehl nscontrol export zu verwenden, wenn Sie die aktuellen Instanz- und Anwendungseinstellungen bestimmen müssen.

Durch den Befehl nscontrol export werden die ApplicationDefinitionFilePath-Werte in der Konfigurationsdatei geändert, sodass sie anschließend auf die exportierten ADFs zeigen; dieser Pfad wird geändert, damit die Konfigurationsdatei sofort verwendet werden kann. Alle anderen Pfadeinstellungen, einschließlich BaseDirectoryPath, bleiben unverändert, da sie auf andere Dateien zeigen können, die von der Instanz benötigt werden, z. B. Inhaltsformatiererdateien.

Berechtigungen

Das zum Ausführen von nscontrol export verwendete Konto oder der durch das -sqlusername-Argument angegebene SQL Server-Anmeldename kann durch die Mitgliedschaft in der NSReader-Datenbankrolle Datenbankberechtigungen in einzelnen Anwendungs- und Instanzdatenbanken erhalten. Mitglieder der db_owner-Datenbankrolle und der festen Serverrollen sysadmin und dbcreator können ebenfalls nscontrol export 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

In den folgenden Beispielen wird das Exportieren von Metadaten in XML-Dateien veranschaulicht.

A. Exportieren von Dateien in das aktuelle Verzeichnis

In diesem Beispiel wird gezeigt, wie Instanz- und Anwendungsinformationen für die Instanz StockInstance exportiert werden. Das Dienstprogramm nscontrol verwendet die Windows-Authentifizierung für die Verbindung mit SQL Server und schreibt die Konfigurations- und Anwendungsdefinitionsdateien in das aktuelle Verzeichnis. Wenn die Dateien bereits vorhanden sind, zeigt nscontrol eine Fehlermeldung an.

nscontrol export -name StockInstance

B. Exportieren von Dateien in ein bestimmtes Verzeichnis, wobei vorhandene Dateien überschrieben werden

In diesem Beispiel wird gezeigt, wie ein Verzeichnis für die sich ergebenden Instanz- und Anwendungsdateien angegeben wird. Es wird weiterhin gezeigt, wie das -force-Argument verwendet wird, um vorhandene Dateien desselben Namens ggf. zu überschreiben.

Das Dienstprogramm nscontrol verwendet die Windows-Authentifizierung, um eine Verbindung mit SQL Server herzustellen.

nscontrol export -name StockInstance -out "C:\NS\Export" -force

C. Exportieren von Dateien von einem Administratorcomputer

In diesem Beispiel wird gezeigt, wie Instanz- und Anwendungsinformationen exportiert werden, wenn die Instanz nicht auf dem Computer registriert ist. Sie müssen den SQL Server-Instanznamen mit dem –server-Argument angeben. In diesem Beispiel wird darüber hinaus ein Ausgabeverzeichnis angegeben und festgelegt, dass vorhandene Dateien desselben Namens überschrieben werden.

Das Dienstprogramm nscontrol verwendet die Windows-Authentifizierung, um eine Verbindung mit SQL Server herzustellen.

nscontrol export -name StockInstance -server nsuetest 
    -out "C:\NS\Export" -force

D. Exportieren von Dateien mithilfe der SQL Server-Authentifizierung

In diesem Beispiel wird gezeigt, wie Instanzinformationen für die Instanz StockInstance exportiert werden, wobei die SQL Server-Authentifizierung für die Verbindung mit SQL Server verwendet wird. Die Konfigurations- und Anwendungsdefinitionsdateien werden im Verzeichnis C:\NS\Export erstellt; falls diese Dateien bereits vorhanden sind, werden sie jedoch nicht überschrieben.

nscontrol export -name StockInstance -out "C:\NS\Export" 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd 

Siehe auch

Verweis

nscontrol (Dienstprogramm)

Andere Ressourcen

Vorgehensweise: Anzeigen der Versionsinformationen für Notification Services

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.