dtutil (utilitaire)dtutil Utility

L’utilitaire d’invite de commandes dtutil sert à gérer les packages SQL ServerSQL Server Integration ServicesIntegration Services .The dtutil command prompt utility is used to manage SQL ServerSQL Server Integration ServicesIntegration Services packages. Cet utilitaire peut copier, déplacer ou supprimer un package, ou en vérifier l'existence.The utility can copy, move, delete, or verify the existence of a package. Ces actions peuvent être effectuées sur n'importe quel package SSISSSIS stocké à l'un des trois emplacements suivants : une base de données MicrosoftMicrosoft SQL ServerSQL Server , le magasin de packages SSISSSIS et le système de fichiers.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. Si l'utilitaire accède à un package stocké dans msdb, il peut être nécessaire d'indiquer un nom d'utilisateur et un mot de passe à l'invite de commandes.If the utility accesses a package that is stored in msdb, the command prompt may require a user name and a password. Si l'instance de SQL ServerSQL Server utilise l'authentification SQL ServerSQL Server , il est nécessaire d'indiquer un nom d'utilisateur et un mot de passe à l'invite de commandes.If the instance of SQL ServerSQL Server uses SQL ServerSQL Server Authentication, the command prompt requires both a user name and a password. Si le nom d'utilisateur est manquant, dtutil essaie de se connecter à SQL ServerSQL Server en utilisant l'authentification Windows.If the user name is missing, dtutil tries to log on to SQL ServerSQL Server using Windows Authentication. Le type de stockage du package est identifié par les options /SQL, /FILEet /DTS .The storage type of the package is identified by the /SQL, /FILE, and /DTS options.

L'utilitaire d'invite de commandes dtutil ne prend pas en charge l'utilisation de fichiers de commandes ni la redirection.The dtutil command prompt utility does not support the use of command files or redirection.

L'utilitaire d'invite de commandes dtutil comprend les fonctionnalités suivantes :The dtutil command prompt utility includes the following features:

  • Des remarques présentes à l'invite de commandes, qui documentent automatiquement l'action en cours de réalisation et qui en facilitent la compréhensionRemarks in the command prompt, which makes the command prompt action self-documenting and easier to understand.

  • Une protection contre l'écrasement, qui sollicite votre confirmation avant une opération de copie ou de déplacement de packages susceptible de remplacer un package existantOverwrite protection, to prompt for a confirmation before overwriting an existing package when you are copying or moving packages.

  • Une aide de la console, qui fournit des informations sur les options de commande de dtutil.Console help, to provide information about the command options for dtutil.

Note

Nombre des opérations qui sont réalisées par l'utilitaire dtutil peuvent également être réalisées visuellement dans SQL Server Management StudioSQL Server Management Studio lorsque vous êtes connecté à une instance de 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. Pour plus d’informations, consultez Gestion de packages (Service SSIS).For more information, see Package Management (SSIS Service).

Les options peuvent être entrées dans n'importe quel ordre.The options can be typed in any order. Le caractère (« | ») est l’opérateur OR et sert à afficher les valeurs possibles.The pipe ("|") character is the OR operator and is used to show possible values. Vous devez choisir l'une des options qui sont délimitées par le caractère OR .You must use one of the options that are delimited by the OR pipe.

Toutes les options doivent commencer par une barre oblique (/) ou par un signe moins (-).All options must start with a slash (/) or a minus sign (-). Toutefois, n'insérez pas d'espace entre la barre oblique ou le signe moins et le texte de l'option ; sinon, la commande échoue.However, do not include a space between the slash or minus sign and the text for the option; otherwise, the command will fail.

Les arguments doivent être des chaînes entre guillemets ou ne contenir aucun espace.Arguments must be strings that are either enclosed in quotation marks or contain no white space.

Les guillemets doubles à l'intérieur des chaînes mises entre guillemets simples représentent des guillemets simples en mode échappement.Double quotation marks within strings that are enclosed in quotation marks represent escaped single quotation marks.

Les options et les arguments, à l'exception des mots de passe, ne respectent pas la casse.Options and arguments, except for passwords, are not case sensitive.

Considérations concernant l'installation sur les ordinateurs 64 bitsInstallation Considerations on 64-bit Computers

Sur un ordinateur 64 bits, Integration ServicesIntegration Services installe une version 64 bits de l’utilitaire dtexec (dtexec.exe) et de l’utilitaire 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). Pour installer des versions 32 bits de ces outils Integration ServicesIntegration Services , vous devez sélectionner Outils clients ou Outils de données SQL Server (SSDT)SQL Server Data Tools (SSDT) lors de l'installation.To install 32-bit versions of these Integration ServicesIntegration Services tools, you must select either Client Tools or Outils de données SQL Server (SSDT)SQL Server Data Tools (SSDT) during setup.

Par défaut, un ordinateur 64 bits qui dispose à la fois des versions 64 bits et 32 bits d'une invite de commandes Integration ServicesIntegration Services doit pouvoir exécuter la version 32 bits.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. La version 32 bits s'exécute car le chemin d'accès au répertoire de la version 32 bits apparaît dans la variable d'environnement PATH avant le chemin d'accès au répertoire de la version 64 bits.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. (En général, le chemin du répertoire 32 bits est <lecteur>:\Program Files(x86)\Microsoft SQL Server\130\DTS\Binn, tandis que le chemin du répertoire 64 bits est <lecteur>:\Program Files\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.)

Note

Si vous utilisez SQL Server Agent pour exécuter l'utilitaire, il utilise automatiquement la version 64 bits de ce dernier.If you use SQL Server Agent to run the utility, SQL Server Agent automatically uses the 64-bit version of the utility. SQL Server Agent utilise le Registre, et non la variable d'environnement PATH, pour localiser le fichier exécutable correct de l'utilitaire.SQL Server Agent uses the registry, not the PATH environment variable, to locate the correct executable for the utility.

Pour vous assurer que vous exécutez la version 64 bits de l'utilitaire à l'invite de commandes, vous pouvez effectuer l'une des actions suivantes :To ensure that you run the 64-bit version of the utility at the command prompt, you can take one of the following actions:

  • Ouvrez une fenêtre d’invite de commandes, indiquez le répertoire qui contient la version 64 bits de l’utilitaire (<lecteur>:\Program Files\Microsoft SQL Server\130\DTS\Binn), puis exécutez celui-ci à partir de cet emplacement.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.

  • À l’invite de commandes, exécutez l’utilitaire en entrant le chemin complet (<lecteur>:\Program Files\Microsoft SQL Server\130\DTS\Binn) de la version 64 bits de l’utilitaire.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.

  • Modifiez de manière définitive l’ordre des chemins dans la variable d’environnement PATH en plaçant le chemin 64 bits (<lecteur>:\Program Files\Microsoft SQL Server\130\DTS\Binn) avant le chemin 32 bits (<lecteur>:\Program Files(x86)\Microsoft SQL Server\130\DTS\Binn) dans la variable.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.

SyntaxeSyntax

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

ParamètresParameters

OptionOption DescriptionDescription
/?/? Affiche les options d'invite de commandes.Displays the command prompt options.
/C[opy] location;destinationPathandPackageName/C[opy] location;destinationPathandPackageName Spécifie une copie sur un package SSISSSIS .Specifies a copy action on an SSISSSIS package. Pour utiliser ce paramètre, vous devez tout d’abord spécifier l’emplacement du package à l’aide de l’option /FI, /SQou /DT .Use of this parameter requires that you first specify the location of the package using the /FI, /SQ, or /DT option. Spécifiez ensuite le nom du package de destination de l'emplacement de destination.Next, specify the destination location destination package name. L’argument destinationPathandPackageName spécifie sur quel emplacement le package SSISSSIS est copié.The destinationPathandPackageName argument specifies where the SSISSSIS package is copied to. Si l'emplacement de destination location est SQL, les arguments DestUser, DestPassword et DestServer doivent être également spécifiés dans la commande.If the destination location is SQL, the DestUser, DestPassword and DestServer arguments must also be specified in the command.

Lorsque l'action Copy rencontre un package existant à l'emplacement de destination, dtutil invite l'utilisateur à confirmer la suppression du package.When the Copy action encounters an existing package at the destination, dtutil prompts the user to confirm package deletion. La réponse Y remplace le package et la réponse N termine le programme.The Y reply overwrites the package and the N reply ends the program. Lorsque la commande inclut l'argument Quiet , aucune invite n'apparaît et tout package existant est remplacé.When the command includes the Quiet argument, no prompt appears and any existing package is overwritten.
/Dec[rypt] password/Dec[rypt] password (Facultatif).(Optional). Définit le mot de passe de déchiffrement qui est utilisé lorsque vous chargez un package avec chiffrement de mot de passe.Sets the decryption password that is used when you load a package with password encryption.
/Del[ete]/Del[ete] Supprime le package spécifié par l'option SQL, DTS ou FILE .Deletes the package specified by the SQL, DTS or FILE option. Si dtutil ne peut pas supprimer le package, le programme prend fin.If dtutil cannot delete the package, the program ends.
/DestP[assword] password/DestP[assword] password Spécifie le mot de passe utilisé avec l'option SQL pour se connecter à une instance de SQL ServerSQL Server de destination avec l'authentification 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. Une erreur est générée si DESTPASSWORD est spécifié dans une ligne de commande qui n'inclut pas l'option DTSUSER .An error is generated if DESTPASSWORD is specified in a command line that does not include the DTSUSER option.

Remarque : Lorsque c'est possible, utilisez l'authentification Windows.When possible, use Windows Authentication..Note: Lorsque c'est possible, utilisez l'authentification Windows.When possible, use Windows Authentication..
/DestS[erver] server_instance/DestS[erver] server_instance Spécifie le nom du serveur utilisé avec une action qui entraîne l'enregistrement d'une destination dans SQL ServerSQL Server.Specifies the server name that is used with any action that causes a destination to be saved to SQL ServerSQL Server. Cette valeur sert à identifier un serveur non local ou autre que le serveur par défaut lors de l’enregistrement d’un package SSISSSIS .It is used to identify a non-local or non-default server when saving an SSISSSIS package. La spécification de DESTSERVER dans une ligne de commande sans action associée à SQL ServerSQL Serverconstitue une erreur.It is an error to specify DESTSERVER in a command line that does not have an action associated with SQL ServerSQL Server. Des actions telles que SIGN SQL, COPY SQLou MOVE SQL représentent des commandes appropriées à combiner avec cette option.Actions such as SIGN SQL, COPY SQL, or MOVE SQL options would be appropriate commands to combine with this option.

Un nom d'instance de SQL ServerSQL Server peut être spécifié en ajoutant à la suite du nom du serveur une barre oblique et le nom de l'instance.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 Spécifie le nom d’utilisateur qui est employé avec les options SIGN SQL, COPY SQLet MOVE SQL pour se connecter à une instance SQL ServerSQL Server qui utilise l’authentification 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. La spécification de DESTUSER dans une ligne de commande qui n'inclut pas l'option SIGN SQL, COPY SQLou MOVE SQL constitue une erreur.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 (Facultatif) Entraîne la suspension du processus spécifié, de l’utilitaire dtexec ou du processus dtsDebugHost.exe , ainsi que la création des fichiers de vidage de débogage, .mdmp et .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.

Remarque : Pour utiliser l’option /Dump, le droit d’utilisateur Déboguer les programmes doit vous être assigné (SeDebugPrivilege).Note: To use the /Dumpoption, you must be assigned the Debug Programs user right (SeDebugPrivilege).

Pour trouver le process ID du processus que vous souhaitez suspendre, utilisez le Gestionnaire des tâches de Windows.To find the process ID for the process that you want to pause, use Windows Task Manager.

Par défaut, Integration ServicesIntegration Services stocke les fichiers de vidage du débogage dans le dossier <lecteur>:\Program Files\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.

Pour plus d’informations sur l’utilitaire dtexec et le processus dtsDebugHost.exe , consultez Utilitaire dtexec et Génération, déploiement et débogage d’objets personnalisés.For more information about the dtexec utility and the dtsDebugHost.exe process, see dtexec Utility and Building, Deploying, and Debugging Custom Objects.

Pour plus d’informations sur les fichiers de vidage du débogage, consultez Générer des fichiers de vidage pour l’exécution des packages.For more information about debug dump files, see Generating Dump Files for Package Execution.

Remarque : Les fichiers de vidage du débogage peuvent contenir des informations sensibles.Note: Debug dump files may contain sensitive information. Utilisez une liste de contrôle d'accès (ACL, Access Control List) pour restreindre l'accès aux fichiers ou copiez ces derniers dans un dossier avec accès restreint.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 Spécifie que le package SSISSSIS à traiter se trouve dans le magasin de packages SSISSSIS .Specifies that the SSISSSIS package to be operated on is located in the SSISSSIS Package Store. L’argument filespec doit inclure le chemin du dossier en commençant à la racine du magasin de packages SSISSSIS .The filespec argument must include the folder path, starting with the root of the SSISSSIS Package Store. Par défaut, les noms des dossiers racine dans le fichier de configuration sont "MSDB" et "Système de fichiers".By default, the names of the root folders in the configuration file are "MSDB" and "File System." Les chemins d'accès qui contiennent un espace doivent être placés entre guillemets.Paths that contain a space must be delimited by using double quotation marks.

Si l'option DT[S] est spécifiée sur la même ligne de commande que l'une des options suivantes, une erreur DTEXEC_DTEXECERROR est retournée :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] (Facultatif).(Optional). Chiffre le package chargé avec le niveau de protection et le mot de passe spécifiés, puis l'enregistre à l'emplacement spécifié dans Path.Encrypts the loaded package with the specified protection level and password, and saves it to the location specified in Path. Le ProtectionLevel détermine si un mot de passe est requis.The ProtectionLevel determines whether a password is required.

SQL - Path est le nom du package de destination.SQL - Path is the destination package name.

FILE - Path est le chemin complet et le nom de fichier du package.FILE - Path is the fully-qualified path and file name for the package.

DTS - Cette option n’est actuellement pas prise en charge.DTS - This option is not supported currently.

OptionsProtectionLevel :ProtectionLevel options:

Niveau 0 : retire les informations sensibles.Level 0: Strips sensitive information.

Niveau 1 : les informations sensibles sont chiffrées en utilisant des informations d'identification de l'utilisateur local.Level 1: Sensitive information is encrypted by using local user credentials.

Niveau 2 : les informations sensibles sont chiffrées à l'aide du mot de passe requis.Level 2: Sensitive information is encrypted by using the required password.

Niveau 3 : le package est chiffré à l'aide du mot de passe requis.Level 3: Package is encrypted by using the required password.

Niveau 4 : le package est chiffré à l'aide des informations d'identification de l'utilisateur local.Level 4: Package is encrypted by using local user credentials.

Un package de niveau 5 utilise le chiffrement de stockage SQL ServerSQL Server .Level 5 Package uses SQL ServerSQL Server storage encryption.
/Ex[ists]/Ex[ists] (Facultatif).(Optional). Sert à déterminer si un package existe.Used to determine whether a package exists. dtutil tente de localiser le package spécifié à l'aide des options SQL, DTS ou FILE .dtutil tries to locate the package specified by either the SQL, DTS or FILE options. Si dtutil ne peut pas localiser le package spécifié, une erreur DTEXEC_DTEXECERROR est retournée.If dtutil cannot locate the package specified, a DTEXEC_DTEXECERROR is returned.
/FC[reate] {SQL | DTS};ParentFolderPath;NewFolderName/FC[reate] {SQL | DTS};ParentFolderPath;NewFolderName (Facultatif).(Optional). Crée un nouveau dossier portant le nom que vous avez spécifié dans NewFolderName.Create a new folder that has the name that you specified in NewFolderName. L'emplacement du nouveau dossier est indiqué par ParentFolderPath.The location of the new folder is indicated by the ParentFolderPath.
/FDe[lete] {SQL | DTS}[;ParentFolderPath;FolderName]/FDe[lete] {SQL | DTS}[;ParentFolderPath;FolderName] (Facultatif).(Optional). Supprime de SQL ServerSQL Server ou SSISSSIS le dossier qui a été spécifié par le nom dans FolderName.Deletes from SQL ServerSQL Server or SSISSSIS the folder that was specified by the name in FolderName. L'emplacement du dossier à supprimer est indiqué par 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] (Facultatif).(Optional). Répertorie le contenu, dossiers et packages, dans un dossier sur SSISSSIS ou SQL ServerSQL Server.Lists the contents, both folders and packages, in a folder on SSISSSIS or SQL ServerSQL Server. Le paramètre facultatif FolderPath spécifie le dossier dont vous voulez afficher le contenu.The optional FolderPath parameter specifies the folder that you want to view the content of. Le paramètre facultatif S spécifie que vous voulez afficher la liste du contenu des sous-dossiers du dossier indiqué dans 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 (Facultatif).(Optional). Vérifie si le dossier spécifié existe sur SSISSSIS ou SQL ServerSQL Server.Verifies if the specified folder exists on SSISSSIS or SQL ServerSQL Server. Le paramètre FolderPath représente le chemin et le nom de dossier à vérifier.The FolderPath parameter is the path and name of the folder to verify.
/Fi[le] filespec/Fi[le] filespec Cette option spécifie que le package SSISSSIS à traiter se trouve dans le système de fichiers.This option specifies that the SSISSSIS package to be operated on is located in the file system. La valeur filespec peut être fournie sous la forme d’un chemin UNC (Universal Naming Convention) ou d’un chemin local.The filespec value can be provided as either a Universal Naming Convention (UNC) path or local path.

Si l’option File est spécifiée sur la même ligne de commande que l’une des options suivantes, une erreur DTEXEC_DTEXECERROR est retournée :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] (Facultatif).(Optional). Renomme un dossier sur SSISSSIS ou SQL ServerSQL Server.Renames a folder on the SSISSSIS or SQL ServerSQL Server. ParentFolderPath constitue l'emplacement du dossier à renommer.The ParentFolderPath is the location of the folder to rename. OldFolderName correspond au nom actuel du dossier tandis que NewFolderName représente le nouveau nom à attribuer au dossier.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 Affiche une aide contextuelle qui indique les options dtutil et décrit leur utilisation.Displays text extensive help that shows the dtutil options and describes their use. Cet argument est facultatif.The option argument is optional. Si l'argument est inclus, le texte d'aide contient des informations détaillées sur l'option spécifiée.If the argument is included, the Help text includes detailed information about the specified option. L'exemple suivant affiche une aide pour toutes les options :The following example displays help for all options:

dtutil /H

Les deux exemples suivants illustrent l’utilisation de l’option /H pour afficher une aide étendue sur une option spécifique, l’option /Q [uiet] , dans cet exemple :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] Crée un nouvel identificateur global unique (GUID) pour le package et met à jour la propriété de l'ID du package.Creates a new GUID for the package and updates the package ID property. Lorsqu'un package est copié, l'ID du package ne change pas ; ainsi les fichiers journaux contiennent le même GUID pour les deux packages.When a package is copied, the package ID remains the same; therefore, the log files contain the same GUID for both packages. Cette action crée un nouveau GUID pour le package nouvellement copié, afin de le distinguer de l'original.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 Spécifie un déplacement sur un package SSISSSIS .Specifies a move action on an SSISSSIS package. Pour utiliser ce paramètre, vous devez tout d’abord spécifier l’emplacement du package à l’aide de l’option /FI, /SQou /DT .To use this parameter, first specify the location of the package using the /FI, /SQ, or /DT option. Spécifiez ensuite l'action Move .Next, specify the Move action. Cette action nécessite deux arguments, séparés par un point-virgule :This action requires two arguments, which are separated by a semicolon:

L'argument de destination peut spécifier SQL, FILEou DTS.The destination argument can specify SQL, FILE, or DTS. Une destination SQL peut comporter les options DESTUSER, DESTPASSWORDet DESTSERVER .A SQL destination can include the DESTUSER, DESTPASSWORD, and DESTSERVER options.

L’argument pathandname spécifie l’emplacement du package : SQL utilise le chemin et le nom du package, FILE utilise un UNC ou un chemin local tandis que DTS utilise un emplacement relatif à la racine du magasin de packages 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. Lorsque la destination est FILE ou DTS, l'argument path n'inclut pas le nom du fichier.When the destination is FILE or DTS, the path argument does not include the file name. Il utilise plutôt le nom du package à l'emplacement spécifié comme le nom de fichier.Instead, it uses the package name at the specified location as the file name.



Lorsque l'action MOVE rencontre un package existant à l'emplacement de destination, dtutil vous invite à confirmer le remplacement du package.When the MOVE action encounters an existing package at the destination, dtutil prompts you to confirm that you want to overwrite the package. La réponse Y remplace le package et la réponse N termine le programme.The Y reply overwrites the package and the N reply ends the program. Lorsque la commande inclut l'option QUIET , aucune invite n'apparaît et tout package existant est remplacé.When the command includes the QUIET option, no prompt appears and any existing package is overwritten.
/Q[uiet]/Q[uiet] Arrête les invites de confirmation pouvant apparaître lorsqu'une commande incluant l'option COPY, MOVEou SIGN est exécutée.Stops the confirmation prompts that can appear when a command including the COPY, MOVE, or SIGN option is executed. Ces invites apparaissent si un package portant le même nom que le package spécifié existe déjà sur l'ordinateur de destination ou si le package spécifié est déjà signé.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 Ajoute un commentaire à la ligne de commande.Adds a comment to the command line. L'argument de commentaire est facultatif.The comment argument is optional. Si le texte du commentaire inclut les espaces, il est mis entre guillemets.If the comment text includes spaces, the text must be enclosed in quotation marks. Vous pouvez inclure plusieurs options REM dans une ligne de commande.You can include multiple REM options in a command line.
/Si[gn] {SQL | File | DTS}; path; hash/Si[gn] {SQL | File | DTS}; path; hash Signe un package SSISSSIS .Signs an SSISSSIS package. Cette action utilise trois arguments requis, séparés par des point-virgules ; destination, path et hash :This action uses three required arguments, which are separated by semicolons; destination, path, and hash:

L'argument de destination peut spécifier SQL, FILEou DTS.The destination argument can specify SQL, FILE, or DTS. Une destination SQL peut comporter les options DESTUSER, DESTPASSWORD et DESTSERVER .A SQL destination can include the DESTUSER, DESTPASSWORD and DESTSERVER options.

L'argument path spécifie l'emplacement du package à traiter.The path argument specifies the location of the package to take action on.

L'argument hash spécifie un identificateur de certificat exprimé en tant que chaîne hexadécimale de longueur variable.The hash argument specifies a certificate identifier expressed as a hexadecimal string of varying length.

Pour plus d’informations, consultez Identifier la source de packages à l’aide de signatures numériques.For more information, see Identify the Source of Packages with Digital Signatures.



** Important *\* Lorsqu’il est configuré pour vérifier la signature du package, Integration ServicesIntegration Services vérifie seulement si la signature numérique est présente, si elle est valide et si elle provient d’une source approuvée.** 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 Services ne vérifie pas si le package a été modifié. does not check whether the package has been changed.
/SourceP[assword] password/SourceP[assword] password Spécifie le mot de passe utilisé avec les options SQL et SOURCEUSER pour permettre la récupération d'un package SSISSSIS qui est stocké dans une base de données, sur une instance de SQL ServerSQL Server qui utilise l'authentification 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. La spécification de SOURCEPASSWORD dans une ligne de commande qui n'inclut pas l'option SOURCEUSER constitue une erreur.It is an error to specify SOURCEPASSWORD in a command line that does not include the SOURCEUSER option.

Remarque : Lorsque c'est possible, utilisez l'authentification Windows.When possible, use Windows Authentication.Note: Lorsque c'est possible, utilisez l'authentification Windows.When possible, use Windows Authentication.
/SourceS[erver] server_instance/SourceS[erver] server_instance Spécifie le nom du serveur qui est utilisé avec l'option SQL pour permettre l'extraction d'un package SSISSSIS qui est stocké dans 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. La spécification de SOURCESERVER dans une ligne de commande qui n'inclut pas l'option SIGN SQL, COPY SQLou MOVE SQL constitue une erreur.It is an error to specify SOURCESERVER in a command line that does not include the SIGN SQL, COPY SQL, or MOVE SQL option.

Un nom d'instance de SQL ServerSQL Server peut être spécifié en ajoutant à la suite du nom du serveur une barre oblique et le nom de l'instance.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 Spécifie le nom d'utilisateur qui est employé avec les options SOURCESERVER pour permettre l'extraction d'un package SSISSSIS , d'un package SQL ServerSQL Server stocké dans 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. La spécification de SOURCEUSER dans une ligne de commande qui n'inclut pas l'option SIGN SQL, COPY SQLou MOVE SQL constitue une erreur.It is an error to specify SOURCEUSER in a command line that does not include the SIGN SQL, COPY SQL, or MOVE SQL option.

Remarque : Lorsque c'est possible, utilisez l'authentification Windows.When possible, use Windows Authentication.Note: Lorsque c'est possible, utilisez l'authentification Windows.When possible, use Windows Authentication.
/SQ[L] package_path/SQ[L] package_path Spécifie l'emplacement d'un package SSISSSIS .Specifies the location of an SSISSSIS package. Cette option indique que le package est stocké dans la base de données msdb .This option indicates that the package is stored in the msdb database. L’argument package_path spécifie le chemin et le nom du package SSISSSIS .The package_path argument specifies the path and name of the SSISSSIS package. Les noms de dossier se terminent par des barres obliques inverses.Folder names are terminated with back slashes.

Si l’option SQL est spécifiée sur la même ligne de commande que l’une des options suivantes, une erreur DTEXEC_DTEXECERROR est retournée :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'option SQL peut être accompagnée de zéro ou d'une instance des options suivantes :The SQL option may be accompanied by zero or one instance of the following options:

SOURCEUSERSOURCEUSER

SOURCEPASSWORDSOURCEPASSWORD

SOURCESERVERSOURCESERVER



Si SOURCEUSERNAME n'est pas inclus, l'authentification Windows est utilisée pour accéder au package.If SOURCEUSERNAME is not included, Windows Authentication is used to access the package. SOURCEPASSWORD est autorisé uniquement si SOURCEUSER est présent.SOURCEPASSWORD is allowed only if SOURCEUSER is present. Si l'option SOURCEPASSWORD n'est pas incluse, un mot de passe vide est employé.If SOURCEPASSWORD is not included, a blank password is used.

** Important *\* N'utilisez pas de mot de passe vide.Do not use a blank password. Utilisez un mot de passe fort.Use a strong password.** Important *\* N'utilisez pas de mot de passe vide.Do not use a blank password. Utilisez un mot de passe fort.Use a strong password.

Codes de sortie dtutildtutil Exit Codes

L'utilitairedtutil définit un code de sortie qui vous alerte lorsque des erreurs de syntaxe sont détectées, des arguments incorrects sont employés ou des combinaisons non valides d'options sont spécifiées.dtutil sets an exit code that alerts you when syntax errors are detected, incorrect arguments are used, or invalid combinations of options are specified. Dans le cas contraire, l'utilitaire signale « L'opération s'est terminée avec succès ». Le tableau ci-dessous répertorie les valeurs que l'utilitaire dtutil peut définir lors de sa fermeture.Otherwise, the utility reports "The operation completed successfully".The following table lists the values that the dtutil utility can set when exiting.

ValeurValue DescriptionDescription
00 L'utilitaire s'est exécuté avec succès.The utility executed successfully.
11 L'utilitaire a échoué.The utility failed.
44 L'utilitaire ne peut pas localiser le package demandé.The utility cannot locate the requested package.
55 L'utilitaire ne peut pas charger le package demandé.The utility cannot load the requested package
66 L'utilitaire ne peut pas résoudre la ligne de commande car elle comporte des erreurs syntaxiques ou sémantiques.The utility cannot resolve the command line because it contains either syntactic or semantic errors.

Notes Remarks

Vous ne pouvez pas utiliser de fichiers de commandes ou une redirection avec dtutil.You cannot use command files or redirection with dtutil.

L'ordre des options dans la ligne de commande n'est pas significatif.The order of the options within the command line is not significant.

ExemplesExamples

Les exemples suivants présentent de façon détaillée des scénarios classiques d'utilisation de ligne de commande.The following examples detail typical command line usage scenarios.

Exemples de copieCopy Examples

Pour copier dans le magasin de packages SSIS un package stocké au sein de la base de données msdb , elle-même présente sur une instance locale de SQL ServerSQL Server qui utilise l'authentification Windows, employez la syntaxe suivante :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   

Pour copier un package d'un emplacement sur le système de fichiers dans un autre emplacement et renommer la copie, utilisez la syntaxe suivante :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  

Pour copier un package sur le système de fichiers local dans une instance de SQL ServerSQL Server hébergée sur un autre ordinateur, utilisez la syntaxe suivante :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  

Dans la mesure où les options /DestU[ser] et /DestP[assword] n’ont pas été utilisées, l’utilisation de l’authentification Windows est implicite.Because the /DestU[ser] and /DestP[assword] options were not used, Windows Authentication is assumed.

Pour créer un ID destiné à un package nouvellement copié, utilisez la syntaxe suivante :To create a new ID for a package after it is copied, use the following syntax:

dtutil /I /FILE copiedpkg.dtsx   

Pour créer un ID destiné à tous les packages d'un dossier spécifique, utilisez la syntaxe suivante :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  

Utilisez un signe de pourcentage unique (%) lorsque vous tapez la commande à partir de l'inviteUse a single percent sign (%) when typing the command at the command prompt. et utilisez un signe de pourcentage double (%%) si la commande est utilisée à l'intérieur d'un fichier de commandes.Use a double percent sign (%%) if the command is used inside a batch file.

Exemples de suppressionDelete Examples

Pour supprimer un package stocké dans la base de données msdb sur une instance de SQL ServerSQL Server qui utilise l'authentification Windows, employez la syntaxe suivante :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  

Pour supprimer un package stocké dans la base de données msdb sur une instance de SQL ServerSQL Server qui utilise l'authentification SQL ServerSQL Server , employez la syntaxe suivante :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  

Note

Pour supprimer un package d'un serveur nommé, incluez l'option SOURCESERVER et son argument.To delete a package from a named server, include the SOURCESERVER option and its argument. Vous pouvez spécifier un serveur uniquement par le biais de l'option SQL .You can only specify a server by using the SQL option.

Pour supprimer un package stocké dans le magasin des packages SSIS, utilisez la syntaxe suivante :To delete a package that is stored in the SSIS Package Store, use the following syntax:

dtutil /DTS delPackage.dtsx /DELETE  

Pour supprimer un package stocké dans le système de fichiers, utilisez la syntaxe suivante :To delete a package that is stored in the file system, use the following syntax:

dtutil /FILE c:\delPackage.dtsx /DELETE  

Exemples d'ExistsExists Examples

Pour déterminer si un package existe dans la base de données msdb sur une instance locale de SQL ServerSQL Server qui utilise l'authentification Windows, employez la syntaxe suivante :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  

Pour déterminer si un package existe dans la base de données msdb sur une instance locale de SQL ServerSQL Server qui utilise l'authentification SQL ServerSQL Server , employez la syntaxe suivante :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  

Note

Pour déterminer si un package existe sur un serveur nommé, incluez l'option SOURCESERVER et son argument.To determine whether a package exists on a named server, include the SOURCESERVER option and its argument. Vous pouvez uniquement spécifier un serveur en utilisant l'option SQL.You can only specify a server by using the SQL option.

Pour déterminer si un package existe dans le magasin de packages local, utilisez la syntaxe suivante :To determine whether a package exists in the local package store, use the following syntax:

dtutil /DTS srcPackage.dtsx /EXISTS  

Pour déterminer si un package existe dans le système de fichiers local, utilisez la syntaxe suivante :To determine whether a package exists in the local file system, use the following syntax:

dtutil /FILE c:\srcPackage.dtsx /EXISTS  

Exemples de MoveMove Examples

Pour déplacer un package stocké dans le magasin de packages SSIS vers la base de données msdb , elle-même située sur une instance locale de SQL ServerSQL Server qui utilise l'authentification Windows, employez la syntaxe suivante :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  

Pour déplacer un package stocké dans la base de données msdb , elle-même située sur une instance locale de SQL ServerSQL Server qui utilise l'authentification SQL ServerSQL Server , vers la base de données msdb située sur une autre instance locale de SQL ServerSQL Server qui utilise l'authentification SQL ServerSQL Server , employez la syntaxe suivante :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  

Note

Pour déplacer un package d'un serveur nommé à un autre, incluez les options SOURCES et DESTS , ainsi que leurs arguments.To move a package from one named server to another, include the SOURCES and the DESTS option and their arguments. Vous ne pouvez spécifier des serveurs qu'à l'aide de l'option SQL .You can only specify servers by using the SQL option.

Pour déplacer un package stocké dans le magasin des packages SSIS, employez la syntaxe suivante :To move a package that is stored in the SSIS Package Store, use the following syntax:

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

Pour déplacer un package qui est stocké dans le système de fichiers, employez la syntaxe suivante :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  

Exemples de SignSign Examples

Pour signer un package qui est stocké dans une base de données SQL ServerSQL Server sur une instance locale de SQL ServerSQL Server qui utilise l'authentification Windows, utilisez la syntaxe suivante :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  

Pour obtenir des informations concernant votre certificat, utilisez CertMgr.To locate information about your certificate, use CertMgr. Le code de hachage peut être affiché dans l'utilitaire CertMgr en sélectionnant le certificat, puis en cliquant sur Afficher pour afficher les propriétés.The hash code can be viewed in the CertMgr utility by selecting the certificate, and then clicking View to view the properties. L'onglet Détails fournit des informations supplémentaires sur le certificat.The Details tab provides more information about the certificate. La propriété Thumbprint est utilisée comme valeur de hachage, sans les espaces.The Thumbprint property is used as the hash value, with spaces removed.

Note

Le hachage utilisé dans l'exemple ci-dessus n'est pas un hachage véritable.The hash used in this example is not a real hash.

Pour plus d'informations, consultez la section « CertMgr » de l'article (en anglais) « Signing and Checking Code with Authenticode» (signature et vérification du code à l'aide d'Authenticode).For more information, see the CertMgr section in Signing and Checking Code with Authenticode.

Exemples d'EncryptEncrypt Examples

L'exemple suivant chiffre le fichier PackageToEncrypt.dtsx dans le fichier EncryptedPackage.dts en utilisant un chiffrement de package complet, avec un mot de passe.The following sample encrypts the file-based PackageToEncrypt.dtsx to the file-based EncryptedPackage.dts using full package encryption, with a password. Le mot de passe qui est utilisé pour le chiffrement est EncPswd.The password that is used for the encryption is EncPswd.

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

Voir aussiSee Also

Exécuter des packages Integration Services (SSIS)Run Integration Services (SSIS) Packages