Narzędzie dtutil
The dtutil command prompt utility is used to manage SQL Server Integration Services packages.Narzędzie to można skopiować, przenieść, usunąć lub sprawdzał, czy pakiet.Te akcje można wykonać w przypadku dowolnego SSIS pakiet, który jest przechowywany w jednym z trzech miejscach: a Microsoft SQL Server database, the SSIS Package Store, and the file system.Typ magazynu pakiet jest identyfikowany przez /SQL, /FILE, a /DTS Opcje.
Uwaga
Wielu operacji wykonywanych przez dtutil można również przeprowadzić wizualnie w SQL Server Management Studio Użytkownik podłączony do wystąpienie Integration Services. Aby uzyskać więcej informacji zobaczManaging Packages.
Opcje można wpisywać w dowolnej kolejności.Potoku ("|") jest znakiem OR operator i służy do wyświetlania wartości. Należy użyć jednej z opcji, które są rozdzielone OR potoku.
Wszystkie opcje musi zaczynać się od kreski ułamkowej (/) lub znak minus (-).Jednak nie należy umieszczać spacji między kreską ułamkową lub znaku minus i tekstu dla opcji; w przeciwnym wypadku polecenie zakończy się niepowodzeniem.
Argumenty muszą być ciągów, które są albo zamkniętych w znaki cudzysłowu lub zawierają nie odstępów.
Podwójny cudzysłów w ciągu ciągów, które są ujęte w znaki cudzysłowu reprezentują oznaczenie pojedynczy cudzysłów.
Opcje i argumentów, z wyjątkiem hasła, nie jest uwzględniana wielkość liter.
Uwagi dotyczące instalacji na komputerach 64-bitowych
Na komputerze z 64-bitowych Integration Services Instaluje wersja 64-bitowych dtexec narzędzie (dtexec.exe) i dtutil narzędzie (dtutil.exe).Aby zainstalować 32-bitowe wersje tych Integration Services narzędzia, należy zaznaczyć albo narzędzia klient lub Business Intelligence Development Studio Podczas instalacji.
Domyślnie komputer 64-bitowy, ma zarówno 64-bitowych i 32-bitowych wersjach Integration Services zainstalowanego narzędzia wiersz polecenia zostanie uruchomione w 32-bitowej wersja w wiersz polecenia. 32-Bitowa wersja jest uruchamiana, ponieważ ścieżka katalogu dla wersji 32-bitowej pojawia się w zmiennej środowiskowej ścieżka przed ścieżka katalogu dla 64-bitowej wersji.(Zazwyczaj ścieżkę katalogu w 32-bitowy jest <dysk>: \Program \Microsoft SQL Server\100\DTS\Binn plików (x 86), gdy jest to ścieżka do katalogu 64-bitowych <dysk>: \Program Files\Microsoft SQL Server\100\DTS\Binn.)
Uwaga
Uruchom narzędzie za pomocą programu SQL Server Agent programu SQL Server Agent automatycznie używa wersja 64-bitowe narzędzia.Agenta programu SQL Server używa rejestru nie zmiennej środowiskowej ścieżka, aby zlokalizować poprawny plik wykonywalny dla tego narzędzia.
Aby upewnić się, uruchomić 64-bitowa wersja narzędzia wiersz polecenia, należy wykonać jedną z następujących czynności:
Otwórz okno wiersz polecenia, przejdź do katalogu zawierającego wersja 64-bitowe narzędzia (<dysk>: \Program Files\Microsoft SQL Server\100\DTS\Binn), a następnie uruchomić narzędzie z tej lokalizacji.
W wiersz polecenia Uruchom narzędzie wprowadzając (pełna ścieżka<dysk>: \Program Files\Microsoft SQL Server\100\DTS\Binn) do 64-bitowej wersja narzędzia.
Zmienia kolejność ścieżka w zmiennej środowiskowej ścieżka, umieszczając (64-bitowych ścieżka<dysk>: \Program Files\Microsoft SQL Server\100\DTS\Binn) przed (32-bitowe ścieżka<dysk>:\ Program Files (x 86) \Microsoft SQL Server\100\DTS\Binn) w zmiennej.
dtutil /option [value] [/option [value]]...
Parameters
Opcja |
Description |
|---|---|
/? |
Wyświetla opcje wiersz polecenia. |
/C [opiuj] location;destinationPathandPackageName |
Określa akcja kopiowania na SSIS pakiet. Użycie tego parametru wymaga określenia lokalizacji przy użyciu pakiet /FI, /SQ, or /DT opcji.Następnie należy określić nazwę docelowej lokalizacji obiekt docelowy pakiet.The destinationPathandPackageName argument specifies where the SSIS pakiet is copied to. Jeśli obiekt obiekt docelowy location jest SQL, DestUser, DestPassword i DestServer argumenty również musi być określona w poleceniu. Gdy Copy Akcja napotka istniejący pakiet, w miejscu docelowym, dtutil monituje użytkownika, aby potwierdzić usunięcie pakietu.The Y reply overwrites the pakiet and the N reply ends the program. Jeżeli polecenie zawiera Quiet zostanie wyświetlony monit nie argument, i każdy istniejący pakiet jest zastępowany. |
/ Gru [rypt] password |
(Opcjonalne).Ustawia hasło odszyfrowywania używaną podczas ładowania pakiet z szyfrowanie haseł. |
/ DEL [ete] |
Usuwa określony przez pakiet SQL, DTS lub FILE Opcja. Jeśli dtutil nie można usunąć pakiet zakończenia programu. |
/ DestP [assword] password |
Określa hasło, które jest używane w przypadku opcji programu SQL do łączenia się z obiekt docelowy SQL Server przy użyciu wystąpienie SQL Server Uwierzytelnianie. Jeśli zostanie wygenerowany błąd DESTPASSWORD jest określony w wierszu polecenia, który nie zawiera DTSUSER Opcja. .gif "Note") Note:
When possible, use Windows Authentication..
|
/ DestS [erwer] server_instance |
Określa nazwa serwera, który jest używany z każdej akcja, która powoduje, że obiekt obiekt docelowy do zapisania SQL Server. Jest ona używana do identyfikowania serwera innym niż lokalny lub inny niż domyślny podczas zapisywania SSIS pakiet. Jest błędem, aby określić DESTSERVER w wierszu polecenia, który nie ma akcja skojarzonej z SQL Server. Akcje, takie jak SIGN SQL, COPY SQL, lub MOVE SQL Opcje byłoby właściwe polecenia do łączenia danych z tej opcji. A SQL Server Nazwa wystąpienie może być określona przez dodanie znaku odwrotnej kreski ukośnej i nazwę obiektu do nazwa serwera. |
/ DestU [żytkownika] username |
Określa nazwę użytkownika, który jest używany z SIGN SQL, COPY SQL, a MOVE SQL Opcje, aby połączyć się z SQL Server wystąpienie, które używa SQL Server Uwierzytelnianie. Jest błędem, aby określić DESTUSER w wierszu polecenia, który nie zawiera SIGN SQL, COPY SQL, lub MOVE SQL Opcja. |
/ automatyczna kopia zapasowa process ID |
(Opcjonalnie) Albo powoduje, że określony proces dtexec Narzędzie lub dtsDebugHost.exe proces, aby wstrzymać i tworzyć pliki automatyczna kopia zapasowa debugowania, .mdmp i .tmp. Note:
Aby użyć / automatyczna kopia zapasowa opcji, użytkownik musi być przypisany prawo użytkownika do debugowania programów (SeDebugPrivilege).
Aby znaleźć process ID proces, który chcesz wstrzymać użyj Menedżera zadań systemu Windows. Domyślnie Integration Services w folderze, są przechowywane pliki automatyczna kopia zapasowa debugowania <dysk>: \Program Files\Microsoft SQL Server\100\Shared\ErrorDumps. Aby uzyskać więcej informacji na temat dtexec Narzędzie a dtsDebugHost.exe patrz procesuNarzędzie dtexec i Budowanie, wdrażanie i debugowanie obiekty niestandardowe. Aby uzyskać więcej informacji na temat plików automatyczna kopia zapasowa debugowania zobacz Working with Debug Dump Files. Note:
Debugowania automatyczna kopia zapasowa pliki mogą zawierać poufne informacje.Użyj listy kontroli dostępu (ACL) w celu ograniczenia dostępu do plików lub skopiować pliki do folderu z ograniczonym dostępem.
|
/DT [S] filespec |
Określa, że SSIS pakiet ma być prowadzone na znajduje się w SSIS Magazyn pakietu. The filespec argument must include the folder ścieżka, starting with the root of the SSIS pakiet Store. Domyślnie nazwy folderów głównych w pliku konfiguracyjnym są "MSDB" i „ system plików. „ Ścieżki zawierające spacje muszą być rozdzielone przy użyciu podwójnych cudzysłowów. Jeśli opcja [S] DT jest określona w tym samym wierszu polecenia jako jedną z następujących opcji, zwracana jest wartość DTEXEC_DTEXECERROR:
|
/En [crypt] {SQL | FILE}; Path;ProtectionLevel[;password] |
(Opcjonalne).Szyfruje pakiet załadowane z poziomem ochrony określonego i hasło i zapisuje go w lokalizacji określonej w polu Path. The ProtectionLevel determines whether a password is required.
ProtectionLevel opcje: Poziom 0: Paski poufne informacje. Poziom 1: Ważne informacje są szyfrowane przy użyciu poświadczenia użytkownika lokalnego. Poziom 2: Ważne informacje są szyfrowane za pomocą hasła wymaganego. Poziom 3: Pakiet jest zaszyfrowany za pomocą hasła wymaganego. Poziom 4: Pakiet jest zaszyfrowany przy użyciu poświadczenia użytkownika lokalnego. Korzysta z pakiet poziom 5 SQL Server szyfrowanie magazynu. |
/Ex [ists] |
(Opcjonalne).Used to determine whether a package exists.dtutil tries to locate the package specified by either the SQL, DTS or FILE options.Jeśli dtutil nie można zlokalizować określony pakiet, a DTEXEC_DTEXECERROR jest zwracany. |
{/FC [utworzyćSQL | DTS};ParentFolderPath;NewFolderName |
(Opcjonalne).Utwórz nowy folder o nazwie określonej w NewFolderName. Wskazuje lokalizację nowego folderu ParentFolderPath. |
/ {FDe [leteSQL | DTS}[;ParentFolderPath;FolderName] |
(Opcjonalne).Usuwa z SQL Server lub SSIS folder, który został określony przez nazwy w FolderName. Wskazuje lokalizację folderu, aby usunąć ParentFolderPath. |
/ {FDi [rectorySQL | DTS};FolderPath[;S] |
(Opcjonalne).Wyświetla zawartość zarówno foldery, jak i pakiety w folderze SSIS lub SQL Server. Opcjonalny FolderPath parametr określa folder, który chcesz wyświetlić jego treść. Opcjonalny S parametr określa, że należy wyświetlić listę zawartości podfolderów w folderze określonym w FolderPath. |
{/FE [xistsSQL | DTS};FolderPath |
(Opcjonalne).Sprawdza, czy podany folder istnieje w SSIS lub SQL Server. The FolderPath parameter is the ścieżka and name of the folder to verify. |
/Fi [le] filespec |
Ta opcja określa, że SSIS pakiet ma być prowadzone na znajduje się w systemie plików. The filespec value can be provided as either a Universal konwencja nazewnictwa (UNC) ścieżka or local ścieżka. Jeśli File Opcja jest określona w tym samym wierszu polecenia jako jedną z następujących opcji, a DTEXEC_DTEXECERROR jest zwracany:
|
{/FR [enameSQL | DTS} [;ParentFolderPath; OldFolderName;NewFolderName] |
(Opcjonalne).Zmienia nazwę folderu na SSIS lub SQL Server. The ParentFolderPath is the location of the folder to rename.The OldFolderName is the current name of the folder, and NewFolderName is the new name to give the folder. |
/H [elp] option |
Wyświetla Pomoc rozległe tekst, który pokazuje dtutil opcji i opisy ich stosowania.Opcja argument jest opcjonalny.Jeśli argument jest włączone, tekst pomocy zawiera szczegółowe informacje na temat określonej opcji.Poniższy przykład wyświetla Pomoc dla wszystkich opcji: dtutil /H Dwa poniższe przykłady przedstawiają metody korzystania /H Opcja wyświetlania rozszerzonej pomocy dla określonej opcji, /Q [uiet] Opcja, w tym przykładzie: dtutil /Help Quiet dtutil /H Q |
/I [DRegenerate] |
Tworzy nowy identyfikator GUID pakiet i aktualizuje właściwość IDENTYFIKATORA pakiet.Po skopiowaniu pakiet identyfikator pakietu pozostaje taki sam, więc pliki dziennika zawierają ten sam identyfikator GUID dla obu pakietów.Ta akcja tworzy nowy identyfikator GUID dla nowo skopiowany pakiet odróżnienie go od oryginalnego. |
{[Ove] / mSQL | File | DTS}; pathandname |
Określa akcja przeniesienia na SSIS pakiet. Aby używać tego parametru, należy najpierw określić lokalizację przy użyciu pakiet /FI, /SQ, or /DT opcji.Następnie należy określić Przenoszenie akcja.Ta akcja wymaga dwa argumenty, które są oddzielone średnikami:
Gdy PRZENOSZENIE akcja napotka pakietu istniejących w obiekt docelowy, dtutil wyświetli monit o potwierdzenie zamiaru zastąpienia tego pakietu.The Y reply overwrites the pakiet and the N reply ends the program. Jeżeli polecenie zawiera QUIET Opcja, monity nie pojawia się i wszelkie istniejący pakiet jest zastępowany. |
/ Q [uiet] |
Zatrzymuje monity potwierdzenia, na które mogą być wyświetlane przy tym polecenia COPY, MOVE, lub SIGN Opcja jest wykonywany. Monity pojawiają się, jeśli pakiet o takiej samej nazwie, określony pakiet już istnieje na komputerze docelowym lub jeśli określony pakiet jest już zarejestrowany. |
/R [emark] text |
Dodaje komentarz do wiersza polecenia.Argument komentarz jest opcjonalny.Jeśli tekst zawiera spacje, tekst musi być ujęty w cudzysłów.Można dołączyć wiele opcji REM w wierszu polecenia. |
{/Si [gnSQL | File | DTS}; path; hash |
Znaki SSIS pakiet. Tej akcja używa trzech argumentów wymagane są oddzielone średnikami:
Aby uzyskać więcej informacji zobaczUsing Digital Signatures with Packages. .gif "Important note") Important Note:
When configured to check the signature of the package, Integration Services only checks whether the digital signature is present, is valid, and is from a trusted source.Integration Services does not check whether the package has been changed.
|
/ SourceP [assword] password |
Określa hasło, które jest używane z SQL i SOURCEUSER opcje umożliwiające pobierania SSIS pakiet, który jest przechowywany w bazie danych na SQL Server wystąpienie, które używa SQL Server Uwierzytelnianie. Jest błędem, aby określić SOURCEPASSWORD w wierszu polecenia, który nie zawiera SOURCEUSER Opcja. Note:
When possible, use Windows Authentication.
|
/ Źródeł [erwer] server_instance |
Określa nazwa serwera, który jest używany z SQL możliwość włączenia pobierania SSIS pakiet, który jest przechowywany w SQL Server. It is an error to specify SOURCESERVER in a command line that does not include the SIGN SQL, COPYSQL, or MOVESQL option. A SQL Server Nazwa wystąpienie może być określona przez dodanie znaku odwrotnej kreski ukośnej i nazwę obiektu do nazwa serwera. |
/ SourceU [żytkownika] username |
Określa nazwę użytkownika, który jest używany z SOURCESERVER możliwość włączenia pobierania SSIS przechowywane w pakiecie SQL Server za pomocą SQL Server Uwierzytelnianie. Jest błędem, aby określić SOURCEUSER w wierszu polecenia, który nie zawiera SIGN SQL, COPY SQL, lub MOVE SQL Opcja. Note:
When possible, use Windows Authentication.
|
/SQ [L] package_path |
Określa lokalizację SSIS pakiet. Opcja ta wskazuje, że pakiet jest przechowywany w msdb bazy danych.The package_path argument specifies the ścieżka and name of the SSIS pakiet. Nazwy folderów są zakończyła działanie; wstecz kresek ułamkowych. Jeśli SQL Opcja jest określona w tym samym wierszu polecenia jako jedną z następujących opcji, a DTEXEC_DTEXECERROR jest zwracany:
If SOURCEUSERNAME is not included, Windows Authentication is used to access the package.SOURCEPASSWORD is allowed only if SOURCEUSER is present.Jeśli SOURCEPASSWORD to nie jest włączone, puste hasło jest używane. Important Note:
Do not use a blank password. Use a strong password.
|
dtutil kody wyjścia
dtutil ustawia kod wyjściowy, który powiadamia użytkownika, kiedy zostaną wykryte błędy składni, używane są niepoprawne argumenty funkcji lub nieprawidłowa kombinacja opcji są określone.W przeciwnym razie narzędzie zgłasza te "Operacja zakończona pomyślnie" po tabela zawiera listę wartości, dtutil narzędzie zestaw podczas zamykania.
Wartość |
Description |
|---|---|
0 |
Narzędzia, została wykonana pomyślnie. |
1 |
To narzędzie nie powiodło się. |
4 |
Narzędzie to nie może zlokalizować żądany pakiet. |
5 |
Narzędzie to nie można załadować żądanego pakiet |
6 |
Narzędzie to nie można rozpoznać wiersza polecenia, ponieważ zawiera błędy składni albo semantyki. |
Remarks
Nie można używać plików poleceń lub przekierowania z dtutil.
Kolejność opcji w wierszu polecenia nie ma znaczenia.
Przykłady
W poniższych przykładach szczegółowo scenariusze użycia typowe wiersza polecenia.
Kopiowanie przykłady
Aby skopiować pakiet, który jest przechowywany w msdb bazy danych dla lokalnego wystąpienie SQL Server przy użyciu uwierzytelnianie systemu Windows w magazynie pakietu SSIS, należy użyć następującej składni:
dtutil /SQL srcPackage /COPY DTS;destFolder\destPackage
Aby skopiować pakiet z lokalizacji w systemie plików do innej lokalizacji i podać inną nazwę kopii, należy użyć następującej składni:
dtutil /FILE c:\myPackages\mypackage.dtsx /COPY FILE;c:\myTestPackages\mynewpackage.dtsx
Aby skopiować do wystąpienie pakiet w lokalnym systemie plików SQL Server znajdujących się na innym komputerze, należy użyć następującej składni:
dtutil /FILE c:\sourcepkg.dtsx /DestServer <servername> /COPY SQL;destpkgname
Ponieważ /DestU[ser] i /DestP[assword] nie użyto opcji, przyjmowana jest uwierzytelnianie systemu Windows.
Aby utworzyć nowy identyfikator pakiet, po jego skopiowaniu, należy użyć następującej składni:
dtutil /I /FILE copiedpkg.dtsx
Aby utworzyć nowy identyfikator dla wszystkich pakietów w określonym folderze, należy użyć następującej składni:
for %%f in (C:\test\SSISPackages\*.dtsx) do dtutil.exe /I /FILE %%f
Wpisując polecenia w wiersz polecenia za pomocą pojedynczego znaku procentu (%).Jeżeli polecenie jest używane w pliku wsadowym, należy użyć podwójnego znaku procentu (%).
Usuwanie przykłady
Aby usunąć pakiet, który jest przechowywany w msdb bazy danych na wystąpienie z SQL Server który korzysta z uwierzytelnianie systemu Windows, należy użyć następującej składni:
dtutil /SQL delPackage /DELETE
Aby usunąć pakiet, który jest przechowywany w msdb bazy danych w wystąpieniu SQL Server używające SQL Server Uwierzytelnianie, należy użyć następującej składni:
dtutil /SQL delPackage /SOURCEUSER srcUserName /SOURCEPASSWORD #8nGs*w7F /DELETE
Uwaga
Aby usunąć pakiet z serwera o nazwie, należy dołączyć SOURCESERVER Opcja i jej argumentów. Serwer można określić tylko przy użyciu SQL Opcja.
Aby usunąć pakiet, który jest przechowywany w magazynie pakietu SSIS, należy użyć następującej składni:
dtutil /DTS delPackage.dtsx /DELETE
Aby usunąć pakiet, który jest przechowywany w systemie plików, należy użyć następującej składni:
dtutil /FILE c:\delPackage.dtsx /DELETE
Istnieje przykłady
Aby określić, czy pakiet istnieje w msdb bazy danych dla lokalnego wystąpienie SQL Server który korzysta z uwierzytelnianie systemu Windows, należy użyć następującej składni:
dtutil /SQL srcPackage /EXISTS
Aby określić, czy pakiet istnieje w msdb bazy danych dla lokalnego wystąpienie SQL Server używające SQL Server Uwierzytelnianie, należy użyć następującej składni:
dtutil SQL srcPackage /SOURCEUSER srcUserName /SOURCEPASSWORD *hY$d56b /EXISTS
Uwaga
Aby ustalić, czy pakiet istnieje na serwerze o nazwie, należy dołączyć SOURCESERVER Opcja i jej argumentów. Serwer można określić tylko przy użyciu opcji programu SQL.
Aby ustalić, czy pakiet istnieje w lokalnym magazynie pakietu, należy użyć następującej składni:
dtutil /DTS srcPackage.dtsx /EXISTS
Aby ustalić, czy pakiet istnieje w lokalnym systemie plików, należy użyć następującej składni:
dtutil /FILE c:\srcPackage.dtsx /EXISTS
Przenoszenie przykłady
Aby przenieść pakiet, który jest przechowywany w magazynie pakietu SSIS do msdb bazy danych dla lokalnego wystąpienie SQL Server który korzysta z uwierzytelnianie systemu Windows, należy użyć następującej składni:
dtutil /DTS srcPackage.dtsx /MOVE SQL;destPackage
Aby przenieść pakiet, który jest przechowywany w msdb bazy danych dla lokalnego wystąpienia SQL Server używające SQL Server Uwierzytelnianie msdb bazy danych na inne lokalne wystąpienie SQL Server używające SQL Server Uwierzytelnianie, należy użyć następującej składni:
dtutil /SQL srcPackage /SOURCEUSER srcUserName /SOURCEPASSWORD $Hj45jhd@X /MOVE SQL;destPackage /DESTUSER destUserName /DESTPASSWORD !38dsFH@v
Uwaga
Aby przenieść pakiet z jednego serwera o nazwie, należy dołączyć SOURCES oraz DESTS Opcja i ich argumentów. Serwery można określić tylko przy użyciu SQL Opcja.
Aby przenieść pakiet, który jest przechowywany w magazynie pakietu SSIS, należy użyć następującej składni:
dtutil /DTS srcPackage.dtsx /MOVE DTS;destPackage.dtsx
Aby przenieść pakiet, który jest przechowywany w systemie plików, należy użyć następującej składni:
dtutil /FILE c:\srcPackage.dtsx /MOVE FILE;c:\destPackage.dtsx
Przykłady znaku
Aby zarejestrować się pakiet, który jest przechowywany w SQL Server Baza danych na lokalnego wystąpienie SQL Server który korzysta z uwierzytelnianie systemu Windows, należy użyć następującej składni:
dtutil /FILE srcPackage.dtsx /SIGN FILE;destpkg.dtsx;1767832648918a9d989fdac9819873a91f919
Aby określić położenie informacji na temat certyfikat, należy użyć CertMgr.Kod skrótu można wyświetlać w CertMgr narzędzie wybranie certyfikat, a następnie klikając przycisk Widok , aby wyświetlić właściwości.The Details tab provides more information about the certyfikat.The Thumbprint właściwość is used as the hash value, with spaces removed.
Uwaga
Wartość mieszania używanych w tym przykładzie nie jest rzeczywistą wartość mieszania.
Aby uzyskać więcej informacji zobacz sekcję CertMgr w Podpisywanie i sprawdzania kodu przy użyciu technologii Authenticode.
Szyfruj przykłady
Poniższy przykład szyfruje PackageToEncrypt.dtsx oparte na plikach do EncryptedPackage.dts oparte na plikach, korzystając z szyfrowanie pełny pakiet, za pomocą hasła.To hasło, które jest używane do szyfrowanie EncPswd.
dtutil /FILE PackageToEncrypt.dtsx /ENCRYPT file;EncryptedPackage.dtsx;3;EncPswd