dtexec (Hilfsprogramm)dtexec Utility

Die dtexec eingabeaufforderungs-Hilfsprogramm dient zum Konfigurieren und ausführen SQL ServerSQL Server Integration ServicesIntegration Services Pakete.The dtexec command prompt utility is used to configure and execute SQL ServerSQL Server Integration ServicesIntegration Services packages. Das Hilfsprogramm dtexec ermöglicht den Zugriff auf alle Funktionen der Paketkonfiguration und -ausführung, z. B. auf Parameter, Verbindungen, Eigenschaften, Variablen und Statusanzeigen.The dtexec utility provides access to all the package configuration and execution features, such as parameters, connections, properties, variables, logging, and progress indicators. Die dtexec -Dienstprogramm können Sie das Laden von Paketen aus diesen Quellen: die Integration ServicesIntegration Services Server, einer ispac-Projektdatei, einer MicrosoftMicrosoft SQL ServerSQL Server -Datenbank, die SSISSSIS Paket Store und dem Dateisystem.The dtexec utility lets you load packages from these sources: the Integration ServicesIntegration Services server, an .ispac project file, a MicrosoftMicrosoft SQL ServerSQL Server database, the SSISSSIS Package Store, and the file system.

Hinweis

Wenn Sie die in SQL Server 2012 Integration Services (SSIS)SQL Server 2012 Integration Services (SSIS) enthaltene Version des Hilfsprogramms dtexec verwenden, um ein SQL Server 2005 Integration Services (SSIS)SQL Server 2005 Integration Services (SSIS)- oder SQL Server 2008 Integration Services (SSIS)SQL Server 2008 Integration Services (SSIS)-Paket auszuführen, aktualisiert Integration ServicesIntegration Services das Paket vorübergehend auf SQL Server 2012 Integration Services (SSIS)SQL Server 2012 Integration Services (SSIS).When you use the version of the dtexec utility that comes with SQL Server 2012 Integration Services (SSIS)SQL Server 2012 Integration Services (SSIS) to run a SQL Server 2005 Integration Services (SSIS)SQL Server 2005 Integration Services (SSIS) or a SQL Server 2008 Integration Services (SSIS)SQL Server 2008 Integration Services (SSIS) package, Integration ServicesIntegration Services temporarily upgrades the package to SQL Server 2012 Integration Services (SSIS)SQL Server 2012 Integration Services (SSIS). Sie können das Hilfsprogramm dtexec jedoch nicht verwenden, um diese aktualisierten Änderungen zu speichern.However, you cannot use the dtexec utility to save these upgraded changes. Weitere Informationen zum dauerhaften Aktualisieren eines Pakets auf SQL Server 2012 Integration Services (SSIS)SQL Server 2012 Integration Services (SSIS), finden Sie unter Aktualisieren von Integration Services-Paketen.For more information about how to permanently upgrade a package to SQL Server 2012 Integration Services (SSIS)SQL Server 2012 Integration Services (SSIS), see Upgrade Integration Services Packages.

Dieses Thema enthält folgende Abschnitte:This topic includes the following sections:

Integration Services-Server und ProjektdateiIntegration Services Server and Project File

Bei Verwendung von dtexec zum Ausführen von Paketen auf dem Integration ServicesIntegration Services Server dtexec Aufrufe der Catalog. create_execution (SSISDB-Datenbank), catalog.set_execution_parameter_ Wert (SSISDB-Datenbank) und Catalog. start_execution (SSISDB-Datenbank) gespeicherte Prozeduren, die eine Ausführung zu erstellen, Parameterwerte festzulegen, und starten Sie die die Ausführung.When you use dtexec to run packages on the Integration ServicesIntegration Services server, dtexec calls the catalog.create_execution (SSISDB Database), catalog.set_execution_parameter_value (SSISDB Database) and catalog.start_execution (SSISDB Database) stored procedures to create an execution, set parameter values and start the execution. Alle Ausführungsprotokolle können in den verwandten Sichten vom Server oder über Standardberichte in SQL Server Management StudioSQL Server Management Studioangezeigt werden.All execution logs can be seen from the server in the related views or by using standard reports available in SQL Server Management StudioSQL Server Management Studio. Weitere Informationen zu den Berichten finden Sie unter Berichte für den Integration Services-Server.For more information about the reports, see Reports for the Integration Services Server.

Im Folgenden finden Sie ein Beispiel zum Ausführen eines Pakets auf dem Integration ServicesIntegration Services -Server.The following is an example of executing a package on the Integration ServicesIntegration Services server.

DTExec /ISSERVER "\SSISDB\folderB\Integration Services Project17\Package.dtsx" /SERVER "." /Envreference 2 /Par "$Project::ProjectParameter(Int32)";1 /Par "Parameter(Int32)";21 /Par "CM.sqlcldb2.SSIS_repro.InitialCatalog";ssisdb /Par "$ServerOption::SYNCHRONIZED(Boolean)";True  

Wenn Sie dtexec verwenden, um ein Paket von der ISPAC-Projektdatei auszuführen, lauten die entsprechenden Optionen: /Proj[ect] und /Pack[age], womit der Projektpfad und der Datenstromname des Pakets angegeben werden.When you use dtexec to run a package from the .ispac project file, the related options are: /Proj[ect] and /Pack[age] that are used to specify the project path and package stream name. Wenn Sie ein Projekt in das Projektbereitstellungsmodell konvertieren, indem Sie den Assistenten für die Konvertierung von Integration Services-Projekten von SQL Server Management StudioSQL Server Management Studioausführen, wird vom Assistenten eine ISPAC-Datei erstellt.When you convert a project to the project deployment model by running the Integration Services Project Conversion Wizard from SQL Server Management StudioSQL Server Management Studio, the wizard generates an .ispac projec file. Weitere Informationen finden Sie unter Deploy Projects to Integration Services Server.For more information, see Deploy Projects to Integration Services Server.

Sie können dtexec mit Drittanbieter-Planungstools um Pakete zu planen, die bereitgestellt werden, die Integration ServicesIntegration Services Server.You can use dtexec with third-party scheduling tools to schedule packages that are deployed to the Integration ServicesIntegration Services server.

Überlegungen zur Installation auf 64-Bit-ComputernInstallation Considerations on 64-bit Computers

Auf einem 64-Bit-Computer installiert Integration ServicesIntegration Services eine 64-Bit-Version des Hilfsprogramms dtexec (dtexec.exe).On a 64-bit computer, Integration ServicesIntegration Services installs a 64-bit version of the dtexec utility (dtexec.exe). Wenn Sie bestimmte Pakete im 32-Bit-Modus ausführen möchten, müssen Sie die 32-Bit-Version des dtexec-Hilfsprogramms installieren.If you have to run certain packages in 32-bit mode, you will have to install the 32-bit version of the dtexec utility. Wählen Sie zum Installieren der 32-Bit-Version des dtexec-Hilfsprogramms während des Setups entweder Clienttools oder SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT).To install the 32-bit version of the dtexec utility, you must select either Client Tools or SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) during setup.

Standardmäßig wird auf einem 64-Bit-Computer, auf dem sowohl die 64-Bit-Version als auch die 32-Bit-Version eines Integration ServicesIntegration Services -Befehlszeilen-Hilfsprogramms installiert ist, die 32-Bit-Version an der Eingabeaufforderung ausgeführt.By default, a 64-bit computer that has both the 64-bit and 32-bit versions of an Integration ServicesIntegration Services command prompt utility installed will run the 32-bit version at the command prompt. Die 32-Bit-Version wird ausgeführt, da der Verzeichnispfad für die 32-Bit-Version in der PATH-Umgebungsvariablen vor dem Verzeichnispfad für die 64-Bit-Version aufgeführt wird.The 32-bit version runs because the directory path for the 32-bit version appears in the PATH environment variable before the directory path for the 64-bit version. (Typischerweise ist der 32-Bit-Verzeichnispfad „ <Laufwerk> :\Programme (x86)\Microsoft SQL Server\110\DTS\Binn“, während der 64-Bit-Verzeichnispfad „ <Laufwerk> :\Programme\Microsoft SQL Server\110\DTS\Binn“ lautet.)(Typically, the 32-bit directory path is <drive>:\Program Files(x86)\Microsoft SQL Server\110\DTS\Binn, while the 64-bit directory path is <drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn.)

Hinweis

Wenn Sie das Hilfsprogramm mithilfe des SQL Server-Agents ausführen, verwendet dieser automatisch die 64-Bit-Version des Hilfsprogramms.If you use SQL Server Agent to run the utility, SQL Server Agent automatically uses the 64-bit version of the utility. Der SQL Server-Agent sucht die richtige ausführbare Datei für das Hilfsprogramm in der Registrierung und nicht in der PATH-Umgebungsvariablen.SQL Server Agent uses the registry, not the PATH environment variable, to locate the correct executable for the utility.

Wenn Sie sicherstellen möchten, dass die 64-Bit-Version des Hilfsprogramms an der Eingabeaufforderung ausgeführt wird, können Sie einen der folgenden Schritte ausführen:To ensure that you run the 64-bit version of the utility at the command prompt, you can take one of the following actions:

  • Öffnen Sie ein Eingabeaufforderungsfenster, wechseln Sie in das Verzeichnis mit der 64-Bit-Version des Hilfsprogramms („ <Laufwerk> :\Programme\Microsoft SQL Server\110\DTS\Binn“), und führen Sie dann das Hilfsprogramm aus diesem Verzeichnis aus.Open a Command Prompt window, change to the directory that contains the 64-bit version of the utility (<drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn), and then run the utility from that location.

  • Führen Sie an der Eingabeaufforderung das Hilfsprogramm aus, indem Sie den vollständigen Pfad („ <Laufwerk> :\Programme\Microsoft SQL Server\110\DTS\Binn“) der 64-Bit-Version des Hilfsprogramms eingeben.At the command prompt, run the utility by entering the full path (<drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn) to the 64-bit version of the utility.

  • Ändern Sie die Reihenfolge der Pfade in der PATH-Umgebungsvariablen dauerhaft, indem Sie den 64-Bit-Pfad („ <Laufwerk> :\Programme\Microsoft SQL Server\110\DTS\Binn“) in der Variable vor den 32-Bit-Pfad („ <Laufwerk> :\ Programme (x86)\Microsoft SQL Server\110\DTS\Binn“) platzieren.Permanently change the order of the paths in the PATH environment variable by placing the 64-bit path (<drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn) before the 32-bit path (<drive>:\ Program Files(x86)\Microsoft SQL Server\110\DTS\Binn) in the variable.

Überlegungen zu Computern mit parallelen InstallationenConsiderations on Computers with Side-by-Side Installations

Wenn SQL Server 2014 Integration Services (SSIS)SQL Server 2014 Integration Services (SSIS) auf einem Computer installiert wird, auf dem SQL Server 2005 Integration Services (SSIS)SQL Server 2005 Integration Services (SSIS) oder SQL Server 2008 Integration Services (SSIS)SQL Server 2008 Integration Services (SSIS) installiert ist, sind mehrere Versionen des Hilfsprogramms dtexec installiert.When SQL Server 2014 Integration Services (SSIS)SQL Server 2014 Integration Services (SSIS) is installed on a machine that has SQL Server 2005 Integration Services (SSIS)SQL Server 2005 Integration Services (SSIS) or SQL Server 2008 Integration Services (SSIS)SQL Server 2008 Integration Services (SSIS) installed, multiple versions of the dtexec utility are installed.

Führen Sie das Hilfsprogramm an der Eingabeaufforderung aus, indem Sie den vollständigen Pfad („ <Laufwerk> :\Programme\Microsoft SQL Server\<Version>\DTS\Binn“) eingeben, um sicherzustellen, dass Sie die korrekte Version des Hilfsprogramms ausführen.To ensure that you run the correct version of the utility, at the command prompt run the utility by entering the full path (<drive>:\Program Files\Microsoft SQL Server\<version>\DTS\Binn).

AusführungsphasenPhases of Execution

Bei der Ausführung des Hilfsprogramms werden vier Phasen durchlaufen.The utility has four phases that it proceeds through as it executes. Es handelt sich um die folgenden Phasen:The phases are as follows:

  1. Befehlsermittlungsphase: Die Eingabeaufforderung liest die Liste der Optionen und Argumente, die angegeben wurden.Command sourcing phase: The command prompt reads the list of options and arguments that have been specified. Alle weiteren Phasen werden übersprungen, wenn eine /? -All subsequent phases are skipped if a /? oder /HELP -Option festgestellt wird.or /HELP option is encountered.

  2. Paketladephase: Das angegebene Paket die /SQL, /FILE, oder /DTS Option geladen wird.Package load phase: The package specified by the /SQL, /FILE, or /DTS option is loaded.

  3. Konfigurationsphase: Optionen werden in der folgenden Reihenfolge verarbeitet:Configuration phase: Options are processed in this order:

    • Optionen, die Paketflags, -variablen und -eigenschaften festlegen.Options that set package flags, variables, and properties.

    • Optionen, die die Paketversion und den Paketbuild überprüfen.Options that verify the package version and build.

    • Optionen, die das Laufzeitverhalten des Hilfsprogramms konfigurieren, z. B. die Berichterstellung.Options that configure the run-time behavior of the utility, such as reporting.

  4. Überprüfungs- und Ausführungsphase: Das Paket wird ausgeführt bzw. ohne Ausführung überprüft, wenn die /VALIDATE-Option angegeben wurde.Validation and execution phase: The package is run, or validated without running if the /VALIDATE option was specified.

Zurückgegebene ExitcodesExit Codes Returned

Exitcodes, die vom dtexec-Hilfsprogramm zurückgegeben werdenExit codes returned from dtexec utility

Wenn ein Paket ausgeführt wird, kann dtexec einen Exitcode zurückgeben.When a package runs, dtexec can return an exit code. Der Exitcode wird dazu verwendet, die ERRORLEVEL-Variable aufzufüllen, deren Wert anschließend in bedingten Anweisungen oder in einer Verzweigungslogik innerhalb einer Batchdatei getestet werden kann.The exit code is used to populate the ERRORLEVEL variable, the value of which can then be tested in conditional statements or branching logic within a batch file. In der folgenden Tabelle sind die Werte aufgeführt, die das Hilfsprogramm dtexec beim Beenden festlegen kann.The following table lists the values that the dtexec utility can set when exiting.

WertValue DescriptionDescription
00 Das Paket wurde erfolgreich ausgeführt.The package executed successfully.
11 Bei der Paketausführung ist ein Fehler aufgetreten.The package failed.
33 Die Paketausführung wurde vom Benutzer abgebrochen.The package was canceled by the user.
44 Das Hilfsprogramm konnte das angeforderte Paket nicht finden.The utility was unable to locate the requested package. Das Paket konnte nicht gefunden werden.The package could not be found.
55 Das Hilfsprogramm konnte das angeforderte Paket nicht laden.The utility was unable to load the requested package. Das Paket konnte nicht geladen werden.The package could not be loaded.
66 Das Hilfsprogramm hat einen internen Fehler aufgrund syntaktischer oder semantischer Fehler in der Befehlszeile erkannt.The utility encountered an internal error of syntactic or semantic errors in the command line.

SyntaxregelnSyntax Rules

Syntaxregeln für das HilfsprogrammUtility syntax rules

Alle Optionen müssen mit einem Schrägstrich (/) oder einem Minuszeichen (-) beginnen.All options must start with a slash (/) or a minus sign (-). Die hier aufgeführten Optionen beginnen mit einem Schrägstrich (/); dieser kann jedoch durch ein Minuszeichen (-) ersetzt werden.The options that are shown here start with a slash (/), but the minus sign (-) can be substituted.

Enthält ein Argument ein Leerzeichen, muss es in Anführungszeichen eingeschlossen werden.An argument must be enclosed in quotation marks if it contains a space. Wenn das Argument nicht in Anführungszeichen eingeschlossen ist, darf es keine Leerzeichen enthalten.If the argument is not enclosed in quotation marks, the argument cannot contain white space.

Doppelte Anführungszeichen innerhalb von Zeichenfolgen, die selbst in Anführungszeichen eingeschlossen sind, stellen einzelne Anführungszeichen mit Escapezeichen dar.Doubled quotation marks within quoted strings represent escaped single quotation marks.

Bei Optionen und Argumenten wird die Groß- und Kleinschreibung nicht beachtet; ausgenommen hiervon sind Kennwörter.Options and arguments are not case-sensitive, except for passwords.

Aufrufen von dtexec mit xp_cmdshellUsing dtexec from the xp_cmdshell

Aufrufen von dtexec mit xp_cmdshellUsing dtexec from the xp_cmdshell

Sie können dtexec über die Eingabeaufforderung xp_cmdshell ausführen.You can run dtexec from the xp_cmdshell prompt. Das folgende Beispiel zeigt, wie das Paket namens UpsertData.dtsx ausgeführt und sein Rückgabecode ignoriert wird:The following example shows how to run a package called UpsertData.dtsx and ignore the return code:

EXEC xp_cmdshell 'dtexec /f "C:\UpsertData.dtsx"'  

Das folgende Beispiel zeigt, wie dasselbe Paket ausgeführt und sein Rückgabecode aufgezeichnet wird:The following example shows how to run the same package and capture the return code:

DECLARE @returncode int  
EXEC @returncode = xp_cmdshell 'dtexec /f "C:\UpsertData.dtsx"'  

Wichtig

In MicrosoftMicrosoftSQL ServerSQL Serverist die Option xp_cmdshell für neue Installationen standardmäßig deaktiviert.In MicrosoftMicrosoftSQL ServerSQL Server, the xp_cmdshell option is disabled by default on new installations. Die Option kann durch Ausführen der gespeicherten Systemprozedur sp_configure aktiviert werden.The option can be enabled by running the sp_configure system stored procedure. Weitere Informationen finden Sie unter xp_cmdshell (Serverkonfigurationsoption).For more information, see xp_cmdshell Server Configuration Option.

SyntaxSyntax

dtexec /option [value] [/option [value]]...  

ParameterParameters

  • /?/? [option_name]: Optional. Zeigt die Befehlszeilenoptionen oder die Hilfe zu der in Optionsname angegebenen Option an und beendet dann das Hilfsprogramm.Displays the command prompt options, or displays help for the specified option_name and then closes the utility.

    Bei Angabe einer Optionsname Argument dtexec startet SQL ServerSQL Server -Onlinedokumentation und zeigt Sie an das Thema für Dtexec-Hilfsprogramm.If you specify an option_name argument, dtexec starts SQL ServerSQL Server Books Online and displays the dtexec Utility topic.

  • /Ca[llerInfo] :/Ca[llerInfo]:
    Optional.Optional. Gibt weitere Informationen für eine Paketausführung an.Specifies additional information for a package execution. Wenn Sie mit dem SQL Server-Agent ein Paket ausführen, legt der Agent dieses Argument fest, um anzuzeigen, dass die Paketausführung vom SQL Server-Agent aufgerufen wird.When you run a package using SQL Server Agent, agent sets this argument to indicate that the package execution is invoked by SQL Server Agent. Dieser Parameter wird ignoriert, wenn das Hilfsprogramm dtexec in der Befehlszeile ausgeführt wird.This parameter is ignored when the dtexec utility is run from the command line.

  • /CheckF[ile] filespec:/CheckF[ile] filespec:
    Optional.Optional. Legt die CheckpointFileName -Eigenschaft des Pakets auf den Pfad und Dateinamen bzw. in Dateiangabe.Sets the CheckpointFileName property on the package to the path and file spemandcified in filespec. Diese Datei wird beim erneuten Starten des Pakets verwendet.This file is used when the package restarts. Wird diese Option angegeben, ohne einen Wert für den Dateinamen bereitzustellen, wird für die CheckpointFileName-Eigenschaft des Pakets eine leere Zeichenfolge festgelegt.If this option is specified and no value is supplied for the file name, the CheckpointFileName for the package is set to an empty string. Wenn diese Option nicht angegeben wird, werden die Werte im Paket beibehalten.If this option is not specified, the values in the package are retained.

  • / CheckP [Ointing] {On\off} :/CheckP[ointing] {on\off}:
    Optional.Optional. Legt einen Wert fest, der bestimmt, ob das Paket während der Paketausführung Prüfpunkte verwendet.Sets a value that determines whether the package will use checkpoints during package execution. Der Wert on gibt an, dass das fehlerhafte Paket erneut ausgeführt wird.The value on specifies that a failed package is to be rerun. Wenn das fehlerhafte Paket erneut ausgeführt wird, verwendet die Runtime-Engine die Prüfpunktdatei, um das Paket von dem Punkt an, an dem der Fehler aufgetreten ist, erneut auszuführen.When the failed package is rerun, the run-time engine uses the checkpoint file to restart the package from the point of failure.

    Der Standardwert ist "on", wenn die Option ohne Angabe eines Wertes deklariert wird.The default value is on if the option is declared without a value. Die Paketausführung erzeugt einen Fehler, wenn der Wert auf "on" festgelegt wurde und die Prüfpunktdatei nicht gefunden werden kann.Package execution will fail if the value is set to on and the checkpoint file cannot be found. Wenn diese Option nicht angegeben wird, wird der im Paket festgelegte Wert beibehalten.If this option is not specified, the value set in the package is retained. Weitere Informationen finden Sie unter Neustarten von Paketen mit Prüfpunkten.For more information, see Restart Packages by Using Checkpoints.

    Die /CheckPointing auf Option von Dtexec entspricht dem Festlegen der SaveCheckpoints -Eigenschaft des Pakets auf "true", und die CheckpointUsage Eigenschaft auf Always.The /CheckPointing on option of dtexec is equivalent to setting the SaveCheckpoints property of the package to True, and the CheckpointUsage property to Always.

  • /Com[mandFile] filespec:/Com[mandFile] filespec:
    (Optional).(Optional). Gibt die Befehlsoptionen an, die mit dtexec ausgeführt werden.Specifies the command options that run with dtexec. Die in Dateiangabe angegebene Datei wird geöffnet, und Optionen aus der Datei werden gelesen, bis EOF in der Datei gefunden wird.The file specified in filespec is opened and options from the file are read until EOF is found in the file. Dateiangabe ist eine Textdatei.filespec is a text file. Mit dem Dateiangabe -Argument werden der Dateiname und der Pfad der Befehlsdatei angegeben, die mit dem Ausführen des Pakets verknüpft werden soll.The filespec argument specifies the file name and path of the command file to associate with the execution of the package.

  • /Conf[igFile] filespec: Optional./Conf[igFile] filespec: Optional. Gibt eine Konfigurationsdatei an, aus der Werte extrahiert werden sollen.Specifies a configuration file to extract values from. Mithilfe dieser Option können Sie eine Laufzeitkonfiguration festlegen, die sich von der Konfiguration unterscheidet, die zur Entwurfszeit für das Paket angegeben wurde.Using this option, you can set a run-time configuration that differs from the configuration that was specified at design time for the package. Sie können abweichende Konfigurationseinstellungen in einer XML-Konfigurationsdatei speichern und die Einstellungen dann mithilfe der Option /ConfigFile vor der Paketausführung laden.You can store different configuration settings in an XML configuration file and then load the settings before package execution by using the /ConfigFile option.

    Sie können die Option /ConfigFile verwenden, um zur Laufzeit zusätzliche Konfigurationen zu laden, die Sie zur Entwurfszeit nicht angegeben haben.You can use the /ConfigFile option to load additional configurations at run time that you did not specify at design time. Sie können die Option /ConfigFile jedoch nicht verwenden, um konfigurierte Werte zu ersetzen, die Sie auch zur Entwurfszeit angegeben haben.However, you cannot use the /ConfigFile option to replace configured values that you also specified at design time. Weitere Informationen zur Anwendung von Paketkonfigurationen finden Sie unter Paketkonfigurationen.To understand how package configurations are applied, see Package Configurations.

  • /Conn[ection] id_or_name;connection_string [[;id_or_name;connection_string]...] :/Conn[ection] id_or_name;connection_string [[;id_or_name;connection_string]...]:
    Optional.Optional. Gibt an, dass sich der Verbindungs-Manager mit dem angegebenen Namen oder GUID im Paket befindet. Eine Verbindungszeichenfolge wird ebenfalls angegeben.Specifies that the connection manager with the specified name or GUID is located in the package, and specifies a connection string.

    Wenn diese Option verwendet wird, müssen beide Parameter angegeben werden: Der Name oder die GUID des Verbindungs-Managers muss mit dem ID_oder_Name-Argument bereitgestellt werden, und mit dem Verbindungszeichenfolge-Argument muss eine gültige Verbindungszeichenfolge angegeben werden.This option requires that both parameters be specified: the connection manager name or GUID must be provided in the id_or_name argument, and a valid connection string must be specified in the connection_string argument. Weitere Informationen finden Sie unter Integration Services-Verbindungen (SSIS).For more information, see Integration Services (SSIS) Connections.

    Sie können zur Laufzeit die Option /Connection verwenden, um Paketkonfigurationen von einem anderen Speicherort als dem zur Entwurfszeit angegebenen Speicherort zu laden.At run time, you can use the /Connection option to load package configurations from a location other than the location that you specified at design time. Die Werte dieser Konfigurationen ersetzen dann die Werte, die ursprünglich angegeben wurden.The values of these configurations then replace the values that were originally specified. Sie können die Option /Connection jedoch nur für Konfigurationen verwenden, die einen Verbindungs-Manager verwenden (z.B. SQL ServerSQL Server -Konfigurationen).However you can use the /Connection option only for configurations, such as SQL ServerSQL Server configurations, that use a connection manager. Um zu verstehen, wie Paketkonfigurationen angewendet werden, finden Sie unter Paketkonfigurationen und Verhaltensänderungen von Integration Services-Funktionen in SQL Server 2014.To understand how package configurations are applied, see Package Configurations and Behavior Changes to Integration Services Features in SQL Server 2014.

  • /Cons[oleLog] [[displayoptions];[list_options;src_name_or_guid]...]: Optional./Cons[oleLog] [[displayoptions];[list_options;src_name_or_guid]...]: Optional. Zeigt während der Paketausführung bestimmte Protokolleinträge an der Konsole an.Displays specified log entries to the console during package execution. Wenn die Option nicht angegeben wird, werden keine Protokolleinträge an der Konsole angezeigt.If this option is omitted, no log entries are shown in the console. Wenn die Option ohne Parameter zur Begrenzung der Anzeige angegeben wird, werden alle Protokolleinträge angezeigt.If the option is specified without parameters that limit the display, every log entry will display. Wenn Sie die an der Konsole angezeigten Einträge begrenzen möchten, können Sie die anzuzeigenden Spalten mithilfe des Anzeigeoptionen -Parameters angeben und die Protokolleintragstypen mithilfe des Listenoptionen -Parameters begrenzen.To limit the entries that are displayed to the console, you can specify the columns to show by using the displayoptions parameter, and limit the log entry types by using the list_options parameter.

    Hinweis

    Beim Ausführen eines Pakets auf die Integration ServicesIntegration Services Server mithilfe der /ISSERVER Parameter, die Konsolenausgabe begrenzt, und die meisten ist die /Cons [OleLog] -Optionen sind nicht anwendbar.When you run a package on the Integration ServicesIntegration Services server by using the /ISSERVER parameter, console output is limited and most of the /Cons[oleLog] options are not applicable. Alle Ausführungsprotokolle können in den verwandten Sichten vom Server oder über Standardberichte in SQL Server Management StudioSQL Server Management Studioangezeigt werden.All execution logs can be seen from the server in the related views or by using standard reports available in SQL Server Management StudioSQL Server Management Studio. Weitere Informationen zu den Berichten finden Sie unter Berichte für den Integration Services-Server.For more information about the reports, see Reports for the Integration Services Server.

    Die Anzeigeoptionen -Werte lauten wie folgt:The displayoptions values are as follows:

    • N (Name)N (Name)

    • C (Computer)C (Computer)

    • O (Operator)O (Operator)

    • S (Name der Quelle)S (Source Name)

    • G (GUID der Quelle)G (Source GUID)

    • X (Ausführungs-GUID)X (Execution GUID)

    • M (Meldung)M (Message)

    • T (Start- und Beendigungszeit)T (Time Start and End)

    Die Listenoptionen -Werte lauten wie folgt:The list_options values are as follows:

    • I – gibt die Inklusionsliste an.I - Specifies the inclusion list. Es werden nur Protokolleinträge für die angegebenen Quellnamen oder -GUIDs erfasst.Only the source names or GUIDs that are specified are logged.

    • E – gibt die Ausschlussliste an.E - Specifies the exclusion list. Für die angegebenen Quellnamen oder -GUIDs werden keine Protokolleinträge erfasst.The source names or GUIDs that are specified are not logged.

    • Bei dem Quellname_oder_-GUID -Parameter, der für die Inklusions- oder Ausschlussliste verwendet wird, handelt es sich um einen Ereignisnamen, den Namen einer Quelle oder die GUID einer Quelle.The src_name_or_guid parameter specified for inclusion or exclusion is an event name, source name, or source GUID.

    Wenn Sie die Option /ConsoleLog mehrmals in einer Befehlszeile verwenden, werden die einzelnen Optionen folgendermaßen verarbeitet:If you use multiple /ConsoleLog options on the same command prompt, they interact as follows:

    • Die Reihenfolge der Optionen spielt keine Rolle.Their order of appearance has no effect.

    • Wenn in der Befehlszeile keine Inklusionsliste angegeben wurde, gelten die Ausschlusslisten für alle Protokolleintragstypen.If no inclusion lists are present on the command line, exclusion lists are applied against all kinds of log entries.

    • Wenn in der Befehlszeile Inklusionslisten angegeben wurden, werden die Ausschlusslisten auf die Gesamtheit aller Inklusionslisten angewendet.If any inclusion lists are present on the command line, exclusion lists are applied against the union of all inclusion lists.

    Beispiele für die /ConsoleLog finden Sie unter den "Hinweise" Abschnitt.For examples of the /ConsoleLog option, see the Remarks section.

  • /D[ts] package_path:/D[ts] package_path:
    Optional.Optional. Lädt ein Paket aus dem SSIS-Paketspeicher.Loads a package from the SSIS Package Store. Pakete, die im SSIS-Paketspeicher gespeichert wurden, werden mithilfe des Legacy-Projektbereitstellungsmodells bereitgestellt.Packages that are stored in the SSIS Package Store, are deployed using the legacy package deployment model. Verwenden Sie die Option /ISServer, um Pakete auszuführen, die mithilfe des Projektbereitstellungsmodells auf dem Integration ServicesIntegration Services-Server bereitgestellt werden.To run packages that are deployed to the Integration ServicesIntegration Services server using the project deployment model, use the /ISServer option. Weitere Informationen zu Paket- und Projektbereitstellungsmodellen finden Sie unter Bereitstellung von Projekten und Paketen.For more information about the package and project deployment models, see Deployment of Projects and Packages.

    Mit dem Paketpfad -Argument wird der relative Pfad des SSISSSIS -Pakets, der am Stammverzeichnis des SSIS-Paketspeichers beginnt, sowie der Name des SSISSSIS -Pakets angegeben.The package_path argument specifies the relative path of the SSISSSIS package, starting at the root of the SSIS Package Store, and includes the name of the SSISSSIS package. Enthält der im Paketpfad -Argument angegebene Pfad- oder Dateiname ein Leerzeichen, müssen Sie das Paketpfad -Argument in Anführungszeichen setzen.If the path or file name specified in the package_path argument contains a space, you must put quotation marks around the package_path argument.

    Die /DTS-Option kann nicht zusammen mit der /File- oder der /SQL-Option verwendet werden.The /DTS option cannot be used together with the /File or /SQL option. Werden mehrere Optionen angegeben, erzeugt dtexec einen Fehler.If multiple options are specified, dtexec fails.

  • /De[crypt] password: Optional./De[crypt] password: Optional. Legt das Entschlüsselungskennwort fest, das beim Laden eines Pakets mit Kennwortverschlüsselung verwendet wird.Sets the decryption password that is used when you load a package with password encryption.

  • /Dump error code:/Dump error code:
    Optionale erstellt die debugdumpdateien mdmp und TMP, wenn ein oder mehrere angegebene Ereignisse auftreten, während der Ausführung des Pakets.Optional Creates the debug dump files, .mdmp and .tmp, when one or more specified events occur while the package is running. Das Argument Fehlercode gibt den Typ des Ereigniscodes (Fehler, Warnung oder Information) an, der auslöst, dass das System die Debugdumpdateien erstellt.The error code argument specifies the type of event code-error, warning, or information-that will trigger the system to create the debug dump files. Trennen Sie die Fehlercode -Argumente durch ein Semikolon (;), um mehrere Ereigniscodes anzugeben.To specify multiple event codes, separate each error code argument by a semi-colon (;). Schließen Sie keine Anführungszeichen in das Fehlercode -Argument ein.Do not include quotes with the error code argument.

    Im folgenden Beispiel werden die Debugdumpdateien generiert, wenn der DTS_E_CANNOTACQUIRECONNECTIONFROMCONNECTIONMANAGER-Fehler auftritt.The following example generates the debug dump files when the DTS_E_CANNOTACQUIRECONNECTIONFROMCONNECTIONMANAGER error occurs.

    /Dump 0xC020801C  
    

    Standardmäßig speichert Integration ServicesIntegration Services die Debugdumpdateien im Ordner „ <Laufwerk>:\Programme\Microsoft SQL Server\110\Shared\ErrorDumps“.By default, Integration ServicesIntegration Services stores the debug dump files in the folder, <drive>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps.

    Hinweis

    Debugdumpdateien können vertrauliche Informationen enthalten.Debug dump files may contain sensitive information. Verwenden Sie eine Zugriffssteuerungsliste, um den Zugriff auf die Dateien einzuschränken oder die Dateien in einen Ordner mit eingeschränktem Zugriff zu kopieren.Use an access control list (ACL) to restrict access to the files, or copy the files to a folder with restricted access. Bevor Sie Ihre Debugdateien beispielsweise an Microsoft Support Services senden, wird empfohlen, vertrauliche Informationen zu entfernen.For example, before you send your debug files to Microsoft support services, we recommended that you remove any sensitive or confidential information.

    Auf diese Option gilt für alle Pakete, die die dtexec Hilfsprogramm ausgeführt wird, Hinzufügen einer DumpOnCodes REG_SZ-Wert für den Registrierungsschlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath.To apply this option to all packages that the dtexec utility runs, add a DumpOnCodes REG_SZ value to the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath registry key. Der Datenwert in DumpOnCodes gibt den oder die Fehlercodes an, die auslösen, dass das System die Debugdumpdateien erstellt.The data value in DumpOnCodes specifies the error code or codes that will trigger the system to create debug dump files. Mehrere Fehlercodes müssen durch ein Semikolon (;) getrennt werden.Multiple error codes must be separated by a semi-colon (;).

    Wenn Sie dem Registrierungsschlüssel einen DumpOnCodes -Wert hinzufügen und die Option /Dump verwenden, erstellt das System Debugdumpdateien, die auf beiden Einstellungen basieren.If you add a DumpOnCodes value to the registry key, and use the /Dump option, the system will create debug dump files that are based on both settings.

    Weitere Informationen zum Debuggen von Dumpdateien finden Sie unter Generieren von Dumpdateien für die Paketausführung.For more information about debug dump files, see Generating Dump Files for Package Execution.

  • /DumpOnError:/DumpOnError:
    Optional.Optional. Erstellt die debugdumpdateien mdmp und TMP, wenn ein Fehler auftritt, während das Paket ausgeführt wird.Creates the debug dump files, .mdmp and .tmp, when any error occurs while the package is running.

    In der Standardeinstellung speichert Integration ServicesIntegration Services die Debugsicherungsdateien im Ordner „ <Laufwerk> :\Programme\Microsoft SQL Server\110\Shared\ErrorDumps“.By default, Integration ServicesIntegration Services stores the debug dump files in the folder, <drive>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps folder.

    Hinweis

    Debugdumpdateien können vertrauliche Informationen enthalten.Debug dump files may contain sensitive information. Verwenden Sie eine Zugriffssteuerungsliste, um den Zugriff auf die Dateien einzuschränken oder die Dateien in einen Ordner mit eingeschränktem Zugriff zu kopieren.Use an access control list (ACL) to restrict access to the files, or copy the files to a folder with restricted access. Bevor Sie Ihre Debugdateien beispielsweise an Microsoft Support Services senden, wird empfohlen, vertrauliche Informationen zu entfernen.For example, before you send your debug files to Microsoft support services, we recommended that you remove any sensitive or confidential information.

    Auf diese Option gilt für alle Pakete, die die dtexec Hilfsprogramm ausgeführt wird, Hinzufügen einer DumpOnError REG_DWORD-Wert für den Registrierungsschlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath.To apply this option to all packages that the dtexec utility runs, add a DumpOnError REG_DWORD value to the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath registry key. Der Wert des der DumpOnError REG_DWORD-Werts bestimmt, ob die /DumpOnError Option mit verwendet werden, muss die dtexec Hilfsprogramm:The value of the DumpOnError REG_DWORD value determines whether the /DumpOnError option needs to be used with the dtexec utility:

    • Ein Datenwert ungleich Null-gibt an, dass das System die debugdumpdateien erstellt, wenn ein Fehler auftritt, unabhängig davon, ob Sie verwenden, die /DumpOnError -Option mit der dtexec Hilfsprogramm.A non-zero data value indicates that the system will create debug dump files when any error occurs, regardless of whether you use the /DumpOnError option with the dtexec utility.

    • Datenwert 0 gibt an, dass das System nicht das Debuggen debugdumpdateien erstellt, es sei denn, Sie verwenden die /DumpOnError -Option mit der dtexec Hilfsprogramm.A zero data value indicates that the system will not create the debug dump files unless you use the /DumpOnError option with the dtexec utility.

    Weitere Informationen zum Debuggen von Dumpdateien finden Sie unter Generieren von Dumpdateien für die Paketausführung.For more information about debug dump files, see Generating Dump Files for Package Execution

  • /Env[Reference] Umgebung Verweis-ID:/Env[Reference] environment reference ID:
    Optional.Optional. Gibt die Umgebungsverweis-ID an, die von der Paketausführung verwendet wird, für ein Paket an, das auf dem Server mit Integration ServicesIntegration Services bereitgestellt ist.Specifies the environment reference (ID) that is used by the package execution, for a package that is deployed to the Integration ServicesIntegration Services server. Die Parameter, die konfiguriert wurden, um an Variablen gebunden zu sein, verwenden die Werte der Variablen, die in der Umgebung enthalten sind.The parameters configured to bind to variables will use the values of the variables that are contained in the environment.

    Sie können die Option /Env[Reference] zusammen mit den Optionen /ISServer und /Server verwenden.You use /Env[Reference] option together with the /ISServer and the /Server options.

    Dieser Parameter wird vom SQL Server-Agent verwendet.This parameter is used by SQL Server Agent.

  • /F[ile] filespec:/F[ile] filespec:
    Optional.Optional. Lädt ein im Dateisystem gespeichertes Paket.Loads a package that is saved in the file system. Pakete, die im Dateisystem gespeichert wurden, werden mithilfe des Legacy-Projektbereitstellungsmodells bereitgestellt.Packages that are saved in the file system, are deployed using the legacy package deployment model. Verwenden Sie die Option /ISServer, um Pakete auszuführen, die mithilfe des Projektbereitstellungsmodells auf dem Integration ServicesIntegration Services-Server bereitgestellt werden.To run packages that are deployed to the Integration ServicesIntegration Services server using the project deployment model, use the /ISServer option. Weitere Informationen zu Paket- und Projektbereitstellungsmodellen finden Sie unter Bereitstellung von Projekten und Paketen.For more information about the package and project deployment models, see Deployment of Projects and Packages

    Mit dem Dateiangabe -Argument werden Pfad und Dateiname des Pakets angegeben.The filespec argument specifies the path and file name of the package. Sie können den Pfad entweder als UNC-Pfad (Universal Naming Convention) oder als lokalen Pfad angeben.You can specify the path as either a Universal Naming Convention (UNC) path or a local path. Enthält der im Dateiangabe -Argument angegebene Pfad- oder Dateiname ein Leerzeichen, muss das Dateiangabe -Argument in Anführungszeichen gesetzt werden.If the path or file name specified in the filespec argument contains a space, you must put quotation marks around the filespec argument.

    Die /File-Option kann nicht zusammen mit der /DTS- oder der /SQL-Option verwendet werden.The /File option cannot be used together with the /DTS or /SQL option. Werden mehrere Optionen angegeben, erzeugt dtexec einen Fehler.If multiple options are specified, dtexec fails.

  • /H[elp] [option_name]: Optional./H[elp] [option_name]: Optional. Zeigt die Hilfe zu den Optionen oder die Hilfe zu der mit Optionsname angegebenen Option an und beendet das Hilfsprogramm.Displays help for the options, or displays help for the specified option_name and closes the utility.

    Bei Angabe einer Optionsname Argument dtexec startet SQL ServerSQL Server -Onlinedokumentation und zeigt Sie an das Thema für Dtexec-Hilfsprogramm.If you specify an option_name argument, dtexec starts SQL ServerSQL Server Books Online and displays the dtexec Utility topic.

  • /ISServer packagepath:/ISServer packagepath:
    Optional.Optional. Führt ein Paket aus, das auf dem Integration ServicesIntegration Services -Server bereitgestellt wurde.Runs a package that is deployed to the Integration ServicesIntegration Services server. Mit dem Paketpfad -Argument wird der vollständige Pfad- und Dateiname des Pakets angegeben, das auf dem Integration ServicesIntegration Services -Server bereitgestellt ist.The PackagePath argument specifies the full path and file name of the package deployed to the Integration ServicesIntegration Services server. Enthält der im Paketpfad -Argument angegebene Pfad- oder Dateiname ein Leerzeichen, müssen Sie das Paketpfad -Argument in Anführungszeichen setzen.If the path or file name specified in the PackagePath argument contains a space, you must put quotation marks around the PackagePath argument.

    Das Paketformat lautet wie folgt:The package format is as follows:

    \<catalog name>\<folder name>\<project name>\package file name  
    

    Sie können die Option /Server zusammen mit der Option /ISSERVER verwenden.You use /Server option together with the /ISSERVER option. Nur die Windows-Authentifizierung kann ein Paket auf dem SSIS-Server ausführen.Only Windows Authentication can execute a package on the SSIS Server. Der aktuelle Windows-Benutzer wird verwendet, um auf das Paket zuzugreifen.The current Windows user is used to access the package. Wird die Option „/Server“ nicht angegeben, wird die standardmäßige lokale Instanz von SQL ServerSQL Server verwendet.If the /Server option is omitted, the default local instance of SQL ServerSQL Server is assumed.

    Die /ISSERVER-Option kann nicht zusammen mit der /DTS-, /SQL- oder /File-Option verwendet werden.The /ISSERVER option cannot be used together with the /DTS, /SQL or /File option. Wenn mehrere Optionen angegeben werden, misslingt die Ausführung von dtexec.If multiple options are specified, dtexec fails.

    Dieser Parameter wird vom SQL Server-Agent verwendet.This parameter is used by SQL Server Agent.

  • /L[ogger] classid_orprogid;configstring:/L[ogger] classid_orprogid;configstring:
    Optional.Optional. Ordnet das Ausführen eines SSISSSIS -Pakets einem oder mehreren Protokollanbietern zu.Associates one or more log providers with the execution of an SSISSSIS package. Mit dem Klassen-ID_oder_Programm-ID -Parameter wird der Protokollanbieter angegeben; diese Angabe kann in Form einer Klassen-GUID erfolgen.The classid_orprogid parameter specifies the log provider, and can be specified as a class GUID. Die Konfigurationszeichenfolge ist die Zeichenfolge, die zum Konfigurieren des Protokollanbieters verwendet wird.The configstring is the string that is used to configure the log provider.

    In der folgenden Liste sind die verfügbaren Protokollanbieter aufgeführt:The following list shows the available log providers:

    • Textdatei:Text file:

      • ProgID: DTS.LogProviderTextFile.1ProgID: DTS.LogProviderTextFile.1

      • ClassID: {59B2C6A5-663F-4C20-8863-C83F9B72E2EB}ClassID: {59B2C6A5-663F-4C20-8863-C83F9B72E2EB}

    • SQL Server ProfilerSQL Server Profiler::

      • ProgID: DTS.LogProviderSQLProfiler.1ProgID: DTS.LogProviderSQLProfiler.1

      • ClassID: {5C0B8D21-E9AA-462E-BA34-30FF5F7A42A1}ClassID: {5C0B8D21-E9AA-462E-BA34-30FF5F7A42A1}

    • SQL ServerSQL Server::

      • ProgID: DTS.LogProviderSQLServer.1ProgID: DTS.LogProviderSQLServer.1

      • ClassID: {6AA833A1-E4B2-4431-831B-DE695049DC61}ClassID: {6AA833A1-E4B2-4431-831B-DE695049DC61}

    • Windows-Ereignisprotokoll:Windows Event Log:

      • ProgID: DTS.LogProviderEventLog.1ProgID: DTS.LogProviderEventLog.1

      • ClassID: {97634F75-1DC7-4F1F-8A4C-DAF0E13AAA22}ClassID: {97634F75-1DC7-4F1F-8A4C-DAF0E13AAA22}

    • XML-Datei:XML File:

      • ProgID: DTS.LogProviderXMLFile.1ProgID: DTS.LogProviderXMLFile.1

      • ClassID: {AFED6884-619C-484F-9A09-F42D56E1A7EA}ClassID: {AFED6884-619C-484F-9A09-F42D56E1A7EA}

  • /M[axConcurrent] concurrent_executables:/M[axConcurrent] concurrent_executables:
    Optional.Optional. Gibt die Anzahl von ausführbaren Dateien an, die das Paket gleichzeitig ausführen kann.Specifies the number of executable files that the package can run concurrently. Der angegebene Wert muss entweder eine nicht negative ganze Zahl oder -1 sein.The value specified must be either a non-negative integer, or -1. Ein Wert von „-1“ bedeutet, dass SSISSSIS eine maximale Anzahl gleichzeitig aktiver ausführbarer Dateien zulässt, die der Gesamtanzahl von Prozessoren plus zwei des Computers entspricht, auf dem das Paket ausgeführt wird.A value of -1 means that SSISSSIS will allow a maximum number of concurrently running executables that is equal to the total number of processors on the computer executing the package, plus two.

  • /Pack[age] PackageName:/Pack[age] PackageName:
    Optional.Optional. Gibt das Paket an, das ausgeführt wird.Specifies the package that is executed. Dieser Parameter wird hauptsächlich verwendet, wenn Sie das Paket von Visual StudioVisual Studioausführen.This parameter is used primarily when you execute the package from Visual StudioVisual Studio.

  • /P[assword] password:/P[assword] password:
    Optional.Optional. Ermöglicht das Abrufen eines Pakets, das durch die SQL ServerSQL Server -Authentifizierung geschützt ist.Allows the retrieval of a package that is protected by SQL ServerSQL Server Authentication. Diese Option wird zusammen mit der Option /User verwendet.This option is used together with the /User option. Wird die Option /Password nicht angegeben und die Option /User verwendet, wird ein leeres Kennwort verwendet.If the /Password option is omitted and the /User option is used, a blank password is used. Der Wert Kennwort kann in Anführungszeichen eingeschlossen werden.The password value may be quoted.

    Wichtig

    Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.When possible, use Windows authentication.

  • /Par[ameter] [$Package:: | $Project:: | $ServerOption::] parameter_name [(data_type)]; literal_value: Optional./Par[ameter] [$Package:: | $Project:: | $ServerOption::] parameter_name [(data_type)]; literal_value: Optional. Gibt Parameterwerte an.Specifies parameter values. Es können mehrere /Parameter -Optionen angegeben werden.Multiple /Parameter options can be specified. Die Datentypen sind CLR TypeCodes als Zeichenfolgen.The data types are CLR TypeCodes as strings. Für einen Nicht-Zeichenfolge-Parameter wird der Datentyp in Klammern angegeben und folgt dem Parameternamen.For a non-string parameter, the data type is specified in parenthesis, following the parameter name.

    Die /Parameter Option kann verwendet werden, nur mit der /ISServer Option.The /Parameter option can be used only with the /ISServer option.

    Sie verwenden die Präfixe "$Package", "$Project" und "$ServerOption", um einen Paket-, Projekt- oder Serveroptionsparameter anzugeben.You use the $Package, $Project, and $ServerOption prefixes to indicate a package parameter, project parameter, and a server option parameter, respectively. Der standardmäßige Parametertyp ist "Paket".The default parameter type is package.

    Im Folgenden finden Sie ein Beispiel zum Ausführen eines Pakets und Bereitstellen von "myvalue" für den Projektparameter (myparam) und eines ganzzahligen Werts "12" für den Projektparameter (anotherparam).The following is an example of executing a package and providing myvalue for the project parameter (myparam) and the integer value 12 for the package parameter (anotherparam).

    Dtexec /isserver "SSISDB\MyFolder\MyProject\MyPackage.dtsx" /server "." /parameter $Project::myparam;myvalue /parameter anotherparam(int32);12

    Eigenschaften des Verbindungs-Managers können auch mithilfe von Parametern festgelegt werden.You can also set connection manager properties by using parameters. Sie verwenden das Präfix "CM", um einen Parameter des Verbindungs-Managers zu kennzeichnen.You use the CM prefix to denote a connection manager parameter.

    Im folgenden Beispiel wird die InitialCatalog-Eigenschaft des SourceServer-Verbindungs-Managers auf ssisdbfestgelegt.In the following example, InitialCatalog property of the SourceServer connection manager is set to ssisdb.

    /parameter CM.SourceServer.InitialCatalog;ssisdb  
    

    Im folgenden Beispiel wird die ServerName-Eigenschaft des SourceServer-Verbindungs-Managers auf einen Punkt (.) festgelegt, um den lokalen Server anzugeben.In the following example, ServerName property of the SourceServer connection manager is set to a period (.) to indicate the local server.

    /parameter CM.SourceServer.ServerName;.  
    
  • /Proj[ect] ProjectFile:/Proj[ect] ProjectFile:
    Optional.Optional. Gibt das Projekt an, von dem das ausgeführte Paket abgerufen wird.Specifies the project from which to retrieve the package that is executed. Das Projektdatei -Argument gibt den ISPAC-Dateinamen an.The ProjectFile argument specifies the .ispac file name. Dieser Parameter wird hauptsächlich verwendet, wenn Sie das Paket von Visual StudioVisual Studioausführen.This parameter is used primarily when you execute the package from Visual StudioVisual Studio.

  • /Rem comment:/Rem comment:
    Optional.Optional. Schließt einen Kommentar in die Befehlszeile oder in Befehlsdateien ein.Includes comments on the command prompt or in command files. Das Argument ist optional.The argument is optional. Der Wert für Kommentar ist eine Zeichenfolge, die entweder in Anführungszeichen eingeschlossen werden muss oder keine Leerzeichen enthalten darf.The value of comment is a string that must be enclosed in quotation marks, or contain no white space. Wird kein Argument angegeben, wird eine leere Zeile eingefügt.If no argument is specified, a blank line is inserted. Während der Befehlsermittlungsphase werdenKommentar -Werte nicht berücksichtigt.comment values are discarded during the command sourcing phase.

  • /Rep[orting] level [ ;event_guid_or_name[ ;event_guid_or_name[...]]: Optional./Rep[orting] level [;event_guid_or_name[;event_guid_or_name[...]]: Optional. Gibt an, welche Meldungstypen gemeldet werden sollen.Specifies what types of messages to report. Für Ebene stehen folgende Berichtsoptionen zur Verfügung:The available reporting options for level are as follows:

    N Keine Berichterstellung.N No reporting.

    E Fehler werden gemeldet.E Errors are reported.

    W Warnungen werden gemeldet.W Warnings are reported.

    I Informationsmeldungen werden gemeldet.I Informational messages are reported.

    C Benutzerdefinierte Ereignisse werden gemeldet.C Custom events are reported.

    D Datenfluss-Taskereignisse werden gemeldet.D Data Flow task events are reported.

    P Der Status wird gemeldet.P Progress is reported.

    V Ausführliche Berichterstellung.V Verbose reporting.

    Die Argumente V und N schließen sich gegenseitig und alle anderen Argumente aus; sie müssen allein angegeben werden.The arguments of V and N are mutually exclusive to all other arguments; they must be specified alone. Wenn die /Reporting Option ist nicht angegeben, und klicken Sie dann die Standardebene ist E (Fehler), W (Warnungen) und P (Status).If the /Reporting option is not specified then the default level is E (errors), W (warnings), and P (progress).

    Vor allen Ereignissen wird ein Zeitstempel im Format "DD.MM.YY HH:MM:SS" sowie ggf. ein GUID oder ein Anzeigename aufgeführt.All events are preceded with a timestamp in the format "YY/MM/DD HH:MM:SS", and a GUID or friendly name if available.

    Der optionale Ereignis-GUID_ oder_-name -Parameter ist eine Ausnahmeliste für die Protokollanbieter.The optional parameter event_guid_or_name is a list of exceptions to the log providers. Die Ausnahmeliste gibt die normalerweise protokollierten Ereignisse an, die nicht protokolliert werden.The exception specifies the events that are not logged that otherwise might have been logged.

    Sie müssen ein Ereignis nur ausschließen, wenn dieses standardmäßig protokolliert wird.You do not have to exclude an event if the event is not ordinarily logged by default

  • /Res[tart] {deny | force | ifPossible}: Optional./Res[tart] {deny | force | ifPossible}: Optional. Gibt einen neuen Wert für die CheckpointUsage -Eigenschaft des Pakets an.Specifies a new value for the CheckpointUsage property on the package. Die Parameter haben folgende Bedeutung:The meaning of the parameters are as follows:

    Deny legt die CheckpointUsage -Eigenschaft auf DTSCU_NEVER.Deny Sets CheckpointUsage property to DTSCU_NEVER.

    Force legt die CheckpointUsage -Eigenschaft auf DTSCU_ALWAYS.Force Sets CheckpointUsage property to DTSCU_ALWAYS.

    ifPossible legt die CheckpointUsage -Eigenschaft auf DTSCU_IFEXISTS.ifPossible Sets CheckpointUsage property to DTSCU_IFEXISTS.

    Der Standardwert force wird verwendet, wenn kein Wert angegeben wird.The default value of force is used if no value is specified.

  • /Set [$Sensitive::]propertyPath;value: Optional./Set [$Sensitive::]propertyPath;value: Optional. Überschreibt die Konfiguration eines Parameters, einer Variablen, einer Eigenschaft, eines Containers, eines Protokollanbieters, eines Foreach-Enumerators oder einer Verbindung innerhalb eines Pakets.Overrides the configuration of a parameter, variable, property, container, log provider, Foreach enumerator, or connection within a package. Wenn diese Option verwendet wird, ändert /Set das Eigenschaftspfad -Argument in den angegebenen Wert.When this option is used, /Set changes the propertyPath argument to the value specified. Es können mehrere /Set -Optionen angegeben werden.Multiple /Set options can be specified.

    Zusätzlich zur Verwendung der /Set -Option mit der /f [Ile] auswählen, können Sie auch die /Set -Option mit der /ISServer Option oder die /Project Option.In addition to using the /Set option with the /F[ile] option, you can also use the /Set option with the /ISServer option or the /Project option. Bei Verwendung von /Set mit /Project, /Set legt die Parameterwerte fest.When you use /Set with /Project, /Set sets parameter values. Bei Verwendung von /Set mit /ISServer, /Set legt die eigenschaftenüberschreibungen fest.When you use /Set with /ISServer, /Set sets property overrides. Wenn Sie darüber hinaus verwenden /Set mit /ISServer, Sie können die optionale $Sensitive-Präfix verwenden, um anzugeben, dass auf die Eigenschaft als vertraulich behandelt werden soll die Integration ServicesIntegration Services Server.In addition, when you use /Set with /ISServer, you can use the optional $Sensitive prefix to indicate that the property should be treated as sensitive on the Integration ServicesIntegration Services server.

    Der Wert des Eigenschaftspfads kann mithilfe des Paketkonfigurations-Assistenten bestimmt werden.You can determine the value of propertyPath by running the Package Configuration Wizard. Die Pfade für die von Ihnen ausgewählten Elemente werden auf der letzten Seite des Assistenten, Assistenten abschließen , angezeigt und können von dort kopiert werden.The paths for items that you select are displayed on the final Completing the Wizard page, and can be copied and pasted. Wenn Sie den Assistenten nur für diesen Zweck verwendet haben, können Sie ihn nach dem Kopieren der Pfade abbrechen.If you have used the wizard only for this purpose, you can cancel the wizard after you copy the paths.

    Das folgende Beispiel zeigt, wie ein im Dateisystem gespeichertes Paket ausgeführt und ein neuer Wert für eine Variable angegeben wird:The following is an example of executing a package that is saved in the file system and providing a new value for a variable:

    dtexec /f mypackage.dtsx /set \package.variables[myvariable].Value;myvalue

    Im folgenden Beispiel wird das Ausführen eines Pakets von einer ISPAC-Projektdatei sowie das Festlegen des Pakets und der Projektparameter gezeigt.The following example of running a package from the .ispac project file and setting package and project parameters.

    /Project c:\project.ispac /Package Package1.dtsx /SET \Package.Variables[$Package::Parameter];1 /SET \Package.Variables[$Project::Parameter];1

    Sie können die Option /Set verwenden, um den Speicherort zu ändern, von dem Paketkonfigurationen geladen werden.You can use the /Set option to change the location from which package configurations are loaded. Sie können die Option /Set jedoch nicht verwenden, um einen Wert zu überschreiben, der zur Entwurfszeit von einer Konfiguration angegeben wurde.However, you cannot use the /Set option to override a value that was specified by a configuration at design time. Um zu verstehen, wie Paketkonfigurationen angewendet werden, finden Sie unter Paketkonfigurationen und Verhaltensänderungen von Integration Services-Funktionen in SQL Server 2014.To understand how package configurations are applied, see Package Configurations and Behavior Changes to Integration Services Features in SQL Server 2014.

  • /Ser[ver] server:/Ser[ver] server:
    Optional.Optional. Wenn die Option /SQL oder /DTS verwendet wurde, gibt diese Option den Namen des Servers an, von dem das Paket abgerufen werden soll.When the /SQL or /DTS option is specified, this option specifies the name of the server from which to retrieve the package. Wenn Sie die Option /Server nicht angeben, die Option /SQL oder /DTS jedoch angegeben wird, wird versucht, das Paket von dem lokalen Server auszuführen.If you omit the /Server option and the /SQL or /DTS option is specified, package execution is tried against the local server. Der Serverinstanz -Wert kann in Anführungszeichen eingeschlossen werden.The server_instance value may be quoted.

    Die Option /Ser[ver] ist erforderlich, wenn die Option /ISServer angegeben wird.The /Ser[ver] option is required when the /ISServer option is specified.

  • /SQ[L] package_path:/SQ[L] package_path:
    Lädt ein in SQL ServerSQL Server gespeichertes Paket in die msdb-Datenbank.Loads a package that is stored in SQL ServerSQL Server, in msdb database. Pakete, die in der msdb-Datenbank gespeichert sind, werden mithilfe des Projektbereitstellungsmodells bereitgestellt.Packages that are stored in the msdb database, are deployed using the package deployment model. Verwenden Sie die Option /ISServer, um Pakete auszuführen, die mithilfe des Projektbereitstellungsmodells auf dem Integration ServicesIntegration Services-Server bereitgestellt werden.To run packages that are deployed to the Integration ServicesIntegration Services server using the project deployment model, use the /ISServer option. Weitere Informationen zu Paket- und Projektbereitstellungsmodellen finden Sie unter Bereitstellung von Projekten und Paketen.For more information about the package and project deployment models, see Deployment of Projects and Packages.

    Mit dem Paketpfad -Argument wird der Name des abzurufenden Pakets angegeben.The package_path argument specifies the name of the package to retrieve. Werden Ordner in die Pfadangabe eingeschlossen, werden sie mit umgekehrten Schrägstrichen („\“) abgeschlossen.If folders are included in the path, they are terminated with backslashes ("\"). Der Paketpfad -Wert kann in Anführungszeichen eingeschlossen werden.The package_path value can be quoted. Enthält der im Paketpfad -Argument angegebene Pfad- oder Dateiname ein Leerzeichen, müssen Sie das Paketpfad -Argument in Anführungszeichen setzen.If the path or file name specified in the package_path argument contains a space, you must put quotation marks around the package_path argument.

    Können Sie die /User, /Password, und /Server Optionen zusammen mit den /SQL Option.You can use the /User, /Password, and /Server options together with the /SQL option.

    Wenn Sie die Option /User nicht angeben, wird die Windows-Authentifizierung für den Zugriff auf das Paket verwendet.If you omit the /User option, Windows Authentication is used to access the package. Wenn Sie die Option /User verwenden, wird der mit /User angegebene Anmeldename der SQL ServerSQL Server -Authentifizierung zugeordnet.If you use the /User option, the /User login name specified is associated with SQL ServerSQL Server Authentication.

    Die Option /Password wird nur zusammen mit der /User -Option verwendet.The /Password option is used only together with the /User option. Wenn Sie die Option /Password verwenden, erfolgt der Zugriff auf das Paket mit den angegebenen Benutzernamen- und Kennwortinformationen.If you use the /Password option, the package is accessed with the user name and password information provided. Wird die Option /Password nicht angegeben, wird ein leeres Kennwort verwendet.If you omit the /Password option, a blank password is used.

    Wichtig

    Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.When possible, use Windows authentication.

    Wird die Option /Server nicht angegeben, wird die standardmäßige lokale Instanz von SQL ServerSQL Server verwendet.If the /Server option is omitted, the default local instance of SQL ServerSQL Server is assumed.

    Die /SQL-Option kann nicht zusammen mit der /DTS- oder der /File-Option verwendet werden.The /SQL option cannot be used together with the /DTS or /File option. Werden mehrere Optionen angegeben, erzeugt dtexec einen Fehler.If multiple options are specified, dtexec fails.

  • /Su[m] : Optional./Su[m]: Optional. Zeigt einen inkrementellen Zähler an, der die Anzahl der Zeilen enthält, die von der nächsten Komponente empfangen werden.Shows an incremental counter that contains the number of rows that will be received by the next component.

  • /U[ser] user_name:/U[ser] user_name:
    Optional.Optional. Ermöglicht das Abrufen eines Pakets, das durch die SQL ServerSQL Server -Authentifizierung geschützt ist.Allows the retrieval of a package that is protected by SQL ServerSQL Server Authentication. Diese Option wird nur verwendet, wenn die Option /SQL angegeben wird.This option is used only when the /SQL option is specified. Der Benutzername -Wert kann in Anführungszeichen eingeschlossen werden.The user_name value can be quoted.

    Wichtig

    Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.When possible, use Windows authentication.

  • /Va[lidate] :/Va[lidate]:
    Optional.Optional. Beendet das Ausführen des Pakets nach der Überprüfungsphase, ohne das Paket tatsächlich auszuführen.Stops the execution of the package after the validatation phase, without actually running the package. Während der Überprüfung zu verwenden, der die /warnaserror bewirkt dtexec eine Warnung wie einen Fehler behandelt daher ein Paketfehler auftritt, wenn während des Überprüfens eine Warnung auftritt.During validation, use of the /WarnAsError option causes dtexec to treat a warning as an error; therefore the package fails if a warning occurs during validation.

  • /VerifyB[uild] major[ ;minor[ ;build]]: Optional./VerifyB[uild] major[;minor[;build]]: Optional. Überprüft die Buildnummer eines Pakets anhand der Buildnummern, die während der Überprüfungsphase mit den Argumenten Hauptversion, Nebenversionund Build angegeben wurden.Verifies the build number of a package against the build numbers that were specified during the verification phase in the major, minor, and build arguments. Stimmen die Buildnummern nicht überein, wird das Paket nicht ausgeführt.If a mismatch occurs, the package will not execute.

    Bei den Werten handelt es sich um lange ganze Zahlen.The values are long integers. Das Argument kann eine von drei Formen annehmen, wobei ein Wert für Hauptversion immer erforderlich ist:The argument can have one of three forms, with a value for major always required:

    • Hauptversionmajor

    • Hauptversion;Nebenversionmajor;minor

    • Hauptversion; Nebenversion; Buildmajor; minor; build

  • /VerifyP[ackageID] packageID:/VerifyP[ackageID] packageID:
    Optional.Optional. Überprüft die GUID des auszuführenden Pakets anhand des Werts, der im Paket-ID -Argument angegeben wurde.Verifies the GUID of the package to be executed by comparing it to the value specified in the package_id argument.

  • /VerifyS[igned] :/VerifyS[igned]:
    Optional.Optional. Veranlasst Integration ServicesIntegration Services dazu, die digitale Signatur des Pakets zu überprüfen.Causes Integration ServicesIntegration Services to check the digital signature of the package. Wenn das Paket nicht signiert oder die Signatur nicht gültig ist, schlägt das Paket fehl.If the package is not signed or the signature is not valid, the package fails. Weitere Informationen finden Sie unter Identifizieren der Quelle von Paketen mit digitalen Signaturen.For more information, see Identify the Source of Packages with Digital Signatures.

    Wichtig

    Wenn Sie die Überprüfung der Signatur des Pakets konfiguriert haben, prüft Integration ServicesIntegration Services lediglich, ob die digitale Signatur vorhanden und gültig ist und ob die Quelle vertrauenswürdig ist.When configured to check the signature of the package, Integration ServicesIntegration Services only checks whether the digital signature is present, is valid, and is from a trusted source. Integration ServicesIntegration Services überprüft nicht, ob Änderungen am Paket vorgenommen wurden.does not check whether the package has been changed.

    Hinweis

    Der optionale BlockedSignatureStates Registrierungswert kann eine Einstellung, die restriktiver ist als die digitale Signatur Optionssatz in angeben SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) oder auf die dtexec über die Befehlszeile.The optional BlockedSignatureStates registry value can specify a setting that is more restrictive than the digital signature option set in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) or at the dtexec command line. In dieser Situation überschreibt die restriktivere Registrierungseinstellung die andere Einstellung.In this situation, the more restrictive registry setting overrides the other settings.

  • /VerifyV[ersionID] versionID: Optional./VerifyV[ersionID] versionID: Optional. Überprüft die Versions-GUID eines auszuführenden Pakets; diese wird mit dem Wert verglichen, der während der Paketüberprüfungsphase im Versions-ID -Argument angegeben wurde.Verifies the version GUID of a package to be executed by comparing it to the value specified in the version_id argument during package Validation Phase.

  • /VLog [Filespec] : Optional./VLog [Filespec]: Optional. Schreibt alle Integration Services-Paketereignisse an die Protokollanbieter, die beim Entwurf des Pakets aktiviert wurden.Writes all Integration Services package events to the log providers that were enabled when the package was designed. Geben Sie im Dateiangabe -Parameter einen Pfad- und Dateinamen an, damit Integration Services einen Protokollanbieter für Textdateien aktiviert und Protokollereignisse in eine festgelegte Textdatei schreibt.To have Integration Services enable a log provider for text files and write log events to a specified text file, include a path and file name as the Filespec parameter.

    Wenn Sie den Dateiangabe -Parameter nicht einschließen, aktiviert Integration Services keinen Protokollanbieter für Textdateien.If you do not include the Filespec parameter, Integration Services will not enable a log provider for text files. Integration Services schreibt dann Protokollereignisse nur an die Protokollanbieter, die beim Entwurf des Pakets aktiviert wurden.Integration Services will only write log events to the log providers that were enabled when the package was designed.

  • /W[arnAsError] :/W[arnAsError]:
    Optional.Optional. Bewirkt, dass das Paket eine Warnung wie einen Fehler behandelt. Das Paket erzeugt daher einen Fehler, wenn während des Überprüfens eine Warnung ausgegeben wird.Causes the package to consider a warning as an error; therefore, the package will fail if a warning occurs during validation. Wenn während des Überprüfens keine Warnung ausgegeben wird und die Option /Validate nicht angegeben wurde, wird das Paket ausgeführt.If no warnings occur during validation and the /Validate option is not specified, the package is executed.

  • /X86: Optional./X86: Optional. Veranlasst den SQL ServerSQL Server -Agent, das Paket im 32-Bit-Modus auf einem 64-Bit-Computer auszuführen.Causes SQL ServerSQL Server Agent to run the package in 32-bit mode on a 64-bit computer. Diese Option wird von SQL ServerSQL Server -Agent festgelegt, wenn die folgenden Bedingungen den Wert True haben:This option is set by SQL ServerSQL Server Agent when the following conditions are true:

    • Der Auftragsschritt lautet SQL Server Integration Services-Paket.The job step type is SQL Server Integration Services package.

    • Die Option 32 Bit-Laufzeit verwenden auf der Registerkarte Ausführungsoptionen des Dialogfelds Neuer Auftragsschritt wird aktiviert.The Use 32 bit runtime option on the Execution options tab of the New Job Step dialog box is selected.

    Sie können diese Option auch für einen Auftragsschritt des SQL ServerSQL Server -Agents festlegen, indem Sie die gespeicherten Prozeduren oder SQL Server Management Objects (SMO) verwenden, um den Auftrag programmgesteuert zu erstellen.You can also set this option for a SQL ServerSQL Server Agent job step by using stored procedures or SQL Server Management Objects (SMO) to programmatically create the job.

    Diese Option wird nur von SQL ServerSQL Server -Agent verwendet.This option is only used by SQL ServerSQL Server Agent. Diese Option wird ignoriert, wenn Sie das Hilfsprogramm dtexec an der Eingabeaufforderung ausführen.This option is ignored if you run the dtexec utility at the command prompt.

HinweiseRemarks

Die Reihenfolge, in der Sie die Befehlsoptionen angeben, kann sich auf die Art und Weise der Paketausführung auswirken:The order in which you specify command options can influence the way in which the package executes:

  • Optionen werden in der Reihenfolge verarbeitet, in der sie in der Befehlszeile erkannt werden.Options are processed in the order they are encountered on the command line. Befehlsdateien werden eingelesen, wenn sie in der Befehlszeile erkannt werden.Command files are read in as they are encountered on the command line. Die Befehle in der Befehlsdatei werden ebenfalls in der Reihenfolge verarbeitet, in der sie erkannt werden.The commands in the command file are also processed in the order they are encountered.

  • Wenn eine Option, ein Parameter oder eine Variable mehrmals in derselben Befehlszeilenanweisung angegeben wird, hat die letzte Instanz der Option Vorrang.If the same option, parameter, or variable appears in the same command line statement more than one time, the last instance of the option takes precedence.

  • Die Optionen /Set und /ConfigFile werden in der Reihenfolge verarbeitet, in der sie erkannt werden./Set and /ConfigFile options are processed in the order they are encountered.

BeispieleExamples

Die folgenden Beispiele veranschaulichen, wie Sie mit der dtexec eingabeaufforderungs-Hilfsprogramm zum Konfigurieren und ausführen SQL ServerSQL Server Integration ServicesIntegration Services Pakete.The following examples demonstrate how to use the dtexec command prompt utility to configure and execute SQL ServerSQL Server Integration ServicesIntegration Services packages.

Ausgeführte PaketeRunning Packages

Verwenden Sie folgenden Code, um ein in SSISSSIS gespeichertes SQL ServerSQL Server -Paket auszuführen, das die Windows-Authentifizierung verwendet:To execute an SSISSSIS package saved to SQL ServerSQL Server using Windows Authentication, use the following code:

dtexec /sq pkgOne /ser productionServer  

Wenn Sie ein SSISSSIS -Paket ausführen möchten, das im Ordner „Dateisystem“ im SSIS-Paketspeicher gespeichert wird, verwenden Sie folgenden Code:To execute an SSISSSIS package saved to the File System folder in the SSIS Package Store, use the following code:

dtexec /dts "\File System\MyPackage"  

Verwenden Sie folgenden Code, um ein Paket, das die Windows-Authentifizierung verwendet und in SQL ServerSQL Server gespeichert ist, zu überprüfen, ohne das Paket auszuführen:To validate a package that uses Windows Authentication and is saved in SQL ServerSQL Server without executing the package, use the following code:

dtexec /sq pkgOne /ser productionServer /va  

Verwenden Sie folgenden Code, um ein im Dateisystem gespeichertes SSISSSIS -Paket auszuführen:To execute an SSISSSIS package that is saved in the file system, use the following code:

dtexec /f "c:\pkgOne.dtsx"   

Verwenden Sie folgenden Code, um ein im Dateisystem gespeichertes SSISSSIS -Paket auszuführen und Protokollierungsoptionen anzugeben:To execute an SSISSSIS package that is saved in the file system, and specify logging options, use the following code:

dtexec /f "c:\pkgOne.dtsx" /l "DTS.LogProviderTextFile;c:\log.txt"  

Verwenden Sie folgenden Code, um ein Paket auszuführen, das die Windows-Authentifizierung verwendet und in der standardmäßigen lokalen Instanz von SQL ServerSQL Servergespeichert ist, und um die Paketversion vor dem Ausführen zu überprüfen:To execute a package that uses Windows Authentication and is saved to the default local instance of SQL ServerSQL Server, and verify the version before it is executed, use the following code:

dtexec /sq pkgOne /verifyv {c200e360-38c5-11c5-11ce-ae62-08002b2b79ef}  

Verwenden Sie folgenden Code, um ein im Dateisystem gespeichertes und extern konfiguriertes SSISSSIS-Paket auszuführen:To execute an SSISSSIS package that is saved in the file system and configured externally, use the following code:

dtexec /f "c:\pkgOne.dtsx" /conf "c:\pkgOneConfig.cfg"  

Hinweis

Die Paketpfad- oder Dateiangabe-Argumente der Optionen /SQL, /DTS oder /FILE müssen in Anführungszeichen eingeschlossen werden, wenn der Pfad- oder Dateiname ein Leerzeichen enthält.The package_path or filespec arguments of the /SQL, /DTS, or /FILE options must be enclosed in quotation marks if the path or file name contains a space. Wenn das Argument nicht in Anführungszeichen eingeschlossen ist, darf es keine Leerzeichen enthalten.If the argument is not enclosed in quotation marks, the argument cannot contain white space.

ProtokollierungsoptionLogging Option

Sind beispielsweise die Protokolleintragstypen A, B und C vorhanden, zeigt die Option ConsoleLog ohne Parameter alle drei Protokolltypen mit allen Feldern an:If there are three log entry types of A, B, and C, the following ConsoleLog option without a parameter displays all three log types with all fields:

/CONSOLELOG  

Die folgende Option zeigt alle Protokolltypen an, aber nur mit der Namens- und der Meldungsspalte:The following option displays all log types, but with the Name and Message columns only:

/CONSOLELOG NM  

Die folgende Option zeigt alle Spalten an, aber nur für den Protokolleintragstyp A:The following option displays all columns, but only for log entry type A:

/CONSOLELOG I;LogEntryTypeA  

Die folgende Option zeigt nur den Protokolleintragstyp A mit der Namens- und der Meldungsspalte an:The following option displays only log entry type A, with Name and Message columns:

/CONSOLELOG NM;I;LogEntryTypeA  

Die folgende Option zeigt Protokolleinträge für die Protokolleintragstypen A und B an:The following option displays log entries for log entry types A and B:

/CONSOLELOG I;LogEntryTypeA;LogEntryTypeB  

Sie können die gleichen Ergebnisse erzielen, indem Sie mehrere ConsoleLog -Optionen verwenden:You can achieve the same results by using multiple ConsoleLog options:

/CONSOLELOG I;LogEntryTypeA /CONSOLELOG I;LogEntryTypeB  

Wird die Option ConsoleLog ohne Parameter verwendet, werden alle Felder angezeigt.If the ConsoleLog option is used without parameters, all fields are displayed. Die Angabe des Listenoptionen -Parameters bewirkt, dass nur der Protokolleintragstyp A mit allen Feldern angezeigt wird:The inclusion of a list_options parameter causes the following to displays only log entry type A, with all fields:

/CONSOLELOG NM;I;LogEntryTypeA /CONSOLELOG  

Durch folgenden Code werden alle Protokolleintragstypen mit Ausnahme des Protokolleintragstyps A angezeigt; d. h. es werden nur die Protokolleintragstypen B und C angezeigt:The following displays all log entries except log entry type A: that is, it displays log entry types B and C:

/CONSOLELOG E;LogEntryTypeA  

Im folgenden Beispiel werden die gleichen Ergebnisse erzielt, indem die Option ConsoleLog mehrmals verwendet und eine einzelne Ausnahme definiert wird:The following example achieves the same results by using multiple ConsoleLog options and a single exclusion:

/CONSOLELOG E;LogEntryTypeA /CONSOLELOG  
/CONSOLELOG E;LogEntryTypeA /CONSOLELOG E;LogEntryTypeA  
/CONSOLELOG E;LogEntryTypeA;LogEntryTypeA  

Im folgenden Beispiel werden keine Protokollmeldungen angezeigt, da ein Protokolleintragstyp, der in der Inklusions- und der Ausschlussliste enthalten ist, ausgeschlossen wird.The following example displays no log messages, because when a log file type is found in both the included and excluded lists, it will be excluded.

/CONSOLELOG E;LogEntryTypeA /CONSOLELOG I;LogEntryTypeA  

Option SETSET Option

Im folgenden Beispiel wird die Verwendung der Option /SET gezeigt, mit der Sie den Wert der Paketeigenschaft oder -variablen ändern können, wenn Sie das Paket über die Befehlszeile starten.The following example shows how to use the /SET option, which lets you change the value of any package property or variable when you start the package from the command line.

/SET \package\DataFlowTask.Variables[User::MyVariable].Value;newValue  

ProjektoptionProject Option

Im folgenden Beispiel wird die Verwendung der Optionen /Project und /Package gezeigt.The following example shows how to use the /Project and the /Package option.

/Project c:\project.ispac /Package Package1.dtsx  

Im folgenden Beispiel werden die Verwendung der Optionen /Project und /Package sowie das Festlegen des Pakets und der Projektparameter gezeigt.The following example shows how to use the /Project and /Package options, and set package and project parameters.

/Project c:\project.ispac /Package Package1.dtsx /SET \Package.Variables[$Package::Parameter];1 /SET \Package.Variables[$Project::Parameter];1  
  

ISServer-OptionISServer Option

Im folgenden Beispiel wird die Verwendung der Option /ISServer gezeigt.The following example shows how to use the /ISServer option.

dtexec /isserver "\SSISDB\MyFolder\MyProject\MyPackage.dtsx" /server "."  

Im folgenden Beispiel werden die Verwendung der Option /ISServer sowie das Festlegen der Projekt- und Verbindungs-Manager-Parameter gezeigt.The following example shows how to use the /ISServer option and set project and connection manager parameters.

/Server localhost /ISServer "\SSISDB\MyFolder\Integration Services Project1\Package.dtsx" /Par "$Project::ProjectParameter(Int32)";1 /Par "CM.SourceServer.InitialCatalog";SourceDB  
  

Ausführen eines Pakets in SQL Server-DatentoolsRun a Package in SQL Server Data Tools

Blogeintrag zu Exitcodes, DTEXEC und SSIS-Katalog auf www.mattmasson.com.Blog entry, Exit Codes, DTEXEC, and SSIS Catalog, on www.mattmasson.com.