Utilità dtexecdtexec Utility

L'utilità del prompt dei comandi dtexec viene usata per configurare ed eseguire i pacchetti di SQL ServerSQL Server Integration ServicesIntegration Services .The dtexec command prompt utility is used to configure and execute SQL ServerSQL Server Integration ServicesIntegration Services packages. Con l'utilità dtexec è possibile accedere a tutte le funzionalità di configurazione ed esecuzione dei pacchetti, ad esempio parametri, connessioni, proprietà, variabili, registrazione e indicatori di stato.The dtexec utility provides access to all the package configuration and execution features, such as parameters, connections, properties, variables, logging, and progress indicators. L'utilità dtexec consente di caricare i pacchetti da queste origini: server Integration ServicesIntegration Services , file di progetto con estensione ispac, database di MicrosoftMicrosoft SQL ServerSQL Server , archivio pacchetti SSISSSIS e file system.The dtexec utility lets you load packages from these sources: the Integration ServicesIntegration Services server, an .ispac project file, a MicrosoftMicrosoft SQL ServerSQL Server database, the SSISSSIS Package Store, and the file system.

NOTA: quando si usa la versione corrente dell'utilità dtexec per eseguire un pacchetto creato tramite una versione precedente di Integration ServicesIntegration Services, l'utilità aggiorna temporaneamente il pacchetto al formato di pacchetto corrente.NOTE: When you use the current version of the dtexec utility to run a package created by an earlier version of Integration ServicesIntegration Services, the utility temporarily upgrades the package to the current package format. Tuttavia, non è possibile usare l'utilità dtexec per salvare il pacchetto aggiornato.However, you cannot use the dtexec utility to save the upgraded package. Per altre informazioni su come rendere permanente l'aggiornamento di un pacchetto alla versione corrente, vedere Upgrade Integration Services Packages.For more information about how to permanently upgrade a package to the current version, see Upgrade Integration Services Packages.

In questo argomento sono contenute le sezioni seguenti:This topic includes the following sections:

Server Integration Services e file di progetto Integration Services Server and Project File

Quando si usa dtexec per eseguire pacchetti nel server Integration ServicesIntegration Services, dtexec chiama le stored procedure catalog.create_execution (SSISDB Database), catalog.set_execution_parameter_value (SSISDB Database) e catalog.start_execution (SSISDB Database) per creare un'esecuzione, impostare i valori dei parametri e avviare l'esecuzione.When you use dtexec to run packages on the Integration ServicesIntegration Services server, dtexec calls the catalog.create_execution (SSISDB Database), catalog.set_execution_parameter_value (SSISDB Database) and catalog.start_execution (SSISDB Database) stored procedures to create an execution, set parameter values and start the execution. Tutti i log di esecuzione possono essere visualizzati dal server nelle viste correlate o tramite report standard disponibili in SQL Server Management StudioSQL Server Management Studio.All execution logs can be seen from the server in the related views or by using standard reports available in SQL Server Management StudioSQL Server Management Studio. Per altre informazioni sui report, vedere Report per il server Integration Services.For more information about the reports, see Reports for the Integration Services Server.

Di seguito è riportato un esempio relativo all'esecuzione di un pacchetto nel server Integration ServicesIntegration Services .The following is an example of executing a package on the Integration ServicesIntegration Services server.

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

Quando si usa dtexec per eseguire un pacchetto dal file di progetto con estensione ispac, le opzioni correlate sono /Proj[ect] e /Pack[age] utilizzate per specificare il percorso del progetto e il nome di flusso del pacchetto.When you use dtexec to run a package from the .ispac project file, the related options are: /Proj[ect] and /Pack[age] that are used to specify the project path and package stream name. Quando si converte un progetto nel modello di distribuzione del progetto eseguendo la Conversione guidata progetto di Integration Services da SQL Server Management StudioSQL Server Management Studio, tramite la procedura guidata viene generato un file di progetto con estensione ispac.When you convert a project to the project deployment model by running the Integration Services Project Conversion Wizard from SQL Server Management StudioSQL Server Management Studio, the wizard generates an .ispac projec file. Per ulteriori informazioni, vedere distribuire Integration Services (SSIS) progetti e pacchetti.For more information, see Deploy Integration Services (SSIS) Projects and Packages.

È possibile usare dtexec con gli strumenti di pianificazione di terze parti per pianificare i pacchetti distribuiti nel server Integration ServicesIntegration Services .You can use dtexec with third-party scheduling tools to schedule packages that are deployed to the Integration ServicesIntegration Services server.

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

In un computer a 64 bit, Integration ServicesIntegration Services installa una versione a 64 bit dell'utilità dtexec (dtexec.exe).On a 64-bit computer, Integration ServicesIntegration Services installs a 64-bit version of the dtexec utility (dtexec.exe). Se è necessario eseguire alcuni pacchetti nella modalità a 32 bit, installare la versione a 32 bit dell'utilità dtexec .If you have to run certain packages in 32-bit mode, you will have to install the 32-bit version of the dtexec utility. Per installare la versione a 32 bit dell'utilità dtexec , è necessario selezionare gli strumenti client o SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) durante l'installazione.To install the 32-bit version of the dtexec utility, you must select either Client Tools or SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) during setup.

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\110\DTS\Binn, mentre il percorso di directory a 64 bit è <unità >: \Programmi\Microsoft SQL Server\110\DTS\Binn.)(Typically, the 32-bit directory path is <drive>:\Program Files(x86)\Microsoft SQL Server\110\DTS\Binn, while the 64-bit directory path is <drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn.)

NOTA: se si usa SQL Server Agent per eseguire l'utilità, SQL Server Agent usa automaticamente la versione a 64 bit dell'utilità.NOTE: 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\110\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\110\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\110\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\110\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\110\DTS\Binn) prima del percorso a 32 bit (<unità >: \ Programma \Microsoft SQL Server\110\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\110\DTS\Binn) before the 32-bit path (<drive>:\ Program Files(x86)\Microsoft SQL Server\110\DTS\Binn) in the variable.

Considerazioni sui computer con installazioni side-by-side Considerations on Computers with Side-by-Side Installations

Se SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) è installato in un computer con SQL Server 2005 Integration Services (SSIS)SQL Server 2005 Integration Services (SSIS) o SQL Server 2008 Integration Services (SSIS)SQL Server 2008 Integration Services (SSIS) , vengono installate più versioni dell'utilità dtexec .When SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) is installed on a machine that has SQL Server 2005 Integration Services (SSIS)SQL Server 2005 Integration Services (SSIS) or SQL Server 2008 Integration Services (SSIS)SQL Server 2008 Integration Services (SSIS) installed, multiple versions of the dtexec utility are installed.

Per assicurarsi di eseguire la versione corretta dell'utilità, al prompt dei comandi eseguire l'utilità immettendo il percorso completo (<unità >: \Programmi\Microsoft SQL Server\< versione>\DTS\Binn).To ensure that you run the correct version of the utility, at the command prompt run the utility by entering the full path (<drive>:\Program Files\Microsoft SQL Server\<version>\DTS\Binn).

Fasi di esecuzione Phases of Execution

L'esecuzione di questa utilità si articola nelle quattro fasiThe utility has four phases that it proceeds through as it executes. descritte di seguito.The phases are as follows:

  1. Determinazione dell'origine del comando: il prompt dei comandi legge l'elenco delle opzioni e degli argomenti specificati.Command sourcing phase: The command prompt reads the list of options and arguments that have been specified. Tutte le fasi successive vengono ignorate se viene rilevata un'opzione /?All subsequent phases are skipped if a /? o /HELP .or /HELP option is encountered.

  2. Caricamento dei pacchetti: viene caricato il pacchetto specificato dall'opzione /SQL, /FILEo /DTS .Package load phase: The package specified by the /SQL, /FILE, or /DTS option is loaded.

  3. Configurazione: le opzioni vengono elaborate nell'ordine riportato di seguito.Configuration phase: Options are processed in this order:

    • Opzioni che impostano i flag, le variabili e le proprietà dei pacchetti.Options that set package flags, variables, and properties.

    • Opzioni che verificano la versione e la build del pacchetto.Options that verify the package version and build.

    • Opzioni che configurano il comportamento dell'utilità in fase di esecuzione, ad esempio la creazione di report.Options that configure the run-time behavior of the utility, such as reporting.

  4. Convalida ed esecuzione: il pacchetto viene eseguito oppure convalidato ma non eseguito se è stata specificata l'opzione /VALIDATE .Validation and execution phase: The package is run, or validated without running if the /VALIDATE option was specified.

Codici di uscita restituiti Exit Codes Returned

Codici di uscita restituiti dall'utilità dtexecExit codes returned from dtexec utility

Durante l'esecuzione di un pacchetto è possibile che dtexec restituisca un codice di uscita.When a package runs, dtexec can return an exit code. Il codice di uscita viene utilizzato per popolare la variabile ERRORLEVEL, il cui valore può essere testato nelle istruzioni condizionali o nella logica di diramazione in un file batch.The exit code is used to populate the ERRORLEVEL variable, the value of which can then be tested in conditional statements or branching logic within a batch file. Nella tabella seguente vengono elencati i valori che l'utilità dtexec può impostare all'uscita.The following table lists the values that the dtexec utility can set when exiting.

ValoreValue DescrizioneDescription
00 Il pacchetto è stato eseguito correttamente.The package executed successfully.
11 Il pacchetto non è stato eseguito.The package failed.
33 L'esecuzione del pacchetto è stata annullata dall'utente.The package was canceled by the user.
44 L'utilità non è stata in grado di individuare il pacchetto richiesto.The utility was unable to locate the requested package. Risulta impossibile trovare il pacchetto.The package could not be found.
55 L'utilità non è stata in grado di caricare il pacchetto richiesto.The utility was unable to load the requested package. Risulta impossibile caricare il pacchetto.The package could not be loaded.
66 L'utilità ha rilevato un errore interno oppure un errore sintattico o semantico nella riga di comando.The utility encountered an internal error of syntactic or semantic errors in the command line.

Regole della sintassi Syntax Rules

Regole di sintassi dell'utilitàUtility syntax rules

Tutte le opzioni devono essere precedute da una barra (/) o un segno meno (-).All options must start with a slash (/) or a minus sign (-). Le opzioni riportate di seguito sono precedute da una barra (/), che può tuttavia essere sostituita dal segno meno (-).The options that are shown here start with a slash (/), but the minus sign (-) can be substituted.

Se l'argomento contiene uno spazio, deve essere racchiuso tra virgolette.An argument must be enclosed in quotation marks if it contains a space. Se non è racchiuso tra virgolette, un argomento non può contenere spazi vuoti.If the argument is not enclosed in quotation marks, the argument cannot contain white space.

Le virgolette doppie all'interno di stringhe racchiuse tra virgolette rappresentano virgolette singole di escape.Doubled quotation marks within quoted strings represent escaped single quotation marks.

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

Utilizzo di dtexec da xp_cmdshell Using dtexec from the xp_cmdshell

Utilizzo di dtexec da xp_cmdshellUsing dtexec from the xp_cmdshell

È possibile eseguire dtexec dal prompt di xp_cmdshell .You can run dtexec from the xp_cmdshell prompt. Nell'esempio seguente viene illustrato come eseguire un pacchetto denominato UpsertData.dtsx e ignorare il codice restituito:The following example shows how to run a package called UpsertData.dtsx and ignore the return code:

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

Nell'esempio seguente viene illustrato come eseguire lo stesso pacchetto e acquisire il codice restituito:The following example shows how to run the same package and capture the return code:

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

IMPORTANTEIMPORTANT!! Nelle nuove installazioni, in MicrosoftMicrosoft SQL ServerSQL Serverl'opzione xp_cmdshell risulta disabilitata per impostazione predefinita.In MicrosoftMicrosoft SQL ServerSQL Server, the xp_cmdshell option is disabled by default on new installations. L'opzione può essere abilitata eseguendo la stored procedure di sistema sp_configure .The option can be enabled by running the sp_configure system stored procedure. Per altre informazioni, vedere Opzione di configurazione del server xp_cmdshell.For more information, see xp_cmdshell Server Configuration Option.

Sintassi Syntax

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

Parametri Parameters

  • /?/? [option_name]: (facoltativo).[option_name]: (Optional). Consente di visualizzare le opzioni del prompt dei comandi o le informazioni della Guida relative all'opzione option_name specificata e quindi di chiudere l'utilità.Displays the command prompt options, or displays help for the specified option_name and then closes the utility.

    Se si specifica un argomento option_name , dtexec avvia la documentazione online di SQL ServerSQL Server e visualizza l'argomento relativo all'utilità dtexec.If you specify an option_name argument, dtexec starts SQL ServerSQL Server Books Online and displays the dtexec Utility topic.

  • /Ca[llerInfo]: (facoltativo)./Ca[llerInfo]: (Optional). Specifica informazioni aggiuntive per l'esecuzione di un pacchetto.Specifies additional information for a package execution. Quando si esegue un pacchetto utilizzando SQL Server Agent, tramite l'agente è possibile impostare questo argomento per specificare che l'esecuzione del pacchetto venga richiamata da SQL Server Agent.When you run a package using SQL Server Agent, agent sets this argument to indicate that the package execution is invoked by SQL Server Agent. Questo parametro viene ignorato quando l'utilità dtexec viene eseguita dalla riga di comando.This parameter is ignored when the dtexec utility is run from the command line.

  • /CheckF[ile] filespec: (facoltativo)./CheckF[ile] filespec: (Optional). Imposta la proprietà CheckpointFileName del pacchetto sul percorso e sul file specificati in filespec.Sets the CheckpointFileName property on the package to the path and file spemandcified in filespec. Questo file viene utilizzato quando il pacchetto viene riavviato.This file is used when the package restarts. Se si specifica questa opzione ma si omette il valore del nome file, la proprietà CheckpointFileName del pacchetto viene impostata su una stringa vuota.If this option is specified and no value is supplied for the file name, the CheckpointFileName for the package is set to an empty string. Se si omette questa opzione, i valori nel pacchetto vengono conservati.If this option is not specified, the values in the package are retained.

  • /CheckP[ointing] {on\off} : (facoltativo)./CheckP[ointing] {on\off} : (Optional). Consente di impostare un valore che determina se il pacchetto utilizzerà i checkpoint durante l'esecuzione.Sets a value that determines whether the package will use checkpoints during package execution. Il valore on indica che un pacchetto la cui esecuzione ha avuto esito negativo deve essere rieseguito.The value on specifies that a failed package is to be rerun. In questo caso, il motore di run-time utilizza il file del checkpoint per riavviare il pacchetto dal punto in cui si è verificato l'errore.When the failed package is rerun, the run-time engine uses the checkpoint file to restart the package from the point of failure.

    Il valore predefinito è on se l'opzione viene dichiarata senza un valore.The default value is on if the option is declared without a value. L'esecuzione del pacchetto avrà esito negativo se il valore viene impostato su on, ma non risulta possibile trovare il file del checkpoint.Package execution will fail if the value is set to on and the checkpoint file cannot be found. Se si omette questa opzione, il valore impostato nel pacchetto viene conservato.If this option is not specified, the value set in the package is retained. Per ulteriori informazioni, vedere Restart Packages by Using Checkpoints.For more information, see Restart Packages by Using Checkpoints.

    L'opzione /CheckPointing on di dtexec equivale a impostare la proprietà SaveCheckpoints del pacchetto su True e la proprietà CheckpointUsage su Always.The /CheckPointing on option of dtexec is equivalent to setting the SaveCheckpoints property of the package to True, and the CheckpointUsage property to Always.

  • /Com[mandFile] filespec: (facoltativo)./Com[mandFile] filespec: (Optional). Specifica le opzioni di comando eseguite con dtexec.Specifies the command options that run with dtexec. Il file specificato in filespec viene aperto e le relative opzioni vengono lette finché non viene rilevata la fine del file.The file specified in filespec is opened and options from the file are read until EOF is found in the file. filespec è un file di testo.filespec is a text file. L'argomento filespec consente di specificare il nome e il percorso del file di comando da associare all'esecuzione del pacchetto.The filespec argument specifies the file name and path of the command file to associate with the execution of the package.

  • /Conf[igFile] filespec: (facoltativo)./Conf[igFile] filespec: (Optional). Consente di specificare un file di configurazione da cui estrarre valori.Specifies a configuration file to extract values from. Se si utilizza questa opzione, è possibile impostare una configurazione della fase di esecuzione diversa rispetto alla configurazione specificata in fase di progettazione per il pacchetto.Using this option, you can set a run-time configuration that differs from the configuration that was specified at design time for the package. È possibile archiviare impostazioni di configurazione diverse in un file di configurazione XML e quindi caricare tali impostazioni tramite l'opzione /ConfigFile prima dell'esecuzione del pacchetto.You can store different configuration settings in an XML configuration file and then load the settings before package execution by using the /ConfigFile option.

    È possibile usare l'opzione /ConfigFile per caricare in fase di esecuzione configurazioni aggiuntive non specificate in fase di progettazione.You can use the /ConfigFile option to load additional configurations at run time that you did not specify at design time. Non è tuttavia possibile usare l'opzione /ConfigFile per sostituire valori configurati specificati anche in fase di progettazione.However, you cannot use the /ConfigFile option to replace configured values that you also specified at design time. Per informazioni sull'applicazione delle configurazioni dei pacchetti, vedere Package Configurations.To understand how package configurations are applied, see Package Configurations.

  • /Conn[ection] id_or_name;connection_string [[;id_or_name;connection_string]…]: (facoltativo)./Conn[ection] id_or_name;connection_string [[;id_or_name;connection_string]…]: (Optional). Consente di specificare che la gestione connessione con il nome o il GUID indicato si trova nel pacchetto e che è stata specificata una stringa di connessione.Specifies that the connection manager with the specified name or GUID is located in the package, and specifies a connection string.

    Questa opzione richiede che vengano specificati entrambi i parametri: il nome o il GUID della gestione connessione deve essere specificato nell'argomento id_or_name, mentre nell'argomento connection_string deve essere specificata una stringa di connessione valida.This option requires that both parameters be specified: the connection manager name or GUID must be provided in the id_or_name argument, and a valid connection string must be specified in the connection_string argument. Per altre informazioni, vedere Connessioni in Integration Services (SSIS).For more information, see Integration Services (SSIS) Connections.

    In fase di esecuzione è possibile usare l'opzione /Connection per caricare le configurazioni di pacchetto da una posizione diversa da quella specificata in fase di progettazione.At run time, you can use the /Connection option to load package configurations from a location other than the location that you specified at design time. I valori di queste configurazioni sostituiscono i valori specificati in origine.The values of these configurations then replace the values that were originally specified. È tuttavia possibile usare l'opzione /Connection solo per le configurazioni che usano una gestione connessione, ad esempio le configurazioni SQL ServerSQL Server .However you can use the /Connection option only for configurations, such as SQL ServerSQL Server configurations, that use a connection manager. Per capire come sono applicate le configurazioni dei pacchetti, vedere Configurazioni di pacchetto e Differenze di funzionamento delle funzionalità di Integration Services in SQL Server 2016.To understand how package configurations are applied, see Package Configurations and Behavior Changes to Integration Services Features in SQL Server 2016.

  • /Cons[oleLog] [[displayoptions];[list_options;src_name_or_guid]...]: (facoltativo)./Cons[oleLog] [[displayoptions];[list_options;src_name_or_guid]...]: (Optional). Consente di visualizzare le voci di log specificate nella console durante l'esecuzione del pacchetto.Displays specified log entries to the console during package execution. Se questa opzione viene omessa, non verrà visualizzata alcuna voce di log nella console.If this option is omitted, no log entries are shown in the console. Se si specifica l'opzione senza tuttavia alcun parametro per limitare la visualizzazione, verrà visualizzata ogni voce di log.If the option is specified without parameters that limit the display, every log entry will display. Per limitare il numero di voci visualizzate nella console, è possibile specificare le colonne da visualizzare tramite il parametro displayoptions e limitare i tipi di voci di log tramite il parametro list_options .To limit the entries that are displayed to the console, you can specify the columns to show by using the displayoptions parameter, and limit the log entry types by using the list_options parameter.

    NOTA: quando si esegue un pacchetto nel server Integration ServicesIntegration Services usando il parametro S/ISSERVER , l'output della console è limitato e la maggior parte delle opzioni /Cons[oleLog] non è applicabile.NOTE: When you run a package on the Integration ServicesIntegration Services server by using the /ISSERVER parameter, console output is limited and most of the /Cons[oleLog] options are not applicable. Tutti i log di esecuzione possono essere visualizzati dal server nelle viste correlate o tramite report standard disponibili in SQL Server Management StudioSQL Server Management Studio.All execution logs can be seen from the server in the related views or by using standard reports available in SQL Server Management StudioSQL Server Management Studio. Per altre informazioni sui report, vedere Report per il server Integration Services.For more information about the reports, see Reports for the Integration Services Server.

    Sono disponibili i valori displayoptions seguenti:The displayoptions values are as follows:

    • N (Name)N (Name)

    • C (Computer)C (Computer)

    • O (Operator)O (Operator)

    • S (Source Name)S (Source Name)

    • G (Source GUID)G (Source GUID)

    • X (Execution GUID)X (Execution GUID)

    • M (Message)M (Message)

    • T (Time Start and End)T (Time Start and End)

      Sono disponibili i valori list_options seguenti:The list_options values are as follows:

    • I - Specifica l'elenco di inclusione.I - Specifies the inclusion list. Solo i nomi o i GUID delle origini specificati vengono registrati.Only the source names or GUIDs that are specified are logged.

    • E - Specifica l'elenco di esclusione.E - Specifies the exclusion list. I nomi o i GUID delle origini specificati non vengono registrati.The source names or GUIDs that are specified are not logged.

    • Il parametro src_name_or_guid specificato per inclusioni o esclusioni è un nome di evento o un nome o un GUID dell'origine.The src_name_or_guid parameter specified for inclusion or exclusion is an event name, source name, or source GUID.

      Se nello stesso prompt dei comandi si usano più opzioni /ConsoleLog , queste interagiscono nel modo di seguito descritto:If you use multiple /ConsoleLog options on the same command prompt, they interact as follows:

    • L'ordine di visualizzazione non è significativo.Their order of appearance has no effect.

    • Se nella riga di comando non sono presenti elenchi di inclusioni, gli elenchi di esclusioni vengono applicati a tutti i tipi di voci di log.If no inclusion lists are present on the command line, exclusion lists are applied against all kinds of log entries.

    • Se nella riga di comando sono presenti elenchi di inclusione, all'unione di tutti gli elenchi di inclusione vengono applicati gli elenchi di esclusione.If any inclusion lists are present on the command line, exclusion lists are applied against the union of all inclusion lists.

      Per esempi relativi all'opzione /ConsoleLog , vedere la sezione Osservazioni .For several examples of the /ConsoleLog option, see the Remarks section.

-- /D [ts] package_path: (facoltativo).-- /D[ts] package_path: (Optional). Carica un pacchetto dall'archivio pacchetti SSIS.Loads a package from the SSIS Package Store. I pacchetti archiviati nell'archivio pacchetti SSIS vengono distribuiti tramite il modello di distribuzione del pacchetto legacy.Packages that are stored in the SSIS Package Store, are deployed using the legacy package deployment model. Per eseguire i pacchetti distribuiti nel server Integration ServicesIntegration Services tramite il modello di distribuzione del progetto, usare l'opzione /ISServer .To run packages that are deployed to the Integration ServicesIntegration Services server using the project deployment model, use the /ISServer option. Per ulteriori informazioni sui modelli di distribuzione del pacchetto e del progetto, vedere Deployment of Projects and Packages.For more information about the package and project deployment models, see Deployment of Projects and Packages.

 The *package_path* argument specifies the relative path of the [!INCLUDE[ssIS](../../includes/ssis-md.md)] package, starting at the root of the SSIS Package Store, and includes the name of the [!INCLUDE[ssIS](../../includes/ssis-md.md)] package. If the path or file name specified in the *package_path* argument contains a space, you must put quotation marks around the *package_path* argument.  

 The **/DTS** option cannot be used together with the **/File** or **/SQL** option. If multiple options are specified, **dtexec** fails.  
  • /De[crypt] password: (facoltativo)./De[crypt] password: (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.

  • (Facoltativo) Consente di creare i file di dump del debug, con estensione MDMP e TMP, quando si verificano uno o più eventi specificati durante l'esecuzione del pacchetto.(Optional) Creates the debug dump files, .mdmp and .tmp, when one or more specified events occur while the package is running. L'argomento error code specifica il tipo di codice evento (errore, avviso o informazione) che genera la creazione di file di dump del debug.The error code argument specifies the type of event code—error, warning, or information—that will trigger the system to create the debug dump files. Per specificare più codici evento, separare ciascun argomento error code con un punto e virgola (;).To specify multiple event codes, separate each error code argument by a semi-colon (;). Non includere virgolette con l'argomento error code .Do not include quotes with the error code argument.

    Nell'esempio seguente vengono generati i file di dump del debug se si verifica l'errore DTS_E_CANNOTACQUIRECONNECTIONFROMCONNECTIONMANAGER.The following example generates the debug dump files when the DTS_E_CANNOTACQUIRECONNECTIONFROMCONNECTIONMANAGER error occurs.

    /Dump 0xC020801C  
    

    / Dump codice di errore: per impostazione predefinita, Integration ServicesIntegration Services archivia i file di dump del debug nella cartella <unità >: \Programmi\Microsoft SQL Server\110\Shared\ErrorDumps./Dump error code: By default, Integration ServicesIntegration Services stores the debug dump files in the folder, <drive>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps.

    NOTA: i file di dump del debug possono contenere informazioni riservate.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. Ad esempio, prima di inviare i file del debug al supporto tecnico Microsoft, si consiglia di rimuovere eventuali informazioni sensibili o riservate.For example, before you send your debug files to Microsoft support services, we recommended that you remove any sensitive or confidential information.

    Per applicare questa opzione a tutti i pacchetti eseguiti dall'utilità dtexec , aggiungere un valore REG_SZ DumpOnCodes alla chiave del registro di sistema HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath.To apply this option to all packages that the dtexec utility runs, add a DumpOnCodes REG_SZ value to the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath registry key. Il valore dei dati in DumpOnCodes specifica il codice di errore o i codici che generano la creazione di file di dump del debug da parte del sistema.The data value in DumpOnCodes specifies the error code or codes that will trigger the system to create debug dump files. Più codici di errore devono essere separati da un punto e virgola (;).Multiple error codes must be separated by a semi-colon (;).

    Se si aggiunge un valore DumpOnCodes alla chiave del registro di sistema e si usa l'opzione /Dump , il sistema crea file di dump del debug basati su entrambe le impostazioni.If you add a DumpOnCodes value to the registry key, and use the /Dump option, the system will create debug dump files that are based on both settings.

    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.

  • /DumpOnError: (facoltativo). Consente di creare i file di dump del debug, con estensione mdmp e tpm, quando si verifica un errore durante l'esecuzione del pacchetto./DumpOnError: (Optional) Creates the debug dump files, .mdmp and .tmp, when any error occurs while the package is running.

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

    NOTA: i file di dump del debug possono contenere informazioni riservate.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. Ad esempio, prima di inviare i file del debug al supporto tecnico Microsoft, si consiglia di rimuovere eventuali informazioni sensibili o riservate.For example, before you send your debug files to Microsoft support services, we recommended that you remove any sensitive or confidential information.

    Per applicare questa opzione a tutti i pacchetti eseguiti dall'utilità dtexec , aggiungere un valore REG_DWORD DumpOnError alla chiave del registro di sistema HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath.To apply this option to all packages that the dtexec utility runs, add a DumpOnError REG_DWORD value to the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath registry key. Il valore REG_DWORD DumpOnError determina se è necessario usare l'opzione /DumpOnError con l'utilità dtexec :The value of the DumpOnError REG_DWORD value determines whether the /DumpOnError option needs to be used with the dtexec utility:

    • Un valore dei dati diverso da zero indica che verranno creati file di dump del debug quando si verifica un errore, indipendentemente dall'uso dell'opzione /DumpOnError con l'utilità dtexec .A non-zero data value indicates that the system will create debug dump files when any error occurs, regardless of whether you use the /DumpOnError option with the dtexec utility.

    • Un valore dei dati pari a zero indica che non verranno creati file di dump del debug a meno che non venga usata l'opzione /DumpOnError con l'utilità dtexec .A zero data value indicates that the system will not create the debug dump files unless you use the /DumpOnError option with the dtexec utility.

      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

  • /Env[Reference] environment reference ID: (facoltativo)./Env[Reference] environment reference ID: (Optional). Specifica il riferimento all'ambiente (ID) utilizzato dall'esecuzione del pacchetto, per un pacchetto distribuito nel server Integration ServicesIntegration Services .Specifies the environment reference (ID) that is used by the package execution, for a package that is deployed to the Integration ServicesIntegration Services server. Nei parametri configurati per l'associazione alle variabili verranno utilizzati i valori delle variabili contenuti nell'ambiente.The parameters configured to bind to variables will use the values of the variables that are contained in the environment.

    Usare l'opzione /Env[Reference] insieme alle opzioni /ISServer e /Server .You use /Env[Reference] option together with the /ISServer and the /Server options.

    Questo parametro viene utilizzato da SQL Server Agent.This parameter is used by SQL Server Agent.
    -- /F [ile] filespec: (facoltativo).-- /F[ile] filespec: (Optional). Carica un pacchetto salvato nel file system.Loads a package that is saved in the file system. I pacchetti salvati nel file system vengono distribuiti tramite il modello di distribuzione del pacchetto legacy.Packages that are saved in the file system, are deployed using the legacy package deployment model. Per eseguire i pacchetti distribuiti nel server Integration ServicesIntegration Services tramite il modello di distribuzione del progetto, usare l'opzione /ISServer .To run packages that are deployed to the Integration ServicesIntegration Services server using the project deployment model, use the /ISServer option. Per ulteriori informazioni sui modelli di distribuzione del pacchetto e del progetto, vedere Deployment of Projects and Packages.For more information about the package and project deployment models, see Deployment of Projects and Packages

    L'argomento filespec specifica il percorso e il nome file del pacchetto.The filespec argument specifies the path and file name of the package. È possibile specificare il percorso in formato UNC (Universal Naming Convention) o come percorso locale.You can specify the path as either a Universal Naming Convention (UNC) path or a local path. Se nel percorso o nel nome file specificato nell'argomento filespec è contenuto uno spazio, è necessario racchiudere l'argomento filespec tra virgolette.If the path or file name specified in the filespec argument contains a space, you must put quotation marks around the filespec argument.

    L'opzione /File non può essere usata in combinazione con l'opzione /DTS o /SQL .The /File option cannot be used together with the /DTS or /SQL option. Se si specificano più opzioni, l'esecuzione di dtexec avrà esito negativo.If multiple options are specified, dtexec fails.

  • /H[elp] [option_name]: (facoltativo)./H[elp] [option_name]: (Optional). Consente di visualizzare le informazioni della Guida relative alle opzioni o all'opzione specificata dall'argomento option_name e quindi di chiudere l'utilità.Displays help for the options, or displays help for the specified option_name and closes the utility.

    Se si specifica un argomento option_name , dtexec avvia la documentazione online di SQL ServerSQL Server e visualizza l'argomento relativo all'utilità dtexec.If you specify an option_name argument, dtexec starts SQL ServerSQL Server Books Online and displays the dtexec Utility topic.

  • /ISServer packagepath: (facoltativo)./ISServer packagepath: (Optional). Esegue un pacchetto distribuito nel server Integration ServicesIntegration Services .Runs a package that is deployed to the Integration ServicesIntegration Services server. Con l'argomento PackagePath vengono specificati il percorso completo e il nome file del pacchetto distribuito nel server Integration ServicesIntegration Services .The PackagePath argument specifies the full path and file name of the package deployed to the Integration ServicesIntegration Services server. Se nel percorso o nel nome file specificato nell'argomento PackagePath è contenuto uno spazio, è necessario racchiudere l'argomento PackagePath tra virgolette.If the path or file name specified in the PackagePath argument contains a space, you must put quotation marks around the PackagePath argument.

    Il formato del pacchetto è il seguente:The package format is as follows:

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

    Usare l'opzione /Server insieme all'opzione /ISSERVER .You use /Server option together with the /ISSERVER option. Un pacchetto nel server SSIS può essere eseguito solo con l'autenticazione di Windows.Only Windows Authentication can execute a package on the SSIS Server. Per accedere al pacchetto viene utilizzato l'utente corrente di Windows.The current Windows user is used to access the package. Se si omette l'opzione /Server, viene usata l'istanza locale predefinita di SQL ServerSQL Server .If the /Server option is omitted, the default local instance of SQL ServerSQL Server is assumed.

    L'opzione /ISSERVER non può essere usata in combinazione con l'opzione /DTS, /SQL o /File .The /ISSERVER option cannot be used together with the /DTS, /SQL or /File option. Se si specificano più opzioni, l'esecuzione di dtexec avrà esito negativo.If multiple options are specified, dtexec fails.

    Questo parametro viene utilizzato da SQL Server Agent.This parameter is used by SQL Server Agent.

  • /L[ogger] classid_orprogid;configstring: (facoltativo)./L[ogger] classid_orprogid;configstring: (Optional). Associa uno o più provider di log all'esecuzione di un pacchetto di SSISSSIS .Associates one or more log providers with the execution of an SSISSSIS package. Il parametro classid_orprogid specifica il provider di log e può essere specificato come un GUID di classe.The classid_orprogid parameter specifies the log provider, and can be specified as a class GUID. L'argomento configstring è la stringa utilizzata per configurare il provider di log.The configstring is the string that is used to configure the log provider.

    Di seguito sono elencati i provider di log disponibili:The following list shows the available log providers:

    • File di testoText file:

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

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

    • SQL Server ProfilerSQL Server Profiler::

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

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

    • SQL ServerSQL Server::

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

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

    • Registro eventi di WindowsWindows Event Log:

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

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

    • File XMLXML File:

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

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

  • /M[axConcurrent] concurrent_executables: (facoltativo)./M[axConcurrent] concurrent_executables: (Optional). Consente di specificare il numero di file eseguibili che il pacchetto è in grado di eseguire contemporaneamente.Specifies the number of executable files that the package can run concurrently. Il valore specificato deve essere un valore intero non negativo oppure -1.The value specified must be either a non-negative integer, or -1. Il valore -1 indica che SSISSSIS supporta un numero massimo di file eseguibili in esecuzione simultanea uguale al numero totale di processori nel computer in cui è eseguito il pacchetto, più due.A value of -1 means that SSISSSIS will allow a maximum number of concurrently running executables that is equal to the total number of processors on the computer executing the package, plus two.

  • /Pack[age] PackageName: (facoltativo)./Pack[age] PackageName: (Optional). Specifica il pacchetto che viene eseguito.Specifies the package that is executed. Questo parametro viene utilizzato principalmente quando si esegue il pacchetto da Visual StudioVisual Studio.This parameter is used primarily when you execute the package from Visual StudioVisual Studio.

  • /P[assword] password: (facoltativo)./P[assword] password: (Optional). Consente il recupero di un pacchetto protetto tramite l'autenticazione di SQL ServerSQL Server .Allows the retrieval of a package that is protected by SQL ServerSQL Server Authentication. Questa opzione viene usata in combinazione con l'opzione /User .This option is used together with the /User option. Se si omette l'opzione /Password e viene usata l'opzione /User , verrà usata una password vuota.If the /Password option is omitted and the /User option is used, a blank password is used. Il valore di password può essere racchiuso tra virgolette.The password value may be quoted.

    IMPORTANTEIMPORTANT!! Se possibile, usare l'autenticazione di Windows.When possible, use Windows Authentication.

  • /Par[ameter] [$Package:: | $Project:: | $ServerOption::] parameter_name [(data_type)]; literal_value: (facoltativo)./Par[ameter] [$Package:: | $Project:: | $ServerOption::] parameter_name [(data_type)]; literal_value: (Optional). Specifica i valori dei parametri.Specifies parameter values. È possibile specificare più opzioni /Parameter .Multiple /Parameter options can be specified. I tipi di dati sono CLR TypeCodes come stringhe.The data types are CLR TypeCodes as strings. Per un parametro non stringa, il tipo di dati viene specificato in parentesi, dopo il nome del parametro.For a non-string parameter, the data type is specified in parenthesis, following the parameter name.

    L'opzione /Parameter può essere specificata solo con l'opzione /ISServer .The /Parameter option can be used only with the /ISServer option.

    È possibile utilizzare i prefissi $Package, $Project e $ServerOption per indicare rispettivamente un parametro di pacchetto, un parametro di progetto e un parametro di opzione server.You use the $Package, $Project, and $ServerOption prefixes to indicate a package parameter, project parameter, and a server option parameter, respectively. Il pacchetto è il tipo di parametro predefinito.The default parameter type is package.

    Di seguito è riportato un esempio relativo all'esecuzione di un pacchetto e all'impostazione di myvalue per il parametro di progetto (myparam) e del valore intero 12 per il parametro di pacchetto (anotherparam).The following is an example of executing a package and providing myvalue for the project parameter (myparam) and the integer value 12 for the package parameter (anotherparam).

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

    È inoltre possibile impostare le proprietà di gestione connessione utilizzando i parametri.You can also set connection manager properties by using parameters. Per identificare un parametro di gestione connessione utilizzare il prefisso CM.You use the CM prefix to denote a connection manager parameter.

    Nell'esempio seguente la proprietà InitialCatalog della gestione connessione SourceServer è impostata su ssisdb.In the following example, InitialCatalog property of the SourceServer connection manager is set to ssisdb.

    /parameter CM.SourceServer.InitialCatalog;ssisdb  
    

    Nell'esempio seguente la proprietà ServerName della gestione connessione SourceServer è impostata su un punto (.) per indicare il server locale.In the following example, ServerName property of the SourceServer connection manager is set to a period (.) to indicate the local server.

    /parameter CM.SourceServer.ServerName;.  
    
  • /Proj[ect] ProjectFile: (facoltativo)./Proj[ect] ProjectFile: (Optional). Specifica il progetto da cui recuperare il pacchetto che viene eseguito.Specifies the project from which to retrieve the package that is executed. Con l'argomento ProjectFile viene specificato il nome file con estensione ispac.The ProjectFile argument specifies the .ispac file name. Questo parametro viene utilizzato principalmente quando si esegue il pacchetto da Visual StudioVisual Studio.This parameter is used primarily when you execute the package from Visual StudioVisual Studio.

  • /Rem comment: (facoltativo)./Rem comment: (Optional). Include i commenti nel prompt dei comandi o nei file di comando.Includes comments on the command prompt or in command files. L'argomento è facoltativo.The argument is optional. Il valore di comment è una stringa che deve essere racchiusa tra virgolette o non deve contenere spazi.The value of comment is a string that must be enclosed in quotation marks, or contain no white space. Se non si specifica alcun argomento, viene inserita una riga vuota.If no argument is specified, a blank line is inserted. Durante la fase di determinazione dell'origine del comando, i valoricomment vengono eliminati.comment values are discarded during the command sourcing phase.

  • /Rep[orting] level [;event_guid_or_name[;event_guid_or_name[...]]: (facoltativo)./Rep[orting] level [;event_guid_or_name[;event_guid_or_name[...]]: (Optional). Specifica i tipi di messaggi da segnalare.Specifies what types of messages to report. Le opzioni relative alle opzioni per level sono elencate di seguito:The available reporting options for level are as follows:

    N Nessun report.N No reporting.

    E Gli errori vengono segnalati.E Errors are reported.

    W Gli avvisi vengono segnalati.W Warnings are reported.

    I I messaggi informativi vengono segnalati.I Informational messages are reported.

    C Gli eventi personalizzati vengono segnalati.C Custom events are reported.

    D Gli eventi relativi alle attività Flusso di dati vengono segnalati.D Data Flow task events are reported.

    P Lo stato viene segnalato.P Progress is reported.

    V Report dettagliati.V Verbose reporting.

    Gli argomenti V e N escludono tutti gli altri argomenti e pertanto devono essere specificati da soli.The arguments of V and N are mutually exclusive to all other arguments; they must be specified alone. Se non si specifica l'opzione /Reporting , il livello predefinito è E (errori), W (avvisi) e P (stato).If the /Reporting option is not specified then the default level is E (errors), W (warnings), and P (progress).

    Tutti gli eventi sono preceduti da un timestamp nel formato "AA/MM/GG HH:MM:SS" e da un GUID o un nome descrittivo se disponibile.All events are preceded with a timestamp in the format "YY/MM/DD HH:MM:SS", and a GUID or friendly name if available.

    Il parametro facoltativo event_guid_or_name è un elenco di eccezioni per i provider di log.The optional parameter event_guid_or_name is a list of exceptions to the log providers. ovvero gli eventi da non registrare che potrebbero altrimenti essere stati registrati.The exception specifies the events that are not logged that otherwise might have been logged.

    Non è necessario escludere un evento se normalmente non viene registrato per impostazione predefinita.You do not have to exclude an event if the event is not ordinarily logged by default

  • /Res[tart] {deny | force | ifPossible}: (facoltativo)./Res[tart] {deny | force | ifPossible}: (Optional). Specifica un nuovo valore per la proprietà CheckpointUsage nel pacchetto.Specifies a new value for the CheckpointUsage property on the package. Di seguito è descritto il significato di ogni parametro.The meaning of the parameters are as follows:

    Deny Imposta la proprietà CheckpointUsage su DTSCU_NEVER.Deny Sets CheckpointUsage property to DTSCU_NEVER.

    Force Imposta la proprietà CheckpointUsage su DTSCU_ALWAYS.Force Sets CheckpointUsage property to DTSCU_ALWAYS.

    ifPossible Imposta la proprietà CheckpointUsage su DTSCU_IFEXISTS.ifPossible Sets CheckpointUsage property to DTSCU_IFEXISTS.

    Se non si specifica alcun valore, viene usato il valore predefinito force .The default value of force is used if no value is specified.

  • /Set [$Sensitive::]propertyPath;value: (facoltativo)./Set [$Sensitive::]propertyPath;value: (Optional). Ignora la configurazione di un parametro, una variabile, una proprietà, un contenitore, un provider di log, un enumeratore Foreach o una connessione all'interno di un pacchetto.Overrides the configuration of a parameter, variable, property, container, log provider, Foreach enumerator, or connection within a package. Se si specifica questa opzione, /Set modifica il valore dell'argomento propertyPath nel valore specificato.When this option is used, /Set changes the propertyPath argument to the value specified. È possibile specificare più opzioni /Set .Multiple /Set options can be specified.

    Oltre a usare l'opzione /Set con l'opzione /F[ile] , è anche possibile usare /Set con l'opzione /ISServer o /Project .In addition to using the /Set option with the /F[ile] option, you can also use the /Set option with the /ISServer option or the /Project option. Quando si usa /Set con /Project, /Set imposta i valori dei parametri.When you use /Set with /Project, /Set sets parameter values. Quando si usa /Set con /ISServer, /Set imposta gli override delle proprietà.When you use /Set with /ISServer, /Set sets property overrides. Quando /Set viene usata con /ISServer, è possibile anche usare il prefisso facoltativo $Sensitive per indicare che la proprietà è sensibile nel server Integration ServicesIntegration Services .In addition, when you use /Set with /ISServer, you can use the optional $Sensitive prefix to indicate that the property should be treated as sensitive on the Integration ServicesIntegration Services server.

    È possibile determinare il valore di propertyPath eseguendo la Configurazione guidata pacchetto.You can determine the value of propertyPath by running the Package Configuration Wizard. I percorsi per gli elementi selezionati vengono visualizzati nella pagina finale Completamento procedura guidata e possono essere copiati e incollati.The paths for items that you select are displayed on the final Completing the Wizard page, and can be copied and pasted. Se si utilizza la procedura guidata soltanto a questo scopo, è possibile annullare la procedura guidata dopo aver copiato i percorsi.If you have used the wizard only for this purpose, you can cancel the wizard after you copy the paths.

    Di seguito è riportato un esempio relativo all'esecuzione di un pacchetto salvato nel file system e all'impostazione di un nuovo valore per una variabile:The following is an example of executing a package that is saved in the file system and providing a new value for a variable:

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

    Di seguito è riportato un esempio relativo all'esecuzione di un pacchetto dal file di progetto con estensione ispac e all'impostazione dei parametri di pacchetto e di progetto.The following example of running a package from the .ispac project file and setting package and project parameters.

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

    È possibile usare l'opzione /Set per modificare il percorso da cui vengono caricate le configurazioni di pacchetto.You can use the /Set option to change the location from which package configurations are loaded. Non è tuttavia possibile usare l'opzione /Set per ignorare un valore specificato da una configurazione in fase di progettazione.However, you cannot use the /Set option to override a value that was specified by a configuration at design time. Per capire come sono applicate le configurazioni dei pacchetti, vedere Configurazioni di pacchetto e Differenze di funzionamento delle funzionalità di Integration Services in SQL Server 2016.To understand how package configurations are applied, see Package Configurations and Behavior Changes to Integration Services Features in SQL Server 2016.

  • /Ser[ver] server: (facoltativo)./Ser[ver] server: (Optional). Se si specifica l'opzione /SQL o /DTS , questa opzione specifica il nome del server dal quale recuperare il pacchetto.When the /SQL or /DTS option is specified, this option specifies the name of the server from which to retrieve the package. Se si omette l'opzione /Server e si specifica l'opzione /SQL o /DTS , verrà tentata l'esecuzione del pacchetto nel server locale.If you omit the /Server option and the /SQL or /DTS option is specified, package execution is tried against the local server. Il valore server_instance può essere racchiuso fra virgolette.The server_instance value may be quoted.

    L'opzione /Ser[ver] è obbligatoria se è specificata l'opzione /ISServer .The /Ser[ver] option is required when the /ISServer option is specified.

-- /SQ [L] package_path: carica un pacchetto archiviato in SQL ServerSQL Servernella msdb database.-- /SQ[L] package_path: Loads a package that is stored in SQL ServerSQL Server, in msdb database. I pacchetti archiviati nel database msdb vengono distribuiti tramite il modello di distribuzione del pacchetto.Packages that are stored in the msdb database, are deployed using the package deployment model. Per eseguire i pacchetti distribuiti nel server Integration ServicesIntegration Services tramite il modello di distribuzione del progetto, usare l'opzione /ISServer .To run packages that are deployed to the Integration ServicesIntegration Services server using the project deployment model, use the /ISServer option. Per ulteriori informazioni sui modelli di distribuzione del pacchetto e del progetto, vedere Deployment of Projects and Packages.For more information about the package and project deployment models, see Deployment of Projects and Packages.

 The *package_path* argument specifies the name of the package to retrieve. If folders are included in the path, they are terminated with backslashes ("\\"). The *package_path* value can be quoted. If the path or file name specified in the *package_path* argument contains a space, you must put quotation marks around the *package_path* argument.  

 You can use the **/User**, **/Password**, and **/Server** options together with the **/SQL** option.  

 If you omit the **/User** option, Windows Authentication is used to access the package. If you use the **/User** option, the **/User** login name specified is associated with [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] Authentication.  

 The **/Password** option is used only together with the **/User** option. If you use the **/Password** option, the package is accessed with the user name and password information provided. If you omit the **/Password** option, a blank password is used.  

> **IMPORTANT!!** [!INCLUDE[ssNoteWinAuthentication](../../includes/ssnotewinauthentication-md.md)]  

 If the **/Server** option is omitted, the default local instance of [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] is assumed.  

 The **/SQL** option cannot be used together with the **/DTS** or **/File** option. If multiple options are specified, **dtexec** fails.  
  • /Su[m]: (facoltativo)./Su[m]: (Optional). Consente di visualizzare un contatore incrementale con il numero di righe che verranno ricevute dal componente successivo.Shows an incremental counter that contains the number of rows that will be received by the next component.

  • /U[ser] user_name: (facoltativo)./U[ser] user_name: (Optional). Consente il recupero di un pacchetto protetto tramite l'autenticazione di SQL ServerSQL Server .Allows the retrieval of a package that is protected by SQL ServerSQL Server Authentication. Questa opzione viene usata solo se si specifica l'opzione /SQL .This option is used only when the /SQL option is specified. Il valore user_name può essere racchiuso tra virgolette.The user_name value can be quoted.

    IMPORTANTEIMPORTANT!! Se possibile, usare l'autenticazione di Windows.When possible, use Windows Authentication.

  • /Va[lidate]: (facoltativo)./Va[lidate]: (Optional). Consente di arrestare l'esecuzione del pacchetto dopo la fase di convalida, quindi il pacchetto non viene eseguito.Stops the execution of the package after the validatation phase, without actually running the package. Durante la convalida, se si usa l'opzione /WarnAsError l'utilità dtexec interpreta un avviso come un errore e pertanto il pacchetto viene chiuso se durante la convalida viene generato un avviso.During validation, use of the /WarnAsError option causes dtexec to treat a warning as an error; therefore the package fails if a warning occurs during validation.

  • /VerifyB[uild] major[;minor[;build]]: (facoltativo)./VerifyB[uild] major[;minor[;build]]: (Optional). Consente di verificare il numero di build di un pacchetto rispetto ai numeri di build specificati durante la fase di verifica negli argomenti major, minore build .Verifies the build number of a package against the build numbers that were specified during the verification phase in the major, minor, and build arguments. Se i numeri non corrispondono, il pacchetto non verrà eseguito.If a mismatch occurs, the package will not execute.

    I valori sono di tipo integer long.The values are long integers. L'argomento può avere uno dei tre formati seguenti. Il valore major è sempre obbligatorio:The argument can have one of three forms, with a value for major always required:

    • majormajor

    • major;minormajor;minor

    • major; minor; buildmajor; minor; build

  • /VerifyP[ackageID] packageID: (facoltativo)./VerifyP[ackageID] packageID: (Optional). Consente di verificare il GUID del pacchetto da eseguire in base al valore specificato nell'argomento package_id .Verifies the GUID of the package to be executed by comparing it to the value specified in the package_id argument.

  • /VerifyS[igned]: (facoltativo)./VerifyS[igned]: (Optional). Comporta il controllo della firma digitale del pacchetto da parte di Integration ServicesIntegration Services .Causes Integration ServicesIntegration Services to check the digital signature of the package. Se il pacchetto non è firmato o se la firma non è valida, il pacchetto ha esito negativo.If the package is not signed or the signature is not valid, the package fails. Per altre informazioni, vedere Identificazione dell'origine dei pacchetti con firme digitali.For more information, see Identify the Source of Packages with Digital Signatures.

    IMPORTANTEIMPORTANT!! Se Integration ServicesIntegration Services è configurato per la verifica della firma del pacchetto, gli unici controlli che vengono eseguiti sono quelli relativi alla presenza e alla validità della firma digitale, nonché all'attendibilità dell'origine.When configured to check the signature of the package, Integration ServicesIntegration Services only checks whether the digital signature is present, is valid, and is from a trusted source. Integration ServicesIntegration Services non controlla se il pacchetto è stato modificato. does not check whether the package has been changed.

    NOTA: il valore facoltativo BlockedSignatureStates del Registro di sistema può specificare un'impostazione più restrittiva rispetto all'opzione per la firma digitale impostata in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) o nella riga di comando dtexec .NOTE: The optional BlockedSignatureStates registry value can specify a setting that is more restrictive than the digital signature option set in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) or at the dtexec command line. In questo caso, l'impostazione del Registro di sistema più restrittiva ha la precedenza rispetto ad altre impostazioni.In this situation, the more restrictive registry setting overrides the other settings.

  • /VerifyV[ersionID] versionID: (facoltativo)./VerifyV[ersionID] versionID: (Optional). Consente di verificare il GUID di versione di un pacchetto da eseguire in base al valore specificato nell'argomento version_id durante la fase di convalida del pacchetto.Verifies the version GUID of a package to be executed by comparing it to the value specified in the version_id argument during package Validation Phase.

  • /VLog [Filespec]: (facoltativo)./VLog [Filespec]: (Optional). Consente di scrivere tutti gli eventi dei pacchetti Integration Services nei provider di log abilitati durante la progettazione del pacchetto.Writes all Integration Services package events to the log providers that were enabled when the package was designed. Per consentire l'abilitazione di un provider di log per i file di testo e la scrittura degli eventi del log in un file di testo specifico, includere un percorso e un nome file come parametro Filespec .To have Integration Services enable a log provider for text files and write log events to a specified text file, include a path and file name as the Filespec parameter.

    Se non si include il parametro Filespec , non sarà possibile abilitare un provider di log per i file di testo.If you do not include the Filespec parameter, Integration Services will not enable a log provider for text files. Gli eventi del log verranno scritti solo nei provider di log abilitati durante la progettazione del pacchetto.Integration Services will only write log events to the log providers that were enabled when the package was designed.

  • /W[arnAsError]: (facoltativo)./W[arnAsError]: (Optional). Poiché un avviso viene interpretato come un errore, il pacchetto non viene eseguito se durante la convalida viene generato un avviso.Causes the package to consider a warning as an error; therefore, the package will fail if a warning occurs during validation. Se non viene generato alcun avviso durante la convalida e si omette l'opzione /Validate , il pacchetto viene eseguito.If no warnings occur during validation and the /Validate option is not specified, the package is executed.

  • /X86: (facoltativo)./X86: (Optional). Determina l'esecuzione del pacchetto in modalità a 32 bit in un computer a 64 bit da parte di SQL ServerSQL Server Agent.Causes SQL ServerSQL Server Agent to run the package in 32-bit mode on a 64-bit computer. Questa opzione viene impostata da SQL ServerSQL Server Agent quando sono soddisfatte le condizioni seguenti:This option is set by SQL ServerSQL Server Agent when the following conditions are true:

    • Il tipo di passaggio del processo è Pacchetto SQL Server Integration Services.The job step type is SQL Server Integration Services package.

    • L'opzione Usa runtime a 32 bit nella scheda Opzioni di esecuzione della finestra di dialogo Nuovo passaggio di processo è selezionata.The Use 32 bit runtime option on the Execution options tab of the New Job Step dialog box is selected.

      È anche possibile impostare questa opzione per un passaggio del processo di SQL ServerSQL Server Agent usando le stored procedure o SQL Server Management Objects (SMO) per creare il processo a livello di codice.You can also set this option for a SQL ServerSQL Server Agent job step by using stored procedures or SQL Server Management Objects (SMO) to programmatically create the job.

      Questa opzione è utilizzata solo da SQL ServerSQL Server Agent.This option is only used by SQL ServerSQL Server Agent. Questa opzione viene ignorata se si esegue l'utilità dtexec dal prompt dei comandi.This option is ignored if you run the dtexec utility at the command prompt.

Osservazioni Remarks

L'ordine in cui vengono specificate le opzioni del comando può influire sulla modalità di esecuzione del pacchetto:The order in which you specify command options can influence the way in which the package executes:

  • Le opzioni vengono elaborate nell'ordine che occupano nella riga di comando.Options are processed in the order they are encountered on the command line. I file di comando vengono letti in base all'ordine con cui vengono rilevati nella riga di comando,Command files are read in as they are encountered on the command line. in modo analogo ai comandi nel file di comando.The commands in the command file are also processed in the order they are encountered.

  • Se la stessa opzione, lo stesso parametro o la stessa variabile compare più volte nella stessa istruzione della riga di comando, l'ultima istanza dell'opzione avrà la precedenza sulle altre.If the same option, parameter, or variable appears in the same command line statement more than one time, the last instance of the option takes precedence.

  • Le opzioni/Set e /ConfigFile vengono elaborate nell'ordine in cui vengono rilevate./Set and /ConfigFile options are processed in the order they are encountered.

Esempi Examples

Gli esempi seguenti illustrano come usare l'utilità del prompt dei comandi dtexec per configurare ed eseguire i pacchetti di SQL ServerSQL Server Integration ServicesIntegration Services .The following examples demonstrate how to use the dtexec command prompt utility to configure and execute SQL ServerSQL Server Integration ServicesIntegration Services packages.

Esecuzione di pacchettiRunning Packages

Per eseguire un pacchetto di SSISSSIS salvato in SQL ServerSQL Server utilizzando l'autenticazione di Windows, utilizzare il codice seguente:To execute an SSISSSIS package saved to SQL ServerSQL Server using Windows Authentication, use the following code:

dtexec /sq pkgOne /ser productionServer  

Per eseguire un pacchetto di SSISSSIS salvato nella cartella del file system nell'archivio pacchetti SSIS, utilizzare il codice seguente:To execute an SSISSSIS package saved to the File System folder in the SSIS Package Store, use the following code:

dtexec /dts "\File System\MyPackage"  

Per convalidare un pacchetto che utilizza l'autenticazione di Windows ed è salvato in SQL ServerSQL Server senza tuttavia eseguirlo, utilizzare il codice seguente:To validate a package that uses Windows Authentication and is saved in SQL ServerSQL Server without executing the package, use the following code:

dtexec /sq pkgOne /ser productionServer /va  

Per eseguire un pacchetto di SSISSSIS salvato nel file system, utilizzare il codice seguente:To execute an SSISSSIS package that is saved in the file system, use the following code:

dtexec /f "c:\pkgOne.dtsx"   

Per eseguire un pacchetto di SSISSSIS salvato nel file system e per specificare le opzioni di registrazione, utilizzare il codice seguente:To execute an SSISSSIS package that is saved in the file system, and specify logging options, use the following code:

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

Per eseguire un pacchetto che utilizza l'autenticazione di Windows ed è salvato nell'istanza predefinita locale di SQL ServerSQL Server, e verificarne la versione prima della sua esecuzione, utilizzare il codice seguente:To execute a package that uses Windows Authentication and is saved to the default local instance of SQL ServerSQL Server, and verify the version before it is executed, use the following code:

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

Per eseguire un pacchetto di SSISSSIS salvato nel file system e configurato esternamente, utilizzare il codice seguente:To execute an SSISSSIS package that is saved in the file system and configured externally, use the following code:

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

NOTA: gli argomenti package_path e filespec dell'opzione /SQL, /DTS o /FILE devono essere racchiusi tra virgolette se il percorso o il nome del file contiene uno spazio.NOTE: The package_path or filespec arguments of the /SQL, /DTS, or /FILE options must be enclosed in quotation marks if the path or file name contains a space. Se non è racchiuso tra virgolette, un argomento non può contenere spazi vuoti.If the argument is not enclosed in quotation marks, the argument cannot contain white space.

Opzioni di registrazioneLogging Option

Si supponga, ad esempio, che i tipi di voci di log siano A, B e C. Nell'esempio seguente l'opzione ConsoleLog senza alcun parametro visualizza tutti e tre i tipi di log con tutti i campi:If there are three log entry types of A, B, and C, the following ConsoleLog option without a parameter displays all three log types with all fields:

/CONSOLELOG  

Nell'opzione seguente vengono visualizzati tutti i tipi di log, ma solo con le colonne Name e Message:The following option displays all log types, but with the Name and Message columns only:

/CONSOLELOG NM  

Nell'opzione seguente vengono visualizzate tutte le colonne, ma solo per il tipo di voce di log A:The following option displays all columns, but only for log entry type A:

/CONSOLELOG I;LogEntryTypeA  

Nell'opzione seguente viene visualizzato solo il tipo di voce di log A con le colonne Name e Message:The following option displays only log entry type A, with Name and Message columns:

/CONSOLELOG NM;I;LogEntryTypeA  

L'opzione seguente consente di visualizzare le voci di log per i tipi di voci di log A e B:The following option displays log entries for log entry types A and B:

/CONSOLELOG I;LogEntryTypeA;LogEntryTypeB  

È possibile ottenere gli stessi risultati usando più opzioni ConsoleLog :You can achieve the same results by using multiple ConsoleLog options:

/CONSOLELOG I;LogEntryTypeA /CONSOLELOG I;LogEntryTypeB  

Se l'opzione ConsoleLog viene usata senza parametri, vengono visualizzati tutti i campi.If the ConsoleLog option is used without parameters, all fields are displayed. L'inclusione di un parametro list_options comporta la visualizzazione solo del tipo di voce di log A con tutti i campi:The inclusion of a list_options parameter causes the following to displays only log entry type A, with all fields:

/CONSOLELOG NM;I;LogEntryTypeA /CONSOLELOG  

L'esempio seguente visualizza tutte le voci di log eccetto il tipo di voce di log A, ovvero visualizza i tipi di voce di log B e C:The following displays all log entries except log entry type A: that is, it displays log entry types B and C:

/CONSOLELOG E;LogEntryTypeA  

Nell'esempio seguente gli stessi risultati vengono ottenuti usando più opzioni ConsoleLog e una singola esclusione:The following example achieves the same results by using multiple ConsoleLog options and a single exclusion:

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

Nell'esempio seguente non viene visualizzato alcun messaggio di log poiché, quando un tipo di file di log si trova sia nell'elenco delle inclusioni sia in quello delle esclusioni, esso verrà escluso.The following example displays no log messages, because when a log file type is found in both the included and excluded lists, it will be excluded.

/CONSOLELOG E;LogEntryTypeA /CONSOLELOG I;LogEntryTypeA  

Opzione SETSET Option

L'esempio seguente illustra come usare l'opzione /SET tramite cui è possibile modificare il valore di qualsiasi variabile o proprietà del pacchetto quando si avvia il pacchetto dalla riga di comando.The following example shows how to use the /SET option, which lets you change the value of any package property or variable when you start the package from the command line.

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

Opzione ProjectProject Option

L'esempio seguente illustra come usare le opzioni /Project e /Package .The following example shows how to use the /Project and the /Package option.

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

L'esempio seguente illustra come usare le opzioni /Project e /Package e come impostare i parametri del pacchetto e del progetto.The following example shows how to use the /Project and /Package options, and set package and project parameters.

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

Opzione ISServerISServer Option

L'esempio seguente illustra come usare l'opzione /ISServer .The following example shows how to use the /ISServer option.

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

L'esempio seguente illustra come usare l'opzione /ISServer e come impostare i parametri del progetto e di gestione connessione.The following example shows how to use the /ISServer option and set project and connection manager parameters.

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

Intervento sul blog relativo a codici di uscita, DTEXEC e catalogo SSIS, su www.mattmasson.com.Blog entry, Exit Codes, DTEXEC, and SSIS Catalog, on www.mattmasson.com.