dtutil (Hilfsprogramm)

/?

Zeigt die Befehlszeilenoptionen an.

/C[opy] location;destinationPathandPackageName

Gibt eine Kopieraktion für ein SSIS-Paket an. Um diesen Parameter verwenden zu können, müssen Sie zunächst mithilfe der Option /FI, /SQ oder /DT den Speicherort des Pakets angeben. Geben Sie anschließend den Zielspeicherort und den Zielpaketnamen an. Das destinationPathandPackageName-Argument gibt an, wohin das SSIS-Paket kopiert wird. Wenn SQL als Ziel-location angegeben wird, müssen im Befehl auch die Argumente DestUser, DestPassword und DestServer angegeben werden.

Wenn bei der Copy-Aktion ein vorhandenes Paket am Ziel gefunden wird, wird der Benutzer von dtutil aufgefordert, das Löschen des Pakets zu bestätigen. Die Angabe von Y bewirkt, dass das Paket überschrieben wird; mit N wird das Programm beendet. Wenn der Befehl das Quiet-Argument einschließt, wird keine Aufforderung angezeigt, und vorhandene Pakete werden ggf. überschrieben.

/Dec[rypt] password

(Optional). Legt das Entschlüsselungskennwort fest, das beim Laden eines Pakets mit Kennwortverschlüsselung verwendet wird.

/Del[ete]

Löscht das durch die Option SQL, DTS oder FILE angegebene Paket. Wenn dtutil das Paket nicht löschen kann, wird das Programm beendet.

/DestP[assword] password

Gibt das Kennwort an, das mit der Option SQL verwendet wird, um mithilfe der SQL Server-Authentifizierung eine Verbindung mit der SQL Server-Instanz herzustellen. Wenn DESTPASSWORD in einer Befehlszeile angegeben wird, die die Option DTSUSER nicht einschließt, wird ein Fehler generiert.

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

/DestS[erver] server_instance

Gibt den Servernamen an, der für eine beliebige Aktion verwendet wird, in deren Verlauf ein Zielpaket in einer SQL Server-Instanz gespeichert wird. Mit dieser Option wird beim Speichern eines SSIS-Pakets ein nicht lokaler oder ein nicht standardmäßiger Server identifiziert. DESTSERVER darf nicht in einer Befehlszeile angegeben werden, die keine Aktion einschließt, die SQL Server zugeordnet ist. Geeignete Aktionen, um diese Option anzugeben, wären beispielsweise Aktionen, wie sie durch SIGN SQL, COPY SQL oder MOVE SQL angegeben werden.

Ein SQL Server-Instanzname kann angegeben werden, indem dem Servernamen ein umgekehrter Schrägstrich und der Instanzname hinzugefügt wird.

/DestU[ser] username

Gibt den Benutzernamen an, der mit den Optionen SIGN SQL, COPY SQL und MOVE SQL verwendet wird, um eine Verbindung mit einer Instanz von SQL Server herzustellen, die die SQL Server-Authentifizierung verwendet. DESTUSER darf nicht in einer Befehlszeile angegeben werden, die die Option SIGN SQL, COPY SQL oder MOVE SQL nicht einschließt.

/Dump process ID

(Optional) Veranlasst den angegebenen Prozess, entweder das dtexec-Hilfsprogramm oder den dtsDebugHost.exe-Prozess, anzuhalten und die Debugdumpdateien .mdmp und .tmp zu erstellen.

Hinweis
Um die Option /Dump zu verwenden, muss Ihnen das Benutzerrecht für Debugprogramme (SeDebugPrivilege) zugewiesen werden.

Um process ID für den Prozess zu suchen, den Sie anhalten möchten, verwenden Sie den Windows Task-Manager.

In der Standardeinstellung speichert Integration Services die Debugdumpdateien im Ordner "<drive>:\Programme\Microsoft SQL Server\110\Shared\ErrorDumps".

Weitere Informationen zum dtexec-Hilfsprogramm und zum dtsDebugHost.exe-Prozess finden Sie unter dtexec (Hilfsprogramm) und Erstellen, Bereitstellen und Debuggen von benutzerdefinierten Objekten.

Weitere Informationen zu Debugdumpdateien finden Sie unter Generieren von Dumpdateien für die Paketausführung.

Hinweis
Debugdumpdateien können vertrauliche Informationen enthalten. Verwenden Sie eine Zugriffssteuerungsliste, um den Zugriff auf die Dateien einzuschränken oder die Dateien in einen Ordner mit eingeschränktem Zugriff zu kopieren.

/DT[S] filespec

Gibt an, dass sich das SSIS-Paket, auf das sich der Vorgang bezieht, im SSIS-Paketspeicher befindet. Das filespec-Argument muss den Ordnerpfad beginnend mit dem Stamm des SSIS-Paketspeichers enthalten. Standardmäßig lauten die Namen der Stammordner in der Konfigurationsdatei "MSDB" und "Dateisystem". Pfade, die ein Leerzeichen enthalten, müssen in doppelte Anführungszeichen gesetzt werden.

Wenn die Option DT[S] in derselben Befehlszeile wie eine der folgenden Optionen angegeben wird, wird der Fehler DTEXEC_DTEXECERROR zurückgegeben:

• FILE

• SQL

• SOURCEUSER

• SOURCEPASSWORD

• SOURCESERVER

/En[crypt] {SQL | FILE}; Path;ProtectionLevel[;password]

(Optional). Verschlüsselt das geladene Paket mit der angegebenen Schutzebene und dem angegebenen Kennwort und speichert es an dem in Path angegebenen Speicherort. Der Wert für ProtectionLevel bestimmt, ob ein Kennwort erforderlich ist.

• SQL - Path ist der Name des Zielpakets.

• FILE - Path ist der vollqualifizierte Pfad und Dateiname für das Paket.

• DTS - Diese Option wird zurzeit nicht unterstützt.

ProtectionLevel-Optionen:

Ebene 0: Vertrauliche Informationen werden entfernt.

Ebene 1: Vertrauliche Informationen werden mithilfe der lokalen Benutzeranmeldeinformationen verschlüsselt.

Ebene 2: Vertrauliche Informationen werden mithilfe des erforderlichen Kennworts verschlüsselt.

Ebene 3: Das Paket wird mithilfe des erforderlichen Kennworts verschlüsselt.

Ebene 4: Das Paket wird mithilfe der lokalen Benutzeranmeldeinformationen verschlüsselt.

Ebene 5: Für das Paket wird die Speicherverschlüsselung von SQL Server verwendet.

/Ex[ists]

(Optional). Wird verwendet, um zu bestimmen, ob ein Paket vorhanden ist. dtutil versucht, das entweder von SQL-, DTS- oder FILE-Optionen angegebene Paket zu finden. Wenn dtutil das angegebene Paket nicht finden kann, wird der Fehler DTEXEC_DTEXECERROR zurückgegeben.

/FC[reate] {SQL | DTS};ParentFolderPath;NewFolderName

(Optional). Erstellt einen neuen Ordner mit dem in NewFolderName angegebenen Namen. Der Pfad des neuen Ordners wird mit ParentFolderPath angegeben.

/FDe[lete] {SQL | DTS}[;ParentFolderPath;FolderName]

(Optional). Löscht den in FolderName angegebenen Ordner aus SQL Server oder SSIS. Der Pfad des zu löschenden Ordners wird durch ParentFolderPath angegeben.

/FDi[rectory] {SQL | DTS};FolderPath[;S]

(Optional). Listet den Inhalt (Ordner sowie Pakete) eines Ordners in SSIS oder SQL Server auf. Mit dem optionalen FolderPath-Parameter wird der Ordner angegeben, dessen Inhalt Sie anzeigen möchten. Mit dem optionalen Parameter S wird angegeben, dass Sie für den in FolderPath angegebenen Ordner eine Liste mit den Inhalten der Unterordner anzeigen möchten.

/FE[xists ] {SQL | DTS};FolderPath

(Optional). Überprüft, ob der angegebene Ordner in SSIS oder SQL Server vorhanden ist. Der FolderPath-Parameter gibt den Pfad und den Namen des zu überprüfenden Ordners an.

/Fi[le] filespec

Diese Option gibt an, dass sich das SSIS-Paket, auf das sich der Vorgang bezieht, im Dateisystem befindet. Der Wert für filespec kann als UNC-Pfad (Universal Naming Convention) oder als lokaler Pfad angegeben werden.

Wenn die Option File in derselben Befehlszeile wie eine der folgenden Optionen angegeben wird, wird der Fehler DTEXEC_DTEXECERROR zurückgegeben:

• DTS

• SQL

• SOURCEUSER

• SOURCEPASSWORD

• SOURCESERVER

/FR[ename] {SQL | DTS} [;ParentFolderPath; OldFolderName;NewFolderName]

(Optional). Benennt einen Ordner in SSIS oder SQL Server um. ParentFolderPath gibt den Pfad des Ordners an, der umbenannt werden soll. OldFolderName ist der aktuelle Name des Ordners; NewFolderName ist der neue Name, der dem Ordner zugewiesen werden soll.

/H[elp] option

Zeigt eine ausführliche Hilfe mit den Optionen von dtutil und ihrer jeweiligen Verwendung an. Das option-Argument ist optional. Wenn das Argument angegeben wird, umfasst der Hilfetext ausführliche Informationen zur angegebenen Option. Im folgenden Beispiel wird Hilfe zu allen Optionen angezeigt:

dtutil /H

In den folgenden zwei Beispielen wird gezeigt, wie mithilfe der Option /H die erweiterte Hilfe zu einer bestimmten Option (in diesem Beispiel zur Option /Q [uiet]) angezeigt wird:

dtutil /Help Quiet

dtutil /H Q

/I[DRegenerate]

Erstellt einen neuen GUID für das Paket und aktualisiert die Paket-ID. Beim Kopieren eines Pakets wird die Paket-ID nicht geändert. Die Protokolldateien enthalten daher für beide Pakete denselben GUID. Mit dieser Aktion wird ein neuer GUID für das neu kopierte Paket erstellt, damit es vom Originalpaket unterschieden werden kann.

/M[ove] {SQL | File | DTS}; pathandname

Gibt eine Verschiebeaktion für ein SSIS-Paket an. Um diesen Parameter verwenden zu können, müssen Sie zunächst mithilfe der Option /FI, /SQ oder /DT den Speicherort des Pakets angeben. Geben Sie anschließend die Move-Aktion an. Für diese Aktion sind zwei durch Semikolon getrennte Argumente erforderlich:

• Als Zielargument kann SQL, FILE oder DTS angegeben werden. Wird SQL als Ziel angegeben, können die Optionen DESTUSER, DESTPASSWORD und DESTSERVER angegeben werden.

• Mit dem pathandname -Argument wird der Speicherort des Pakets angegeben: SQL verwendet den Paketpfad und Paketnamen, FILE verwendet einen UNC-Pfad oder lokalen Pfad, und DTS verwendet einen Speicherort, der relativ zum Stammverzeichnis des SSIS-Paketspeichers ist. Wenn als Ziel FILE oder DTS angegeben wird, schließt das Pfadargument keinen Dateinamen ein. Stattdessen wird der Paketname am angegebenen Speicherort als Dateiname verwendet.

Wenn die MOVE-Aktion ein vorhandenes Paket am Ziel ermittelt, werden Sie von dtutil aufgefordert, das Überschreiben des Pakets zu bestätigen. Die Angabe von Y bewirkt, dass das Paket überschrieben wird; mit N wird das Programm beendet. Wenn der Befehl die Option QUIET einschließt, wird keine Aufforderung angezeigt, und vorhandene Pakete werden ggf. überschrieben.

/Q[uiet]

Unterdrückt die Bestätigungsaufforderungen, die angezeigt werden können, wenn ein Befehl, der die Option COPY, MOVE oder SIGN einschließt, ausgeführt wird. Diese Aufforderungen werden angezeigt, wenn auf dem Zielcomputer bereits ein Paket mit demselben Namen wie das angegebene Paket vorhanden ist oder wenn das angegebene Paket bereits signiert ist.

/R[emark] text

Fügt einen Kommentar zur Befehlszeile hinzu. Das Kommentarargument ist optional. Wenn der Kommentartext Leerzeichen enthält, muss der Text in Anführungszeichen eingeschlossen werden. Sie können die REM-Option mehrfach in einer Befehlszeile angeben.

/Si[gn] {SQL | File | DTS}; path; hash

Signiert ein SSIS-Paket. Für diese Aktion sind drei durch Semikolons getrennte Argumente erforderlich:

• Als Zielargument kann SQL, FILE oder DTS angegeben werden. Wird SQL als Ziel angegeben, können die Optionen DESTUSER, DESTPASSWORD und DESTSERVER angegeben werden.

• Mit dem path-Argument wird der Speicherort des Pakets angegeben, für das die Aktion ausgeführt werden soll.

• Mit dem hash-Argument wird ein Zertifikatsbezeichner in Form einer Hexadezimalzeichenfolge unterschiedlicher Länge angegeben.

Weitere Informationen finden Sie unter Identifizieren der Quelle von Paketen mit digitalen Signaturen.

Wichtig
Wenn Sie die Überprüfung der Signatur des Pakets konfiguriert haben, prüft Integration Services lediglich, ob die digitale Signatur vorhanden und gültig ist und ob die Quelle vertrauenswürdig ist. Integration Services überprüft nicht, ob Änderungen am Paket vorgenommen wurden.

/SourceP[assword] password

Gibt das Kennwort an, das mit den Optionen SQL und SOURCEUSER verwendet wird, um das Abrufen eines SSIS-Pakets zu ermöglichen, das in einer Datenbank einer Instanz von SQL Server gespeichert ist, die die SQL Server-Authentifizierung verwendet. SOURCEPASSWORD darf nicht in einer Befehlszeile angegeben werden, die die Option SOURCEUSER nicht einschließt.

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

/SourceS[erver] server_instance

Gibt den Servernamen an, der mit der Option SQL verwendet wird, um das Abrufen eines in SSIS gespeicherten SQL Server-Pakets zu ermöglichen. SOURCESERVER darf nicht in einer Befehlszeile angegeben werden, die die Option SIGN SQL, COPYSQL oder MOVESQL nicht einschließt.

Ein SQL Server-Instanzname kann angegeben werden, indem dem Servernamen ein umgekehrter Schrägstrich und der Instanzname hinzugefügt wird.

/SourceU[ser] username

Gibt den Benutzernamen an, der mit der Option SOURCESERVER verwendet wird, um das Abrufen eines SSIS-Pakets zu ermöglichen, das in einer Instanz von SQL Server gespeichert ist, die die SQL Server-Authentifizierung verwendet. SOURCEUSER darf nicht in einer Befehlszeile angegeben werden, die die Option SIGN SQL, COPY SQL oder MOVE SQL nicht einschließt.

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

/SQ[L] package_path

Gibt den Speicherort eines SSIS-Pakets an. Diese Option gibt an, dass das Paket in der msdb-Datenbank gespeichert ist. Mit dem package_path-Argument wird der Pfad und der Name des SSIS-Pakets angegeben. Ordnernamen enden mit umgekehrten Schrägstrichen.

Wenn die Option SQL in derselben Befehlszeile wie eine der folgenden Optionen angegeben wird, wird der Fehler DTEXEC_DTEXECERROR zurückgegeben:

• DTS

• FILE

  Die Option SQL kann mit keiner Instanz oder einer Instanz der folgenden Optionen angegeben werden:

• SOURCEUSER

• SOURCEPASSWORD

• SOURCESERVER

Wenn Sie die Option SOURCEUSERNAME nicht einbezogen wird, wird die Windows-Authentifizierung für den Zugriff auf das Paket verwendet. SOURCEPASSWORD ist nur zulässig, wenn SOURCEUSER vorhanden ist. Wird SOURCEPASSWORD nicht angegeben, wird ein leeres Kennwort verwendet.

Wichtig
Verwenden Sie kein leeres Kennwort. Verwenden Sie ein sicheres Kennwort.

0

Das Hilfsprogramm wurde erfolgreich ausgeführt.

1

Beim Ausführen des Hilfsprogramms ist ein Fehler aufgetreten.

4

Das Hilfsprogramm konnte das angeforderte Paket nicht finden.

5

Das Hilfsprogramm konnte das angeforderte Paket nicht laden.

6

Das Hilfsprogramm konnte die Befehlszeile nicht auflösen, da sie syntaktische oder semantische Fehler enthielt.