dtutil yardımcı programı
The dtutil command prompt utility is used to manage SQL Server Integration Services packages.Yardımcı program kopyalama, taşıma, silme veya paket varlığını doğrulamak.Bu eylemlerden herhangi üzerinde gerçekleştirilebilecek SSIS paket üç konumlardan birinde saklanır: a Microsoft SQL Server database, the SSIS Package Store, and the file system.Depolama türü paket tarafından tanımlanan /SQL, /FILE, ve /DTS Seçenekleri.
Not
Çoğu dtutil tarafından gerçekleştirilen operasyonların da görsel olarak gerçekleştirilebilir SQL Server Management Studio örneğine bağlı olduğunuzda Integration Services. Daha fazla bilgi için bkz:Paketleri yönetme.
Seçenekler, herhangi bir sırada yazılabilir.Dikey çizgi ("|") karakter OR işleç ve olası değerleri göstermek için kullanılır. Tarafından ayrılmış seçeneklerden birini kullanmalısınız OR Kanal.
Tüm seçenekler, ters eğik çizgi () veya eksi işareti (-) ile başlamalıdır.Ancak, eğik çizgiden veya eksi işareti ve seçenek için metin arasına bir boşluk ekleyin; aksi takdirde, komut başarısız olur.
Bağımsız değişkenler, ya da kapalı, tırnak işaretleri veya yok boşluk içeren bir dize olmalıdır.
Tırnak işaretleri içine alınmış dizeler çift tırnak işaretleri atlatma tek tırnak işareti temsil eder.
Seçenekleri ve bağımsız değişkenleri, dışında parolalar büyük/küçük harfe duyarlı değildir.
64 Bit bilgisayarlarda yüklemesi konuları
64-Bit bir bilgisayarda Integration Services 64-bit bir sürüm yüklediği dtexec yardımcı programı (dtexec.exe) ve dtutil yardımcı programı (dtutil.exe).Bu 32-bit sürümleri yüklemeye Integration Services Araçlar, her iki istemci araçları seçmelisiniz veya Business Intelligence Development Studio Kurulum sırasında.
Varsayılan olarak, 64-bit olan bir bilgisayarda, her iki 64-bit ve 32-bit sürümleri bir Integration Services yüklü bir komut istemi satırı yardımcı programı, komut istemi isteminde 32-bit sürüm çalışır. 32-Bit sürüm, 32-bit sürüm için dizin yolunu YOL ortam değişkeni 64-bit sürümler için dizin yolunu önce görünür, çünkü çalışır.(Bu genellikle, 32-bit bir dizin yol. <sürücü>: \Program Dosyaları (x 86) \Microsoft SQL Server\100\DTS\Binn, 64-bit dizin yolunu iken <sürücü>: \Program Files\Microsoft SQL Server\100\DTS\Binn.)
Not
Yardımcı programı çalıştırmak için SQL Server Agent'ı kullanıyorsanız, SQL Server Agent, yardımcı programı'nın 64-bit sürüm otomatik olarak kullanır.SQL Server Agent olmayan YOL ortam değişkeni, kayıt defteri yardımcı programının doğru yürütülebilir dosyayı bulmak için kullanır.
komut istemi isteminde yardımcı programı'nın 64-bit sürüm çalışan emin olmak için , aşağıdaki eylemlerden birini alabilir:
Bir komut istemi penceresi açmak için yardımcı programı'nın 64-bit sürüm içeren dizini değiştirin (<sürücü>: \Program Files\Microsoft SQL Server\100\DTS\Binn), ve yardımcı program, bu konumdan çalıştırın.
komut istemi isteminde, tam yol (girerek hizmet programını çalıştırın.<sürücü>: \Program Files\Microsoft SQL Server\100\DTS\Binn) yardımcı programı'nın 64-bit sürüm için.
64-Bit) yolunu (yerleştirerek, kalıcı yolları, yol ortam değişkeninde sırasını değiştirme<sürücü>: \Program Files\Microsoft SQL Server\100\DTS\Binn) 32-bit) yolunu (önce<sürücü>:\ Files (x 86) \Microsoft SQL Server\100\DTS\Binn program) değişkeninde.
dtutil /option [value] [/option [value]]...
Parameters
Seçenek |
Açıklama |
|---|---|
/? |
Komut istemi seçeneklerini görüntüler. |
/C [opy] location;destinationPathandPackageName |
Bir kopya eylem belirtir bir SSIS paket. Ilk konumunu belirtin, bu parametrenin kullanımı gerektirir paket kullanma /fi, /sq, or /dt seçeneği.Sonra hedef konumu hedef paket adı belirtin.The destinationPathandPackageName argument specifies where the SSIS paket is copied to. Hedef location olan SQL, DestUser, DestPassword ve DestServer bağımsız değişkenler aynı zamanda komut belirtilmeli. Zaman Copy Eylem varolan bir paket, hedefte karşılaşır. dtutil kullanıcı paket silme işlemini onaylamanızı ister.The Y reply overwrites the paket and the N reply ends the program. Ne zaman komut içeren Quiet bağımsız değişken, hiçbir istem görünür ve herhangi bir varolan paket üzerine yazılır. |
/ [Rypt] Ara password |
(Isteğe bağlı).Bir parola şifreleme paketini yüklediğinizde, kullanılan bir şifre çözme parolayı ayarlar. |
/ DEL [ete] |
Belirtilen paket siler SQL, DTS veya FILE seçeneği. If dtutil paket, program sona ermeden silinemiyor. |
/ DestP [arolayı] password |
SQL seçeneğiyle bir hedef bağlanmak için kullanılan parolayı belirtir. SQL Server Örnek kullanma SQL Server Kimlik doğrulaması. Bir hata oluşturulur DESTPASSWORD dahil değil bir komut satırında belirtilen DTSUSER seçeneği. .gif "Note") Note:
When possible, use Windows Authentication..
|
/ DestS [unucu] server_instance |
Ile kullanılır sunucunun adını belirtir eylem, bir hedef için kaydedilecek neden oluyor SQL Server. Yerel olmayan veya varsayılan olmayan bir sunucu kaydederken tanımlamak için kullanılan bir SSIS paket. Belirtmek için bir hatadır DESTSERVER ilişkili bir eylemin sahip bir komut satırı SQL Server. Gibi eylemleri SIGN SQL, COPY SQL, veya MOVE SQL Seçenekler, bu seçenek ile birleştirmek için uygun komutları olacaktır. C SQL Server örnek adı için sunucu adı bir ters eğik çizgi ve örnek adı ekleyerek belirtilebilir. |
/ DestU [ullanıcı] username |
Kullanılan kullanıcı adını belirtir SIGN SQL, COPY SQL, ve MOVE SQL bağlanmak için gereken seçenekleri bir SQL Server kullanan örnek SQL Server Kimlik doğrulaması. Belirtmek için bir hatadır DESTUSER Komut satırında içerir SIGN SQL, COPY SQL, veya MOVE SQL seçeneği. |
/ döküm process ID |
(Isteğe bağlı) Belirtilen işlem, ya da neden dtexec yardımcı programı ya dadtsDebugHost.exe işlemi, duraklatabilir ve hata ayıklama döküm dosyalarını, .mdmp ve .tmp oluşturun. Note:
Kullanılacak / döküm seçeneğini (SeDebugPrivilege) program hata ayıklama kullanıcı hakkı atanmalıdır.
Bulunacak process ID Duraklatmak istediğiniz işlem için Windows Görev Yöneticisi'ni kullanın. Varsayılan olarak, Integration Services hata ayıklama döküm dosyalarını klasöründe depolar. <sürücü>: \Program Files\Microsoft SQL Server\100\Shared\ErrorDumps. Hakkında daha fazla bilgi için dtexec yardımcı programı'nı ve dtsDebugHost.exe Bkz: işlemidtexec yardımcı programı ve Oluşturma, dağıtma ve özel nesneler için hata ayıklama. Hata ayıklama döküm dosyaları hakkında daha fazla bilgi için bkz: Hata ayıklama döküm dosyaları ile çalışma. Note:
Hata ayıklama döküm dosyalarını, önemli bilgiler içerebilir.Dosyaları sınırlı erişimi olan bir klasöre kopyalayın veya dosyalara erişimi kısıtlamak için erişim denetim listesi (ACL) kullanın.
|
/dt [s] filespec |
Belirleyen SSIS Paket üzerinde işletilen bulunan SSIS Paket depola. The filespec argument must include the folder yol, starting with the root of the SSIS paket Store. Varsayılan olarak, "MSDB" ve "Dosya sistemi" yapılandırma dosyasında kök klasörlerin adlarını alır. Boşluk içeren yol çift tırnak işaretleri kullanarak ayrılmış gerekir. Aynı komut satırında aşağıdaki seçeneklerden herhangi biri olarak DT [S] seçeneğini belirttiyseniz, bir DTEXEC_DTEXECERROR döndürülür:
|
/En [şifreli] {SQL | FILE}; Path;ProtectionLevel[;password] |
(Isteğe bağlı).Yüklenen paket belirtilen bir koruma düzey ve parola ile şifreler ve belirtilen konum kaydeder Path. The ProtectionLevel determines whether a password is required.
ProtectionLevel Seçenekler: Düzey 0: Şeritler hassas bilgiler içerir. Düzey 1: Önemli bilgileri, yerel kullanıcı kimlik bilgileri kullanılarak şifrelenir. Düzey 2: Önemli bilgiler, gerekli parolayla şifrelenir. Düzey 3: Paket, gerekli parolayla şifrelenir. Düzey 4: Paket, yerel kullanıcı kimlik bilgileri kullanılarak şifrelenir. Düzey 5 paket kullanır. SQL Server Depolama şifreleme. |
/Ex [ists] |
(Isteğe bağlı).Used to determine whether a package exists.dtutil tries to locate the package specified by either the SQL, DTS or FILE options.If dtutil belirtilen paket bulunamıyor, bir DTEXEC_DTEXECERROR döndürülür. |
/FC reate [{}SQL | DTS};ParentFolderPath;NewFolderName |
(Isteğe bağlı).Belirtilen adı taşıyan yeni bir klasör oluşturun. NewFolderName. Yeni klasörün konumunu belirtilir ParentFolderPath. |
/ FDe [lete] {}SQL | DTS}[;ParentFolderPath;FolderName] |
(Isteğe bağlı).Siler SQL Server veya SSIS adı tarafından belirtilen klasörü FolderName. Silinecek klasörü konumunu belirtilir ParentFolderPath. |
/ FDi [rectory] {}SQL | DTS};FolderPath[;S] |
(Isteğe bağlı).Klasörler hem de bir klasörde bulunan paketleri, içeriğini listeler. SSIS veya SQL Server. Isteğe bağlı FolderPath parametre içeriğini görüntülemek istediğiniz klasörü belirtir. Isteğe bağlı S parametresi, alt belirtilen klasörün içeriğini bir listesini görüntülemek istediğinizi belirtir. FolderPath. |
/FE [xists] {}SQL | DTS};FolderPath |
(Isteğe bağlı).Belirtilen klasör üzerinde olup olmadığını doğrular. SSIS veya SQL Server. The FolderPath parameter is the yol and name of the folder to verify. |
/Fi [le] filespec |
Bu seçenek belirleyen SSIS Paket işletilen için dosya sisteminde bulunur. The filespec value can be provided as either a Universal adlandırma kuralı (UNC) yol or local yol. If the File option is specified on the same command line as any of the following options, a DTEXEC_DTEXECERROR is returned:
|
/FR [ename] {}SQL | DTS} [;ParentFolderPath; OldFolderName;NewFolderName] |
(Isteğe bağlı).Bir klasörü yeniden adlandırır, SSIS veya 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 [ardım] option |
Gösteren metin kapsamlı Yardımı görüntüler dtutil seçenekleri ve kullanımları açıklanır.Seçenek bağımsız değişkeni isteğe bağlıdır.Yardım metnini, bağımsız değişken varsa, belirtilen seçenek hakkında ayrıntılı bilgi içerir.Aşağıdaki örnek, tüm seçenekler için Yardım görüntüler: dtutil /H Aşağıdaki iki örnek nasıl kullanacağınızı gösteren /H Belirli bir seçenek genişletilmiş yardımını görüntülemek için seçeneği /Q [uiet] Bu örnekte seçenek: dtutil /Help Quiet dtutil /H Q |
/ı [DRegenerate] |
Paket için yeni bir GUID oluşturur ve paket KIMLIĞINI güncelleştirir özellik.Paket kopyalandığında, paket KIMLIĞI aynı kalır; bu nedenle, bu günlük dosyaları aynı GUID için her iki paketi de içerir.Bu eylem, özgün ayırt etmek için yeni kopyalanan paket yeni bir GUID oluşturur. |
/M [aşı] {}SQL | File | DTS}; pathandname |
Bir hareket eylem belirtir bir SSIS paket. Bu parametreyi kullanmak için , önce yerini belirtin paket kullanma /fi, /sq, or /dt seçeneği.Sonra belirttiğiniz Taşıma eylem.Bu eylem, noktalı virgül ile ayrılmış iki bağımsız değişkenleri gerektirir:
Zaman TAŞIMA Varolan bir paket hedefte eylem karşılaşırdtutil paket üzerine yazdırmayı doğrulamanızı ister.The Y reply overwrites the paket and the N reply ends the program. Ne zaman komut içeren QUIET Sorgu yok seçeneği görünür ve herhangi bir varolan paket üzerine yazılır. |
/Q [uiet] |
Bir komut dahil olmak üzere, görüntülenen onay istekleri vermiyor COPY, MOVE, veya SIGN seçenek yürütülür. Bu istekleri belirtilen paketini, hedef bilgisayarda zaten mevcut olduğundan veya belirtilen paketi zaten aynı adda bir paket imzalanmış görünür. |
/R [emark] text |
Bir açıklama için komut satırını ekler.Açıklama bağımsız değişkeni isteğe bağlıdır.Açıklama metin boşluk içeriyorsa, metni tırnak içine alınmalıdır.Birden çok REM seçeneği, bir komut satırına ekleyebilirsiniz. |
/Si [gn] {}SQL | File | DTS}; path; hash |
Işaretler bir SSIS paket. Bu eylem, noktalı virgüllerle ayrılmış üç gerekli bağımsız kullanır:
Daha fazla bilgi için bkz:Sayısal imzaları paketleriyle kullanma. .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 [arolayı] password |
Kullanılan parolayı belirtir SQL ve SOURCEUSER seçenekleri alınmasını sağlayan bir SSIS bir veritabanında depolanır paketini bir SQL Server kullanan örnek SQL Server Kimlik doğrulaması. Belirtmek için bir hatadır SOURCEPASSWORD Komut satırında içerir SOURCEUSER seçeneği. Note:
When possible, use Windows Authentication.
|
/ Kaynakları [unucu] server_instance |
Sunucu ile kullanılacak adı belirtir SQL seçenek alınmasını sağlamak için bir SSIS depolanan paket SQL Server. It is an error to specify SOURCESERVER in a command line that does not include the SIGN SQL, COPYSQL, or MOVESQL option. C SQL Server örnek adı için sunucu adı bir ters eğik çizgi ve örnek adı ekleyerek belirtilebilir. |
/ SourceU [ullanıcı] username |
Kullanılan kullanıcı adını belirtir SOURCESERVER seçenek alınmasını sağlamak için bir SSIS depolanan paket SQL Server kullanma SQL Server Kimlik doğrulaması. Belirtmek için bir hatadır SOURCEUSER Komut satırında içerir SIGN SQL, COPY SQL, veya MOVE SQL seçeneği. Note:
When possible, use Windows Authentication.
|
/sq [l] package_path |
Yerini belirtir bir SSIS paket. Bu seçenek, paket içinde depolandığını gösterir msdb veritabanıdır.The package_path argument specifies the yol and name of the SSIS paket. Klasör adları ters eğik çizgi ile biter. If the SQL option is specified on the same command line as any of the following options, a DTEXEC_DTEXECERROR is returned:
If SOURCEUSERNAME is not included, Windows Authentication is used to access the package.SOURCEPASSWORD is allowed only if SOURCEUSER is present.If SOURCEPASSWORD olan bulunmayan, boş bir parola kullanılır. Important Note:
Do not use a blank password. Use a strong password.
|
dtutil çıkış kodları
dtutil sözdizim hatası algılandığında, yanlış bir bağımsız değişkenler kullanılır veya seçenekleri geçersiz birleşimlerini belirtilen sizi uyarır çıkış kodu olarak ayarlar.Aksi halde, yardımcı programı, değerleri Tablo listeleri için aşağıdaki "işlem tamamlandı" göstereni raporları, dtutil yardımcı programı çıkarken ayarlayabilirsiniz.
Değer |
Açıklama |
|---|---|
0 |
Hizmet programı, başarıyla yürütüldü. |
1 |
Yardımcı programı başarısız oldu. |
4 |
Hizmet programı istenen paket bulunamıyor. |
5 |
Hizmet programı istenen paket yüklenemiyor |
6 |
Yardımcı programı, komut satırı sözdizimi veya anlamsal hata içerdiğinden çözümlenemiyor. |
Remarks
Komut dosyaları veya yeniden yönlendirme ile kullanamazsınız dtutil.
Içindeki komut satırı seçeneklerinin sırası önemli değildir.
Örnekler
Aşağıdaki örnekler, komut satırı'nı normal kullanım senaryoları ayrıntı.
Örnekleri kopyalama
Depolanan bir paket kopyalamak için msdb yerel veritabanında örnek SQL Server Windows kimlik doğrulaması için SSIS paketi mağazaya kullanarak, aşağıdaki sözdizimini kullanın:
dtutil /SQL srcPackage /COPY DTS;destFolder\destPackage
Paket dosya sistemi üzerindeki bir konumdan başka bir konuma kopyalayın ve kopyayı farklı bir ad vermek için aşağıdaki sözdizimini kullanın:
dtutil /FILE c:\myPackages\mypackage.dtsx /COPY FILE;c:\myTestPackages\mynewpackage.dtsx
Bir paket için yerel dosya sisteminde kopyalamak için bir örnek, SQL Server başka bir bilgisayarda barındırılan, aşağıdaki sözdizimini kullanın:
dtutil /FILE c:\sourcepkg.dtsx /DestServer <servername> /COPY SQL;destpkgname
Çünkü /DestU[ser] ve /DestP[assword] seçenekleri kullanılmadı, Windows kimlik doğrulaması kabul edilir.
Bunu kopyalandıktan sonra bir paket için yeni bir KIMLIK oluşturmak için aşağıdaki sözdizimini kullanın:
dtutil /I /FILE copiedpkg.dtsx
Belirli bir klasördeki tüm paketleri için yeni bir KIMLIK oluşturmak için aşağıdaki sözdizimini kullanın:
for %%f in (C:\test\SSISPackages\*.dtsx) do dtutil.exe /I /FILE %%f
Tek bir yüzde işareti (%) komutu komut istemi istemine yazın.Komutu bir toplu iş dosyası içinde kullanılırsa, çift yüzde işaretiyle (%) kullanın.
Örnekleri silme
Depolanan bir paket silmek için msdb veritabanında bir örnek SQL Server Windows kimlik doğrulaması kullanan, aşağıdaki sözdizimini kullanın:
dtutil /SQL delPackage /DELETE
Depolanan bir paket silmek için msdb veritabanında bir örnek SQL Server kullanan SQL Server kimlik doğrulaması için aşağıdaki sözdizimini kullanın:
dtutil /SQL delPackage /SOURCEUSER srcUserName /SOURCEPASSWORD #8nGs*w7F /DELETE
Not
Paket, adlandırılmış bir sunucudan silmek için , dahil SOURCESERVER seçenek ve bağımsız. Yalnızca bir sunucu kullanarak belirtebileceğiniz SQL seçeneği.
SSIS paketi depoda depolanan bir paket silmek için aşağıdaki sözdizimini kullanın:
dtutil /DTS delPackage.dtsx /DELETE
Dosya sisteminde depolanan bir paket silmek için aşağıdaki sözdizimini kullanın:
dtutil /FILE c:\delPackage.dtsx /DELETE
Örnekleri var
Bir paket içinde olup olmadığını belirlemek için msdb yerel veritabanında örnek SQL Server Windows kimlik doğrulaması kullanan, aşağıdaki sözdizimini kullanın:
dtutil /SQL srcPackage /EXISTS
Bir paket içinde olup olmadığını belirlemek için msdb yerel bir kopyasını veritabanındaSQL Server kullanan SQL Server kimlik doğrulaması için aşağıdaki sözdizimini kullanın:
dtutil SQL srcPackage /SOURCEUSER srcUserName /SOURCEPASSWORD *hY$d56b /EXISTS
Not
Paket, adlandırılmış bir sunucudaki var olup olmadığını belirlemek için , dahil SOURCESERVER seçenek ve bağımsız. Yalnızca SQL seçeneğini kullanarak, bir sunucu belirtebilirsiniz.
Paket, paket depoda olup olmadığını belirlemek için , aşağıdaki sözdizimini kullanın:
dtutil /DTS srcPackage.dtsx /EXISTS
Paket, yerel dosya sisteminde olup olmadığını belirlemek için , aşağıdaki sözdizimini kullanın:
dtutil /FILE c:\srcPackage.dtsx /EXISTS
Örnekleri taşıma
Bir paket içinde SSIS paketi deposuna depolanan taşımak için msdb yerel veritabanında örnek SQL Server Windows kimlik doğrulaması kullanan, aşağıdaki sözdizimini kullanın:
dtutil /DTS srcPackage.dtsx /MOVE SQL;destPackage
Depolanan bir paket taşımak için msdb yerel veritabanında örnek SQL Server kullanan SQL Server kimlik doğrulaması için msdb veritabanı başka bir yerel örnek SQL Server kullanan SQL Server kimlik doğrulaması için aşağıdaki sözdizimini kullanın:
dtutil /SQL srcPackage /SOURCEUSER srcUserName /SOURCEPASSWORD $Hj45jhd@X /MOVE SQL;destPackage /DESTUSER destUserName /DESTPASSWORD !38dsFH@v
Not
Paket adlandırılmış bir sunucudan diğerine taşımak için SOURCES ve DESTS seçenek ve bunların bağımsız değişkenleri. Yalnızca kullanarak sunucuları belirtebilirsiniz SQL seçeneği.
SSIS paketi depoda depolanan bir paket taşımak için aşağıdaki sözdizimini kullanın:
dtutil /DTS srcPackage.dtsx /MOVE DTS;destPackage.dtsx
Dosya sisteminde depolanan bir paket taşımak için aşağıdaki sözdizimini kullanın:
dtutil /FILE c:\srcPackage.dtsx /MOVE FILE;c:\destPackage.dtsx
Oturum örnekleri
Depolanan bir paket imzalamak için bir SQL Server veritabanını yerel bir kopyası SQL Server Windows kimlik doğrulaması kullanan, aşağıdaki sözdizimini kullanın:
dtutil /FILE srcPackage.dtsx /SIGN FILE;destpkg.dtsx;1767832648918a9d989fdac9819873a91f919
sertifika hakkında bilgi bulmak için kullanın. CertMgr.Karma kodu görüntülenebilir CertMgr Sertifika seçtikten sonra tıklatarak yardımcı programıGörünümü özelliklerini görüntülemek için.The Details tab provides more information about the sertifika.The Thumbprint özellik is used as the hash value, with spaces removed.
Not
Bu örnekte kullanılan karma gerçek bir karma değeri değil.
Daha fazla bilgi için CertMgr bölümüne bakın... Imzalama ve Authenticode koduyla denetimi.
Örnekleri şifrele
Aşağıdaki örnek, dosya tabanlı PackageToEncrypt.dtsx'için dosya tabanlı EncryptedPackage.dts parolayla tam paket şifreleme kullanarak şifreler.Şifreleme için kullanılan parola EncPswd.
dtutil /FILE PackageToEncrypt.dtsx /ENCRYPT file;EncryptedPackage.dtsx;3;EncPswd