utilità dtutildtutil Utility

L'utilità del prompt dei comandi dtutil viene usata per gestire i pacchetti di SQL ServerSQL Server Integration ServicesIntegration Services .The dtutil command prompt utility is used to manage SQL ServerSQL Server Integration ServicesIntegration Services packages. Utilizzare questa utility per copiare, spostare, eliminare un pacchetto oppure per verificarne l'esistenza.The utility can copy, move, delete, or verify the existence of a package. È possibile eseguire queste azioni in qualsiasi pacchetto di SSISSSIS archiviato in un database MicrosoftMicrosoft SQL ServerSQL Server , nell'archivio pacchetti SSISSSIS e nel file system.These actions can be performed on any SSISSSIS package that is stored in one of three locations: a MicrosoftMicrosoft SQL ServerSQL Server database, the SSISSSIS Package Store, and the file system. Se l'utilità accede a un pacchetto archiviato in msdb, al prompt dei comandi può essere necessario specificare nome utente e password.If the utility accesses a package that is stored in msdb, the command prompt may require a user name and a password. Se l'istanza di SQL ServerSQL Server utilizza l'autenticazione di SQL ServerSQL Server, al prompt dei comandi sarà necessario specificare nome utente e password.If the instance of SQL ServerSQL Server uses SQL ServerSQL Server Authentication, the command prompt requires both a user name and a password. Se non viene specificato il nome utente, dtutil SQL ServerSQL Server tenta di accedere a usando l'autenticazione di Windows.If the user name is missing, dtutil tries to log on to SQL ServerSQL Server using Windows Authentication. Il tipo di archiviazione del pacchetto è definito dalle opzioni /SQL, /FILE e /DTS.The storage type of the package is identified by the /SQL, /FILE, and /DTS options.

L'utilità del prompt dei comandi dtutil non supporta l'uso del reindirizzamento o di file di comando.The dtutil command prompt utility does not support the use of command files or redirection.

L'utilità del prompt dei comandi dtutil include le funzionalità seguenti:The dtutil command prompt utility includes the following features:

  • Inserimento di note nel prompt dei comandi, che consente di ottenere un prompt dei comandi autodocumentato e più semplice da capire.Remarks in the command prompt, which makes the command prompt action self-documenting and easier to understand.

  • Protezione dalla sovrascrittura, che consente di richiedere conferma prima di sovrascrivere un pacchetto esistente durante la copia o lo spostamento dei pacchetti.Overwrite protection, to prompt for a confirmation before overwriting an existing package when you are copying or moving packages.

  • Guida della console, che consente di fornire informazioni sulle opzioni dei comandi di dtutil.Console help, to provide information about the command options for dtutil.

Nota

Numerose operazioni eseguite mediante dtutil possono essere eseguite anche in modo visivo in SQL Server Management StudioSQL Server Management Studio durante la connessione a un'istanza di Integration ServicesIntegration Services.Many of the operations that are performed by dtutil can also be performed visually in SQL Server Management StudioSQL Server Management Studio when you are connected to an instance of Integration ServicesIntegration Services. Per altre informazioni, vedere Gestione dei pacchetti (servizio SSIS).For more information, see Package Management (SSIS Service).

Le opzioni possono essere specificate in base a un ordine qualsiasi.The options can be typed in any order. Il carattere barra verticale ("|") equivale all'operatore OR e viene usato per visualizzare i valori possibili.The pipe ("|") character is the OR operator and is used to show possible values. È necessario usare una delle opzioni delimitate dalla barra verticale OR .You must use one of the options that are delimited by the OR pipe.

Tutte le opzioni devono essere precedute da una barra (/) o un segno meno (-).All options must start with a slash (/) or a minus sign (-). Non includere uno spazio tra la barra o il segno di sottrazione e il testo dell'opzione. In caso contrario, il comando non verrà eseguito.However, do not include a space between the slash or minus sign and the text for the option; otherwise, the command will fail.

Gli argomenti devono essere stringhe racchiuse tra parentesi oppure che non contengono spazi.Arguments must be strings that are either enclosed in quotation marks or contain no white space.

Le virgolette doppie all'interno di stringhe racchiuse tra virgolette rappresentano virgolette singole di escape.Double quotation marks within strings that are enclosed in quotation marks represent escaped single quotation marks.

Le opzioni e gli argomenti, escluse le password, non fanno distinzione tra maiuscole e minuscole.Options and arguments, except for passwords, are not case sensitive.

Considerazioni sull'installazione in computer a 64 bitInstallation Considerations on 64-bit Computers

In un computer a 64 bit con Integration ServicesIntegration Services viene installata una versione a 64 bit dell'utilità dtexec (dtexec.exe) e dell'utilità dtutil (dtutil.exe).On a 64-bit computer, Integration ServicesIntegration Services installs a 64-bit version of the dtexec utility (dtexec.exe) and the dtutil utility (dtutil.exe). Per installare le versioni a 32 bit di questi strumenti di Integration ServicesIntegration Services , è necessario selezionare gli strumenti client o SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) durante l'installazione.To install 32-bit versions of these Integration ServicesIntegration Services tools, you must select either Client Tools or SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) during setup.

Per impostazione predefinita, un computer a 64 bit contenente le versioni a 64 bit e a 32 bit di un'utilità del prompt dei comandi di Integration ServicesIntegration Services installata eseguirà la versione a 32 bit al prompt dei comandi.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. Viene eseguita la versione a 32 bit perché il percorso della directory della versione a 32 bit compare nella variabile di ambiente PATH prima del percorso della directory della versione a 64 bit.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. (In genere, il percorso della directory a 32 bit è <unità >: \Programmi file (x86) \Microsoft SQL Server\130\DTS\Binn, mentre il percorso di directory a 64 bit è <unità >: \Programmi\Microsoft SQL Server\130\DTS\Binn.)(Typically, the 32-bit directory path is <drive>:\Program Files(x86)\Microsoft SQL Server\130\DTS\Binn, while the 64-bit directory path is <drive>:\Program Files\Microsoft SQL Server\130\DTS\Binn.)

Nota

Se si utilizza SQL Server Agent per eseguire l'utilità, verrà automaticamente utilizzata la versione a 64 bit dell'utilità.If you use SQL Server Agent to run the utility, SQL Server Agent automatically uses the 64-bit version of the utility. Per trovare l'eseguibile corretto per l'utilità, SQL Server Agent utilizza il Registro di sistema, non la variabile di ambiente PATH.SQL Server Agent uses the registry, not the PATH environment variable, to locate the correct executable for the utility.

Per assicurarsi di eseguire la versione a 64 bit dell'utilità al prompt dei comandi, è possibile eseguire una delle azioni seguenti:To ensure that you run the 64-bit version of the utility at the command prompt, you can take one of the following actions:

  • Aprire una finestra del prompt dei comandi, passare alla directory che contiene la versione a 64 bit dell'utilità (<unità >: \Programmi\Microsoft SQL Server\130\DTS\Binn), quindi eseguire l'utilità da quel percorso.Open a Command Prompt window, change to the directory that contains the 64-bit version of the utility (<drive>:\Program Files\Microsoft SQL Server\130\DTS\Binn), and then run the utility from that location.

  • Al prompt dei comandi, eseguire l'utilità immettendo il percorso completo (<unità >: \Programmi\Microsoft SQL Server\130\DTS\Binn) alla versione a 64 bit dell'utilità.At the command prompt, run the utility by entering the full path (<drive>:\Program Files\Microsoft SQL Server\130\DTS\Binn) to the 64-bit version of the utility.

  • Modificare in modo definitivo l'ordine dei percorsi nella variabile di ambiente PATH spostando il percorso a 64 bit (<unità >: \Programmi\Microsoft SQL Server\130\DTS\Binn) prima del percorso a 32 bit (<unità >: \ Programma \Microsoft SQL Server\130\DTS\Binn file (x86)) nella variabile.Permanently change the order of the paths in the PATH environment variable by placing the 64-bit path (<drive>:\Program Files\Microsoft SQL Server\130\DTS\Binn) before the 32-bit path (<drive>:\ Program Files(x86)\Microsoft SQL Server\130\DTS\Binn) in the variable.

SintassiSyntax

dtutil /option [value] [/option [value]]...  

ParametriParameters

OpzioneOption DescriptionDescription
/?/? Consente di visualizzare le opzioni del prompt dei comandi.Displays the command prompt options.
/C[opy] location;destinationPathandPackageName/C[opy] location;destinationPathandPackageName Specifica un'operazione di copia su un pacchetto SSISSSIS .Specifies a copy action on an SSISSSIS package. Per usare questo parametro, è prima necessario specificare il percorso del pacchetto tramite l'opzione /FI, /SQo /DT .Use of this parameter requires that you first specify the location of the package using the /FI, /SQ, or /DT option. e quindi indicare la posizione di destinazione e il nome del pacchetto di destinazione.Next, specify the destination location destination package name. L'argomento destinationPathandPackageName specifica la posizione nella quale il pacchetto SSISSSIS viene copiato.The destinationPathandPackageName argument specifies where the SSISSSIS package is copied to. Se il percorso di destinazione è SQL, anche gli argomenti DestUser, DestPassword e DestServer devono essere specificati nel comando.If the destination location is SQL, the DestUser, DestPassword and DestServer arguments must also be specified in the command.

Se l'azione Copy rileva un pacchetto esistente nella destinazione, l'utilità dtutil richiede all'utente di confermare l'eliminazione del pacchetto.When the Copy action encounters an existing package at the destination, dtutil prompts the user to confirm package deletion. La risposta Y comporta la sovrascrittura del pacchetto, mentre la risposta N chiude il programma.The Y reply overwrites the package and the N reply ends the program. Se il comando include l'argomento Quiet , non viene visualizzata alcuna richiesta di conferma e il pacchetto esistente viene sovrascritto.When the command includes the Quiet argument, no prompt appears and any existing package is overwritten.
/Dec[rypt] password/Dec[rypt] password (Facoltativo)(Optional). Consente di impostare la password di decrittografia utilizzata per caricare un pacchetto con password crittografata.Sets the decryption password that is used when you load a package with password encryption.
/Del[ete]/Del[ete] Elimina il pacchetto specificato dall'opzione SQL, DTS o FILE .Deletes the package specified by the SQL, DTS or FILE option. Se l'utilità dtutil non è in grado di eliminare il pacchetto, il programma viene chiuso.If dtutil cannot delete the package, the program ends.
/DestP[assword] password/DestP[assword] password Specifica la password utilizzata dall'opzione SQL per connettersi a un'istanza di SQL ServerSQL Server di destinazione tramite l'autenticazione di SQL ServerSQL Server .Specifies the password that is used with the SQL option to connect to a destination SQL ServerSQL Server instance using SQL ServerSQL Server Authentication. Viene generato un errore se si specifica DESTPASSWORD in una riga di comando che non include l'opzione DTSUSER .An error is generated if DESTPASSWORD is specified in a command line that does not include the DTSUSER option.

Nota: Se possibile, usare l'autenticazione di Windows.When possible, use Windows Authentication..Note: Se possibile, usare l'autenticazione di Windows.When possible, use Windows Authentication..
/DestS[erver] server_instance/DestS[erver] server_instance Specifica il nome del server usato con qualsiasi azione che determina il salvataggio di una destinazione in SQL ServerSQL Server.Specifies the server name that is used with any action that causes a destination to be saved to SQL ServerSQL Server. Questa opzione viene usata per identificare un server non locale o non predefinito durante il salvataggio di un pacchetto SSISSSIS .It is used to identify a non-local or non-default server when saving an SSISSSIS package. Non è corretto specificare DESTSERVER in una riga di comando che non include un'azione associata a SQL ServerSQL Server.It is an error to specify DESTSERVER in a command line that does not have an action associated with SQL ServerSQL Server. Azioni come ad esempio le azioni SIGN SQL, COPY SQLo MOVE SQL sono comandi appropriati che è possibile combinare con questa opzione.Actions such as SIGN SQL, COPY SQL, or MOVE SQL options would be appropriate commands to combine with this option.

Per specificare il nome di un'istanza di SQL ServerSQL Server , è sufficiente aggiungere una barra rovesciata e il nome dell'istanza al nome del server.A SQL ServerSQL Server instance name can be specified by adding a backslash and the instance name to the server name.
/DestU[ser] username/DestU[ser] username Specifica il nome utente usato con le opzioni SIGN SQL, COPY SQLe MOVE SQL per connettersi a un'istanza di SQL ServerSQL Server che usa l'autenticazione di SQL ServerSQL Server .Specifies the user name that is used with the SIGN SQL, COPY SQL, and MOVE SQL options to connect to a SQL ServerSQL Server instance that uses SQL ServerSQL Server Authentication. Non è corretto specificare DESTUSER in una riga di comando che non include l'opzione SIGN SQL, COPY SQLo MOVE SQL .It is an error to specify DESTUSER in a command line that does not include the SIGN SQL, COPY SQL, or MOVE SQL option.
/Dump process ID/Dump process ID (Facoltativo) Causa la sospensione del processo specificato, ovvero l'utilità dtexec o il processo dtsDebugHost.exe e la creazione dei file dump di debug, con estensione mdmp e tmp.(Optional) Causes the specified process, either the dtexec utility or the dtsDebugHost.exe process, to pause and create the debug dump files, .mdmp and .tmp.

Nota: per usare l'opzione /Dump, è necessario disporre dei diritti dell'utente Debug di programmi (SeDebugPrivilege).Note: To use the /Dumpoption, you must be assigned the Debug Programs user right (SeDebugPrivilege).

Per trovare l' ID processo per il processo da sospendere, usare Gestione attività Windows.To find the process ID for the process that you want to pause, use Windows Task Manager.

Per impostazione predefinita, Integration ServicesIntegration Services archivia i file di dump del debug nella cartella <unità >: \Programmi\Microsoft SQL Server\130\Shared\ErrorDumps.By default, Integration ServicesIntegration Services stores the debug dump files in the folder, <drive>:\Program Files\Microsoft SQL Server\130\Shared\ErrorDumps.

Per altre informazioni sull'utilità dtexec e il processo dtsDebugHost.exe , vedere Utilità dtexec e Compilazione, distribuzione e debug di oggetti personalizzati.For more information about the dtexec utility and the dtsDebugHost.exe process, see dtexec Utility and Building, Deploying, and Debugging Custom Objects.

Per ulteriori informazioni sui file di dump del debug, vedere Generating Dump Files for Package Execution.For more information about debug dump files, see Generating Dump Files for Package Execution.

Nota: i file di dump del debug possono contenere informazioni sensibili.Note: Debug dump files may contain sensitive information. Utilizzare un elenco di controllo di accesso (ACL) per limitare l'accesso ai file oppure copiare i file in una cartella con accesso limitato.Use an access control list (ACL) to restrict access to the files, or copy the files to a folder with restricted access.
/DT[S] filespec/DT[S] filespec Specifica che il pacchetto SSISSSIS da utilizzare si trova nell'archivio pacchetti SSISSSIS .Specifies that the SSISSSIS package to be operated on is located in the SSISSSIS Package Store. L'argomento filespec deve includere il percorso della cartella, a partire dalla radice dell'archivio pacchetti SSISSSIS .The filespec argument must include the folder path, starting with the root of the SSISSSIS Package Store. Per impostazione predefinita, i nomi delle cartelle radice nel file di configurazione sono "MSDB" e "File System".By default, the names of the root folders in the configuration file are "MSDB" and "File System." I percorsi che contengono uno spazio devono essere delimitati da virgolette doppie.Paths that contain a space must be delimited by using double quotation marks.

Se si specifica l'opzione DT[S] nella stessa riga di comando di una delle opzioni seguenti, viene restituito un errore DTEXEC_DTEXECERROR:If the DT[S] option is specified on the same command line as any of the following options, a DTEXEC_DTEXECERROR is returned:

FILEFILE

SQLSQL

SOURCEUSERSOURCEUSER

SOURCEPASSWORDSOURCEPASSWORD

SOURCESERVERSOURCESERVER
/En[crypt] {SQL | FILE}; Path;ProtectionLevel[;password]/En[crypt] {SQL | FILE}; Path;ProtectionLevel[;password] (Facoltativo)(Optional). Crittografa il pacchetto caricato in base alla password e al livello di protezione specificati, quindi lo salva nel percorso specificato in Path.Encrypts the loaded package with the specified protection level and password, and saves it to the location specified in Path. L'argomento ProtectionLevel determina se è necessaria una password.The ProtectionLevel determines whether a password is required.

SQL : il percorso è rappresentato dal nome del pacchetto di destinazione.SQL - Path is the destination package name.

FILE : il percorso è rappresentato dal percorso e dal nome file completi del pacchetto.FILE - Path is the fully-qualified path and file name for the package.

DTS : questa opzione non è attualmente supportata.DTS - This option is not supported currently.

Opzioni diProtectionLevel :ProtectionLevel options:

Livello 0: le informazioni riservate vengono eliminate.Level 0: Strips sensitive information.

Livello 1: le informazioni riservate vengono crittografate utilizzando le credenziali utente locali.Level 1: Sensitive information is encrypted by using local user credentials.

Livello 2: le informazioni riservate vengono crittografate utilizzando la password richiesta.Level 2: Sensitive information is encrypted by using the required password.

Livello 3: il pacchetto viene crittografato utilizzando la password richiesta.Level 3: Package is encrypted by using the required password.

Livello 4: il pacchetto viene crittografato utilizzando le credenziali utente locali.Level 4: Package is encrypted by using local user credentials.

Livello 5: il pacchetto usa la crittografia per l'archiviazione di SQL ServerSQL Server .Level 5 Package uses SQL ServerSQL Server storage encryption.
/Ex[ists]/Ex[ists] (Facoltativo)(Optional). Utilizzata per determinare l'eventuale esistenza di un pacchetto.Used to determine whether a package exists. dtutil tenta di individuare il pacchetto specificato dalle opzioni SQL, DTS o FILE .dtutil tries to locate the package specified by either the SQL, DTS or FILE options. Se risulta impossibile individuare il pacchetto specificato, l'utilità dtutil restituisce un errore DTEXEC_DTEXECERROR.If dtutil cannot locate the package specified, a DTEXEC_DTEXECERROR is returned.
/FC[reate] {SQL | DTS};ParentFolderPath;NewFolderName/FC[reate] {SQL | DTS};ParentFolderPath;NewFolderName (Facoltativo)(Optional). Crea una nuova cartella il cui nome è specificato in NewFolderName.Create a new folder that has the name that you specified in NewFolderName. Il percorso della nuova cartella è indicato dall'opzione ParentFolderPath.The location of the new folder is indicated by the ParentFolderPath.
/FDe[lete] {SQL | DTS}[;ParentFolderPath;FolderName]/FDe[lete] {SQL | DTS}[;ParentFolderPath;FolderName] (Facoltativo)(Optional). Elimina la cartella specificata dal nome in SQL ServerSQL Server FolderName SSISSSIS da o.Deletes from SQL ServerSQL Server or SSISSSIS the folder that was specified by the name in FolderName. Il percorso della cartella da eliminare è indicato dall'opzione ParentFolderPath.The location of the folder to delete is indicated by the ParentFolderPath.
/FDi[rectory] {SQL | DTS};FolderPath[;S]/FDi[rectory] {SQL | DTS};FolderPath[;S] (Facoltativo)(Optional). Elenca il contenuto, ovvero cartelle e pacchetti in una cartella di SSISSSIS o SQL ServerSQL Server.Lists the contents, both folders and packages, in a folder on SSISSSIS or SQL ServerSQL Server. Il parametro facoltativo FolderPath specifica la cartella di cui visualizzare il contenuto.The optional FolderPath parameter specifies the folder that you want to view the content of. Il parametro facoltativo S specifica che si intende visualizzare l'elenco del contenuto delle sottocartelle della cartella specificata in FolderPath.The optional S parameter specifies that you want to view a listing of the contents of the subfolders for the folder specified in FolderPath.
/FE[xists ] {SQL | DTS};FolderPath/FE[xists ] {SQL | DTS};FolderPath (Facoltativo)(Optional). Verifica se la cartella specificata esiste in SSISSSIS o SQL ServerSQL Server.Verifies if the specified folder exists on SSISSSIS or SQL ServerSQL Server. Il parametro FolderPath rappresenta il percorso e il nome della cartella da verificare.The FolderPath parameter is the path and name of the folder to verify.
/Fi[le] filespec/Fi[le] filespec Questa opzione specifica che il pacchetto di SSISSSIS da utilizzare si trova nel file system.This option specifies that the SSISSSIS package to be operated on is located in the file system. Il valore di filespec può essere specificato sotto forma di percorso UNC (Universal Naming Convention) o di percorso locale.The filespec value can be provided as either a Universal Naming Convention (UNC) path or local path.

Se si specifica l'opzione File nella stessa riga di comando di una delle opzioni seguenti, viene restituito un errore DTEXEC_DTEXECERROR:If the File option is specified on the same command line as any of the following options, a DTEXEC_DTEXECERROR is returned:

DTSDTS

SQLSQL

SOURCEUSERSOURCEUSER

SOURCEPASSWORDSOURCEPASSWORD

SOURCESERVERSOURCESERVER
/FR[ename] {SQL | DTS} [;ParentFolderPath; OldFolderName;NewFolderName]/FR[ename] {SQL | DTS} [;ParentFolderPath; OldFolderName;NewFolderName] (Facoltativo)(Optional). Rinomina una cartella in SSISSSIS o SQL ServerSQL Server.Renames a folder on the SSISSSIS or SQL ServerSQL Server. L'opzione ParentFolderPath specifica il percorso della cartella da rinominare.The ParentFolderPath is the location of the folder to rename. L'opzione OldFolderName specifica il nome attuale della cartella, mentre NewFolderName specifica il nuovo nome da assegnare alla cartella.The OldFolderName is the current name of the folder, and NewFolderName is the new name to give the folder.
/H[elp] option/H[elp] option Visualizza il testo della Guida dettagliato relativo alle opzioni di dtutil e al loro uso.Displays text extensive help that shows the dtutil options and describes their use. L'argomento è facoltativo.The option argument is optional. Se si specifica l'argomento, il testo della Guida include informazioni dettagliate sull'opzione specificata.If the argument is included, the Help text includes detailed information about the specified option. Nell'esempio seguente vengono visualizzate le informazioni della Guida relative a tutte le opzioni.The following example displays help for all options:

dtutil /H

I due esempi seguenti illustrano come usare l'opzione /H per visualizzare informazioni dettagliate della Guida per un'opzione specifica, ovvero l'opzione /Q [uiet] in questo esempio:The following two examples show how to use the /H option to display extended help for a specific option, the /Q [uiet] option, in this example:

dtutil /Help Quiet

dtutil /H Q
/I[DRegenerate]/I[DRegenerate] Crea un nuovo GUID per il pacchetto e aggiorna la proprietà ID del pacchetto.Creates a new GUID for the package and updates the package ID property. Quando viene copiato un pacchetto, l'ID del pacchetto rimane invariato. I file di log contengono pertanto lo stesso GUID per entrambi i pacchetti.When a package is copied, the package ID remains the same; therefore, the log files contain the same GUID for both packages. Questa azione crea un nuovo GUID per la nuova copia del pacchetto per distinguerlo dall'originale.This action creates a new GUID for the newly-copied package to distinguish it from the original.
/M[ove] {SQL | File | DTS}; pathandname/M[ove] {SQL | File | DTS}; pathandname Specifica un'operazione di spostamento su un pacchetto SSISSSIS.Specifies a move action on an SSISSSIS package. Per usare questo parametro, è prima necessario specificare il percorso del pacchetto tramite l'opzione /FI, /SQo /DT .To use this parameter, first specify the location of the package using the /FI, /SQ, or /DT option. e quindi specificare l'azione Move .Next, specify the Move action. Questa azione richiede due argomenti separati da un punto e virgola:This action requires two arguments, which are separated by a semicolon:

L'argomento relativo alla destinazione può specificare SQL, FILEo DTS.The destination argument can specify SQL, FILE, or DTS. Una destinazione SQL può includere le opzioni DESTUSER, DESTPASSWORDe DESTSERVER .A SQL destination can include the DESTUSER, DESTPASSWORD, and DESTSERVER options.

L'argomento pathandname specifica il percorso del pacchetto: SQL usa il percorso e il nome del pacchetto, FILE usa un percorso UNC o locale, mentre DTS usa un percorso relativo alla radice dell'archivio pacchetti SSISSSIS .The pathandname argument specifies the package location: SQL uses the package path and package name, FILE uses a UNC or local path, and DTS uses a location that is relative to the root of the SSISSSIS Package Store. Se si specifica FILE o DTScome destinazione, l'argomento relativo al percorso non include il nome file,When the destination is FILE or DTS, the path argument does not include the file name. ma utilizza come nome file il nome del pacchetto nella posizione specificata.Instead, it uses the package name at the specified location as the file name.



Quando l'azione MOVE rileva un pacchetto esistente nella destinazione, dtutil richiede la conferma della sovrascrittura del pacchetto.When the MOVE action encounters an existing package at the destination, dtutil prompts you to confirm that you want to overwrite the package. La risposta Y comporta la sovrascrittura del pacchetto, mentre la risposta N chiude il programma.The Y reply overwrites the package and the N reply ends the program. Se il comando include l'opzione QUIET , non viene visualizzata alcuna richiesta di conferma e il pacchetto esistente viene sovrascritto.When the command includes the QUIET option, no prompt appears and any existing package is overwritten.
/Q[uiet]/Q[uiet] Arresta le richieste di conferma che possono essere visualizzate quando viene eseguito un comando che include l'opzione COPY, MOVEo SIGN .Stops the confirmation prompts that can appear when a command including the COPY, MOVE, or SIGN option is executed. Queste richieste di conferma vengono visualizzate se un pacchetto con lo stesso nome del pacchetto specificato esiste già nel computer di destinazione oppure se il pacchetto specificato è già firmato.These prompts appear if a package with the same name as the specified package already exists at the destination computer or if the specified package is already signed.
/R[emark] text/R[emark] text Aggiunge un commento alla riga di comando.Adds a comment to the command line. L'argomento è facoltativo.The comment argument is optional. Se il testo del commento include spazi, è necessario racchiudere il testo tra virgolette.If the comment text includes spaces, the text must be enclosed in quotation marks. È possibile includere più opzioni REM in una riga di comando.You can include multiple REM options in a command line.
/Si[gn] {SQL | File | DTS}; path; hash/Si[gn] {SQL | File | DTS}; path; hash Firma un pacchetto di SSISSSIS.Signs an SSISSSIS package. Questa azione usa tre argomenti obbligatori separati da un punto e virgola, ovvero destinazione, percorso e hash:This action uses three required arguments, which are separated by semicolons; destination, path, and hash:

L'argomento relativo alla destinazione può specificare SQL, FILEo DTS.The destination argument can specify SQL, FILE, or DTS. Una destinazione SQL può includere le opzioni DESTUSER, DESTPASSWORD e DESTSERVER .A SQL destination can include the DESTUSER, DESTPASSWORD and DESTSERVER options.

L'argomento relativo al percorso specifica la posizione del pacchetto su cui eseguire l'azione.The path argument specifies the location of the package to take action on.

L'argomento hash specifica un identificatore di certificato espresso come stringa esadecimale di lunghezza variabile.The hash argument specifies a certificate identifier expressed as a hexadecimal string of varying length.

Per altre informazioni, vedere Identificazione dell'origine dei pacchetti con firme digitali.For more information, see Identify the Source of Packages with Digital Signatures.



** Importante *\* Se è configurato per la verifica della firma del pacchetto, Integration ServicesIntegration Services controlla solo la presenza e la validità della firma digitale nonché l'attendibilità della fonte.** Important *\* 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 ServicesNon controlla se il pacchetto è stato modificato. does not check whether the package has been changed.
/SourceP[assword] password/SourceP[assword] password Specifica la password usata con le opzioni SQL e SOURCEUSER per abilitare il recupero di un pacchetto di SSISSSIS archiviato in un database in un'istanza di SQL ServerSQL Server che usa l'autenticazione di SQL ServerSQL Server .Specifies the password that is used with the SQL and SOURCEUSER options to enable the retrieval of an SSISSSIS package that is stored in a database on a SQL ServerSQL Server instance that uses SQL ServerSQL Server Authentication. Non è corretto specificare SOURCEPASSWORD in una riga di comando che non include l'opzione SOURCEUSER .It is an error to specify SOURCEPASSWORD in a command line that does not include the SOURCEUSER option.

Nota: Se possibile, usare l'autenticazione di Windows.When possible, use Windows Authentication.Note: Se possibile, usare l'autenticazione di Windows.When possible, use Windows Authentication.
/SourceS[erver] server_instance/SourceS[erver] server_instance Specifica il nome del server usato con l'opzione SQL per abilitare il recupero di un pacchetto di SSISSSIS archiviato in SQL ServerSQL Server.Specifies the server name that is used with the SQL option to enable the retrieval of an SSISSSIS package that is stored in SQL ServerSQL Server. Non è corretto specificare SOURCESERVER in una riga di comando che non include l'opzione SIGN SQL, COPY SQLo MOVE SQL .It is an error to specify SOURCESERVER in a command line that does not include the SIGN SQL, COPY SQL, or MOVE SQL option.

Per specificare il nome di un'istanza di SQL ServerSQL Server , è sufficiente aggiungere una barra rovesciata e il nome dell'istanza al nome del server.A SQL ServerSQL Server instance name can be specified by adding a backslash and the instance name to the server name.
/SourceU[ser] username/SourceU[ser] username Specifica il nome utente usato con l'opzione SOURCESERVER per abilitare il recupero di un pacchetto di SSISSSIS archiviato in SQL ServerSQL Server con l'autenticazione di SQL ServerSQL Server .Specifies the user name that is used with the SOURCESERVER option to enable the retrieval of an SSISSSIS package stored in SQL ServerSQL Server using SQL ServerSQL Server Authentication. Non è corretto specificare SOURCESERVER in una riga di comando che non include l'opzione SIGN SQL, COPYo MOVE SQL .It is an error to specify SOURCEUSER in a command line that does not include the SIGN SQL, COPY SQL, or MOVE SQL option.

Nota: Se possibile, usare l'autenticazione di Windows.When possible, use Windows Authentication.Note: Se possibile, usare l'autenticazione di Windows.When possible, use Windows Authentication.
/SQ[L] package_path/SQ[L] package_path Specifica la posizione di un pacchetto di SSISSSIS .Specifies the location of an SSISSSIS package. Questa opzione indica che il pacchetto è archiviato nel database msdb .This option indicates that the package is stored in the msdb database. L'argomento package_path specifica il percorso e il nome del pacchetto di SSISSSIS .The package_path argument specifies the path and name of the SSISSSIS package. I nomi delle cartelle terminano con una barra rovesciata.Folder names are terminated with back slashes.

Se si specifica l'opzione SQL nella stessa riga di comando di una delle opzioni seguenti, viene restituito un errore DTEXEC_DTEXECERROR:If the SQL option is specified on the same command line as any of the following options, a DTEXEC_DTEXECERROR is returned:

DTSDTS

FILEFILE

L'opzione SQL può essere accompagnata da zero o da un'istanza delle opzioni seguenti:The SQL option may be accompanied by zero or one instance of the following options:

SOURCEUSERSOURCEUSER

SOURCEPASSWORDSOURCEPASSWORD

SOURCESERVERSOURCESERVER



Se l'opzione SOURCEUSERNAME non è inclusa, per accedere al pacchetto verrà usa l'autenticazione di Windows.If SOURCEUSERNAME is not included, Windows Authentication is used to access the package. SOURCEPASSWORD è consentita solo se è presente SOURCEUSER .SOURCEPASSWORD is allowed only if SOURCEUSER is present. Se si omette l'opzione SOURCEPASSWORD , viene usata una password vuota.If SOURCEPASSWORD is not included, a blank password is used.

** Importante *\* Non usare una password vuota.Do not use a blank password. Usare una password complessa.Use a strong password.** Important *\* Non usare una password vuota.Do not use a blank password. Usare una password complessa.Use a strong password.

Codici di uscita di dtutildtutil Exit Codes

dtutil imposta un codice di uscita di avviso nel caso in cui vengano rilevati errori di sintassi, siano stati usati argomenti non corretti o siano state specificate combinazioni di opzioni non valide.dtutil sets an exit code that alerts you when syntax errors are detected, incorrect arguments are used, or invalid combinations of options are specified. In caso contrario, l'utilità visualizza il messaggio "Operazione completata". Nella tabella seguente sono elencati i valori impostati dall'utilità dtutil all'uscita.Otherwise, the utility reports "The operation completed successfully".The following table lists the values that the dtutil utility can set when exiting.

ValoreValue DescrizioneDescription
00 L'esecuzione dell'utilità ha avuto esito positivo.The utility executed successfully.
11 L'esecuzione dell'utilità ha avuto esito negativo.The utility failed.
44 L'utilità non è in grado di individuare il pacchetto richiesto.The utility cannot locate the requested package.
55 L'utilità non è in grado di caricare il pacchetto richiesto.The utility cannot load the requested package
66 L'utilità non è in grado di risolvere la riga di comando perché contiene errori sintattici o semantici.The utility cannot resolve the command line because it contains either syntactic or semantic errors.

OsservazioniRemarks

Non è possibile usare file di comando o reindirizzamenti con dtutil.You cannot use command files or redirection with dtutil.

L'ordine delle opzioni all'interno della riga di comando non è significativo.The order of the options within the command line is not significant.

EsempiExamples

Negli esempi seguenti vengono illustrati in dettaglio alcuni scenari tipici di utilizzo della riga di comando.The following examples detail typical command line usage scenarios.

Esempi di copiaCopy Examples

Per copiare nell'archivio pacchetti SSIS un pacchetto archiviato nel database msdb in un'istanza locale di SQL ServerSQL Server tramite l'autenticazione di Windows, usare la sintassi seguente:To copy a package that is stored in the msdb database on a local instance of SQL ServerSQL Server using Windows Authentication to the SSIS Package Store, use the following syntax:

dtutil /SQL srcPackage /COPY DTS;destFolder\destPackage   

Per copiare in una posizione diversa un pacchetto da una posizione qualsiasi del file system e assegnare alla copia un nome diverso, utilizzare la sintassi seguente:To copy a package from a location on the File system to another location and give the copy a different name, use the following syntax:

dtutil /FILE c:\myPackages\mypackage.dtsx /COPY FILE;c:\myTestPackages\mynewpackage.dtsx  

Per copiare un pacchetto nel file system locale in un'istanza di SQL ServerSQL Server ospitata in un altro computer, usare la sintassi seguente:To copy a package on the local file system to an instance of SQL ServerSQL Server hosted on another computer, use the following syntax:

dtutil /FILE c:\sourcepkg.dtsx /DestServer <servername> /COPY SQL;destpkgname  

Poiché non sono state usate le opzioni /DestU[ser] e /DestP[assword] , verrà usata l'autenticazione di Windows.Because the /DestU[ser] and /DestP[assword] options were not used, Windows Authentication is assumed.

Per creare un nuovo ID per un pacchetto dopo averlo copiato, utilizzare la sintassi seguente:To create a new ID for a package after it is copied, use the following syntax:

dtutil /I /FILE copiedpkg.dtsx   

Per creare un nuovo ID per tutti i pacchetti presenti in una cartella specifica, utilizzare la sintassi seguente:To create a new ID for all the packages in a specific folder, use the following syntax:

for %%f in (C:\test\SSISPackages\*.dtsx) do dtutil.exe /I /FILE %%f  

Utilizzare un simbolo di percentuale singolo (%) quando si digita il comando al prompt dei comandi.Use a single percent sign (%) when typing the command at the command prompt. Utilizzare un simbolo di percentuale doppio (%%) se si utilizza il comando in un file batch.Use a double percent sign (%%) if the command is used inside a batch file.

Esempi di eliminazioneDelete Examples

Per eliminare un pacchetto archiviato nel database msdb in un'istanza di SQL ServerSQL Server che usa l'autenticazione di Windows, usare la sintassi seguente:To delete a package that is stored in the msdb database on an instance of SQL ServerSQL Server that uses Windows Authentication, use the following syntax:

dtutil /SQL delPackage /DELETE  

Per eliminare un pacchetto archiviato nel database msdb in un'istanza di SQL ServerSQL Server che usa l'autenticazione di SQL ServerSQL Server , usare la sintassi seguente:To delete a package that is stored in the msdb database on an instance of SQL ServerSQL Server that uses SQL ServerSQL Server Authentication, use the following syntax:

dtutil /SQL delPackage /SOURCEUSER srcUserName /SOURCEPASSWORD #8nGs*w7F /DELETE  
Nota

Per eliminare un pacchetto da un server specificato, includere l'opzione SOURCESERVER e il relativo argomento.To delete a package from a named server, include the SOURCESERVER option and its argument. Un server può essere specificato solo usando l'opzione SQL .You can only specify a server by using the SQL option.

Per eliminare un pacchetto archiviato nell'archivio pacchetti SSIS, utilizzare la sintassi seguente:To delete a package that is stored in the SSIS Package Store, use the following syntax:

dtutil /DTS delPackage.dtsx /DELETE  

Per eliminare un pacchetto archiviato nel file system, utilizzare la sintassi seguente:To delete a package that is stored in the file system, use the following syntax:

dtutil /FILE c:\delPackage.dtsx /DELETE  

Esempi di verifica dell'esistenzaExists Examples

Per determinare se un pacchetto esiste nel database msdb in un'istanza locale di SQL ServerSQL Server che usa l'autenticazione di Windows, usare la sintassi seguente:To determine whether a package exists in the msdb database on a local instance of SQL ServerSQL Server that uses Windows Authentication, use the following syntax:

dtutil /SQL srcPackage /EXISTS  

Per determinare se un pacchetto esiste nel database msdb in un'istanza locale di SQL ServerSQL Server che usa l'autenticazione di SQL ServerSQL Server , usare la sintassi seguente:To determine whether a package exists in the msdb database on a local instance of SQL ServerSQL Server that uses SQL ServerSQL Server Authentication, use the following syntax:

dtutil SQL srcPackage /SOURCEUSER srcUserName /SOURCEPASSWORD *hY$d56b /EXISTS  
Nota

Per determinare se un pacchetto esiste in un server specificato, includere l'opzione SOURCESERVER e il relativo argomento.To determine whether a package exists on a named server, include the SOURCESERVER option and its argument. Un server può essere specificato solo utilizzando l'opzione SQL.You can only specify a server by using the SQL option.

Per determinare se un pacchetto esiste nell'archivio pacchetti locale, utilizzare la sintassi seguente:To determine whether a package exists in the local package store, use the following syntax:

dtutil /DTS srcPackage.dtsx /EXISTS  

Per determinare se un pacchetto esiste nel file system locale, utilizzare la sintassi seguente:To determine whether a package exists in the local file system, use the following syntax:

dtutil /FILE c:\srcPackage.dtsx /EXISTS  

Esempi di spostamentoMove Examples

Per spostare un pacchetto archiviato nell'archivio pacchetti SSIS nel database msdb in un'istanza locale di SQL ServerSQL Server che usa l'autenticazione di Windows, usare la sintassi seguente:To move a package that is stored in the SSIS Package Store to the msdb database on a local instance of SQL ServerSQL Server that uses Windows Authentication, use the following syntax:

dtutil /DTS srcPackage.dtsx /MOVE SQL;destPackage  

Per spostare un pacchetto archiviato nel database msdb in un'istanza locale di SQL ServerSQL Server che usa l'autenticazione di SQL ServerSQL Server nel database msdb in un'istanza locale diversa di SQL ServerSQL Server che usa l'autenticazione di SQL ServerSQL Server , usare la sintassi seguente:To move a package that is stored in the msdb database on a local instance of SQL ServerSQL Server that uses SQL ServerSQL Server Authentication to the msdb database on another local instance of SQL ServerSQL Server that uses SQL ServerSQL Server Authentication, use the following syntax:

dtutil /SQL srcPackage /SOURCEUSER srcUserName /SOURCEPASSWORD $Hj45jhd@X /MOVE SQL;destPackage /DESTUSER destUserName /DESTPASSWORD !38dsFH@v  
Nota

Per spostare un pacchetto da un server specificato a un altro, includere le opzioni SOURCES e DESTS insieme ai relativi argomenti.To move a package from one named server to another, include the SOURCES and the DESTS option and their arguments. Un server può essere specificato solo usando l'opzione SQL .You can only specify servers by using the SQL option.

Per spostare un pacchetto archiviato nell'archivio pacchetti SSIS, utilizzare la sintassi seguente:To move a package that is stored in the SSIS Package Store, use the following syntax:

dtutil /DTS srcPackage.dtsx /MOVE DTS;destPackage.dtsx  

Per spostare un pacchetto archiviato nel file system, utilizzare la sintassi seguente:To move a package that is stored in the file system, use the following syntax:

dtutil /FILE c:\srcPackage.dtsx /MOVE FILE;c:\destPackage.dtsx  

Esempi di firmaSign Examples

Per firmare un pacchetto archiviato in un database di SQL ServerSQL Server in un'istanza locale di SQL ServerSQL Server che utilizza l'autenticazione di Windows, utilizzare la sintassi seguente:To sign a package that is stored in a SQL ServerSQL Server database on a local instance of SQL ServerSQL Server that uses Windows Authentication, use the following syntax:

dtutil /FILE srcPackage.dtsx /SIGN FILE;destpkg.dtsx;1767832648918a9d989fdac9819873a91f919  

Per individuare le informazioni sul certificato, usare CertMgr.To locate information about your certificate, use CertMgr. Per visualizzare il codice hash nell'utilità CertMgr , selezionare il certificato e fare clic su Visualizza per visualizzare le proprietà.The hash code can be viewed in the CertMgr utility by selecting the certificate, and then clicking View to view the properties. Nella scheda Dettagli sono disponibili altre informazioni sul certificato.The Details tab provides more information about the certificate. La proprietà Thumbprint viene usata come valore hash, rimuovendo gli spazi.The Thumbprint property is used as the hash value, with spaces removed.

Nota

L'hash utilizzato in questo esempio non è un hash reale.The hash used in this example is not a real hash.

Per altre informazioni, vedere la sezione relativa a CertMgr in Firma e controllo del codice con Authenticode.For more information, see the CertMgr section in Signing and Checking Code with Authenticode.

Esempi di crittografiaEncrypt Examples

Nell'esempio seguente viene eseguita la crittografia del pacchetto PackageToEncrypt.dtsx basato su file nel pacchetto EncryptedPackage.dts basato su file utilizzando la crittografia completa dei pacchetti e una password.The following sample encrypts the file-based PackageToEncrypt.dtsx to the file-based EncryptedPackage.dts using full package encryption, with a password. La password usata per la crittografia è EncPswd.The password that is used for the encryption is EncPswd.

dtutil /FILE PackageToEncrypt.dtsx /ENCRYPT file;EncryptedPackage.dtsx;3;EncPswd  

Vedere ancheSee Also

Eseguire pacchetti di Integration Services (SSIS)Run Integration Services (SSIS) Packages