utilitário dtutildtutil Utility

O utilitário de prompt de comando dtutil é usado para gerenciar pacotes do SQL ServerSQL Server Integration ServicesIntegration Services .The dtutil command prompt utility is used to manage SQL ServerSQL Server Integration ServicesIntegration Services packages. O utilitário pode copiar, mover, excluir ou verificar a existência de um pacote.The utility can copy, move, delete, or verify the existence of a package. Essas ações podem ser desenvolvidas em qualquer pacote do SSISSSIS que esteja armazenado em um dos três locais: um banco de dados do MicrosoftMicrosoft SQL ServerSQL Server , o Armazenamento de Pacotes SSISSSIS e o sistema de arquivos.These actions can be performed on any SSISSSIS package that is stored in one of three locations: a MicrosoftMicrosoft SQL ServerSQL Server database, the SSISSSIS Package Store, and the file system. Se o utilitário acessar um pacote armazenado em msdb, o prompt de comando poderá exigir um nome de usuário e uma senha.If the utility accesses a package that is stored in msdb, the command prompt may require a user name and a password. Se a instância do SQL ServerSQL Server usar Autenticação de SQL ServerSQL Server , o prompt de comando solicitará um nome de usuário e uma senha.If the instance of SQL ServerSQL Server uses SQL ServerSQL Server Authentication, the command prompt requires both a user name and a password. Se o nome de usuário estiver ausente, o dtutil tentará fazer logon no SQL ServerSQL Server usando a Autenticação do Windows.If the user name is missing, dtutil tries to log on to SQL ServerSQL Server using Windows Authentication. O tipo de armazenamento do pacote é identificado pelas opções /SQL, /FILEe /DTS .The storage type of the package is identified by the /SQL, /FILE, and /DTS options.

O utilitário do prompt de comando dtutil não aceita o uso de arquivos de comando ou redirecionamento.The dtutil command prompt utility does not support the use of command files or redirection.

O utilitário do prompt de comando dtutil inclui os seguintes recursos:The dtutil command prompt utility includes the following features:

  • Comentários no prompt de comando, que tornam a ação do prompt de comando autodocumentada e mais fácil de compreender.Remarks in the command prompt, which makes the command prompt action self-documenting and easier to understand.

  • Proteção contra substituição, para solicitar uma confirmação antes de substituir um pacote existente quando você estiver copiando ou movendo pacotes.Overwrite protection, to prompt for a confirmation before overwriting an existing package when you are copying or moving packages.

  • Ajuda de console, para fornecer informações sobre as opções de comando para dtutil.Console help, to provide information about the command options for dtutil.

Observação

Muitas das operações executadas pelo dtutil também podem ser executadas visualmente no SQL Server Management StudioSQL Server Management Studio quando você está conectado a uma instância do 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. Para obter mais informações, consulte Gerenciamento de pacotes (Serviço SSIS).For more information, see Package Management (SSIS Service).

As opções podem ser digitadas em qualquer ordem.The options can be typed in any order. O caractere de pipe ("|") é o operador OR e é usado para mostrar possíveis valores.The pipe ("|") character is the OR operator and is used to show possible values. Você deve usar uma das opções delimitadas pelo pipe OR .You must use one of the options that are delimited by the OR pipe.

Todas as opções devem iniciar com uma barra (/) ou um sinal de menos (-).All options must start with a slash (/) or a minus sign (-). Porém, não inclua um espaço em branco entre a barra ou o sinal de menos e o texto da opção. Se isso for feito, ocorrerá uma falha no comando.However, do not include a space between the slash or minus sign and the text for the option; otherwise, the command will fail.

Os argumentos devem ser cadeias de caracteres que sejam colocadas entre aspas ou que não contenham espaços em branco.Arguments must be strings that are either enclosed in quotation marks or contain no white space.

Aspas duplas dentro de cadeias de caracteres que são colocadas entre aspas representam aspas simples.Double quotation marks within strings that are enclosed in quotation marks represent escaped single quotation marks.

Opções e argumentos, excetos em senhas, não diferenciam maiúsculas e minúsculas.Options and arguments, except for passwords, are not case sensitive.

Considerações sobre a instalação em computadores de 64 bitsInstallation Considerations on 64-bit Computers

Em um computador de 64 bits, o Integration ServicesIntegration Services instala a versão de 64 bits dos utilitários dtexec (dtexec.exe) e 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). Para instalar versões de 32 bits dessas ferramentas do Integration ServicesIntegration Services , você deve selecionar Ferramentas de Cliente ou SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) durante a instalação.To install 32-bit versions of these Integration ServicesIntegration Services tools, you must select either Client Tools or SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) during setup.

Por padrão, um computador de 64 bits que tem as versões de 64 e de 32 bits de um prompt de comando do Integration ServicesIntegration Services instaladas executará a versão de 32 bits no prompt de comando.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. A versão de 32 bits é executada porque o caminho do diretório da versão de 32 bits aparece na variável de ambiente PATH antes do caminho do diretório da versão de 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. (Normalmente, o caminho do diretório de 32 bits é <drive >: \Program arquivos (x86) server\130\dts\binn, enquanto o caminho do diretório de 64 bits é <drive >: \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.)

Observação

Se você usar o SQL Server Agent para executar o utilitário, o SQL Server Agent usará automaticamente a versão de 64 bits do utilitário.If you use SQL Server Agent to run the utility, SQL Server Agent automatically uses the 64-bit version of the utility. O SQL Server Agent usa o Registro, não a variável de ambiente PATH, para localizar o executável correto do utilitário.SQL Server Agent uses the registry, not the PATH environment variable, to locate the correct executable for the utility.

Para garantir que a versão de 64 bits do utilitário no prompt de comando seja executada, execute uma das seguintes ações:To ensure that you run the 64-bit version of the utility at the command prompt, you can take one of the following actions:

  • Abra uma janela de Prompt de comando, altere para o diretório que contém a versão de 64 bits do utilitário (<drive >: \Program Files\Microsoft SQL Server\130\DTS\Binn), e, em seguida, execute o utilitário nesse local.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.

  • No prompt de comando, execute o utilitário digitando o caminho completo (<drive >: \Program Files\Microsoft SQL Server\130\DTS\Binn) para a versão de 64 bits do utilitário.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.

  • Altere permanentemente a ordem dos caminhos na variável de ambiente PATH colocando o caminho de 64 bits (<drive >: \Program Files\Microsoft SQL Server\130\DTS\Binn) antes do caminho de 32 bits (<drive >: \ Arquivos (x86) server\130\dts\binn de programa) na variável.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.

SintaxeSyntax

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

ParâmetrosParameters

OpçãoOption DescriptionDescription
/?/? Exibe as opções do prompt de comando.Displays the command prompt options.
/C[opy] location;destinationPathandPackageName/C[opy] location;destinationPathandPackageName Especifica uma ação de cópia em um pacote SSISSSIS .Specifies a copy action on an SSISSSIS package. O uso desse parâmetro requer que você especifique primeiro o local do pacote usando a opção /FI, /SQou /DT .Use of this parameter requires that you first specify the location of the package using the /FI, /SQ, or /DT option. Em seguida, especifique o nome de pacote do destino local.Next, specify the destination location destination package name. O argumento destinationPathandPackageName especifica onde o pacote SSISSSIS é copiado.The destinationPathandPackageName argument specifies where the SSISSSIS package is copied to. Se o location de destino for SQL, os argumentos DestUser, DestPassword e DestServer também deverão ser especificados no comando.If the destination location is SQL, the DestUser, DestPassword and DestServer arguments must also be specified in the command.

Quando a ação Copy encontra um pacote existente no destino, o dtutil solicita que o usuário confirme a exclusão do pacote.When the Copy action encounters an existing package at the destination, dtutil prompts the user to confirm package deletion. A resposta Y substitui o pacote e N encerra o programa.The Y reply overwrites the package and the N reply ends the program. Quando o comando inclui o argumento Quiet , nenhum prompt aparece e todos os pacotes existentes são substituídos.When the command includes the Quiet argument, no prompt appears and any existing package is overwritten.
/Dec[rypt] password/Dec[rypt] password (Opcional).(Optional). Define a senha de decodificação usada ao carregar um pacote com criptografia de senha.Sets the decryption password that is used when you load a package with password encryption.
/Del[ete]/Del[ete] Exclui o pacote especificado pelo SQL, DTS ou pela opção FILE .Deletes the package specified by the SQL, DTS or FILE option. Se dtutil não puder excluir o pacote, o programa será encerrado.If dtutil cannot delete the package, the program ends.
/DestP[assword] password/DestP[assword] password Especifica a senha usada com a opção SQL para estabelecer conexão com uma instância de destino do SQL ServerSQL Server usando a Autenticação do 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. Ocorrerá um erro caso DESTPASSWORD seja especificado em uma linha de comando que não inclui a opção DTSUSER .An error is generated if DESTPASSWORD is specified in a command line that does not include the DTSUSER option.

Observação: Quando possível, use a Autenticação do Windows.When possible, use Windows Authentication..Note: Quando possível, use a Autenticação do Windows.When possible, use Windows Authentication..
/DestS[erver] server_instance/DestS[erver] server_instance Especifica o nome do servidor usado com qualquer ação que faça com que um destino seja salvo no SQL ServerSQL Server.Specifies the server name that is used with any action that causes a destination to be saved to SQL ServerSQL Server. É usado para identificar um servidor não local ou não padrão ao salvar um pacote SSISSSIS .It is used to identify a non-local or non-default server when saving an SSISSSIS package. É um erro especificar DESTSERVER em uma linha de comando que não tem uma ação associada ao SQL ServerSQL Server.It is an error to specify DESTSERVER in a command line that does not have an action associated with SQL ServerSQL Server. Ações como SIGN SQL, COPY SQLou opções MOVE SQL seriam comandos apropriados para a combinação com essa opção.Actions such as SIGN SQL, COPY SQL, or MOVE SQL options would be appropriate commands to combine with this option.

Um nome de instância do SQL ServerSQL Server pode ser especificado adicionando uma barra invertida e o nome de instância ao nome do servidor.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 Especifica o nome de usuário usado com as opções SIGN SQL, COPY SQLe MOVE SQL para estabelecer conexão com uma instância do SQL ServerSQL Server que usa a Autenticação do 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. É um erro especificar DESTUSER em uma linha de comando que não inclui a opção SIGN SQL, COPY SQLou MOVE SQL .It is an error to specify DESTUSER in a command line that does not include the SIGN SQL, COPY SQL, or MOVE SQL option.
/Dump process ID/Dump process ID (Opcional.) Faz com que o processo especificado, o utilitário dtexec ou o processo dtsDebugHost.exe , faça uma pausa e crie os arquivos de despejo de depuração, .mdmp e .tmp.(Optional) Causes the specified process, either the dtexec utility or the dtsDebugHost.exe process, to pause and create the debug dump files, .mdmp and .tmp.

Observação: para usar a opção /Dump, é preciso ter direitos de usuário de Programas de Depuração (SeDebugPrivilege).Note: To use the /Dumpoption, you must be assigned the Debug Programs user right (SeDebugPrivilege).

Para localizar o process ID para o processo que você deseja pausar, use o Gerenciador de Tarefas do Windows.To find the process ID for the process that you want to pause, use Windows Task Manager.

Por padrão, Integration ServicesIntegration Services armazena os arquivos de despejo de depuração na pasta, <drive >: \Program Files\Microsoft Server\130\Shared\ErrorDumps SQL.By default, Integration ServicesIntegration Services stores the debug dump files in the folder, <drive>:\Program Files\Microsoft SQL Server\130\Shared\ErrorDumps.

Para saber mais sobre o utilitário dtexec e o processo dtsDebugHost.exe , consulte dtexec Utility e Building, Deploying, and Debugging Custom Objects.For more information about the dtexec utility and the dtsDebugHost.exe process, see dtexec Utility and Building, Deploying, and Debugging Custom Objects.

Para obter mais informações sobre os arquivos de despejo de depuração, consulte Generating Dump Files for Package Execution.For more information about debug dump files, see Generating Dump Files for Package Execution.

Observação: os arquivos de despejo de depuração podem conter informações confidenciais.Note: Debug dump files may contain sensitive information. Use uma ACL (lista de controle de acesso) para restringir o acesso aos arquivos ou copie os arquivos em uma pasta que tenha acesso restrito.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 Especifica que o pacote SSISSSIS a ser operado está no Armazenamento de Pacotes SSISSSIS .Specifies that the SSISSSIS package to be operated on is located in the SSISSSIS Package Store. O argumento filespec deve incluir o caminho da pasta, iniciando pela raiz do Repositório de Pacotes SSISSSIS .The filespec argument must include the folder path, starting with the root of the SSISSSIS Package Store. Por padrão, os nomes das pastas raiz no arquivo de configuração são "MSDB" e "File System".By default, the names of the root folders in the configuration file are "MSDB" and "File System." Os caminhos que contêm um espaço devem ser delimitados usando aspas duplas.Paths that contain a space must be delimited by using double quotation marks.

Se a opção DT[S] for especificada na mesma linha de comando como qualquer uma das opções a seguir, DTEXEC_DTEXECERROR será retornado: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] (Opcional).(Optional). Criptografa o pacote carregado com o nível de proteção e senha especificados e o salva no local especificado em Path.Encrypts the loaded package with the specified protection level and password, and saves it to the location specified in Path. O ProtectionLevel determina se é obrigatório o uso de uma senha.The ProtectionLevel determines whether a password is required.

SQL – Caminho é o nome do pacote de destino.SQL - Path is the destination package name.

FILE – Caminho é o caminho completamente qualificado e o nome de arquivo do pacote.FILE - Path is the fully-qualified path and file name for the package.

DTS – Não há suporte para esta opção atualmente.DTS - This option is not supported currently.

Opções doProtectionLevel :ProtectionLevel options:

Nível 0: extrai informações confidenciais.Level 0: Strips sensitive information.

Nível 1: as informações confidenciais são criptografadas usando as credenciais de usuários locais.Level 1: Sensitive information is encrypted by using local user credentials.

Nível 2: as informações confidenciais são criptografadas usando uma senha obrigatória.Level 2: Sensitive information is encrypted by using the required password.

Nível 3: o pacote é criptografado usando uma senha obrigatória.Level 3: Package is encrypted by using the required password.

Nível 4: o pacote é criptografado usando as credenciais de usuários locais.Level 4: Package is encrypted by using local user credentials.

Nível 5: o pacote usa criptografia de armazenamento do SQL ServerSQL Server .Level 5 Package uses SQL ServerSQL Server storage encryption.
/Ex[ists]/Ex[ists] (Opcional).(Optional). Usado para determinar se existe um pacote.Used to determine whether a package exists. dtutil tenta localizar o pacote especificado pelas opções SQL, DTS ou FILE .dtutil tries to locate the package specified by either the SQL, DTS or FILE options. Se dtutil não puder localizar o pacote especificado, DTEXEC_DTEXECERROR será retornado.If dtutil cannot locate the package specified, a DTEXEC_DTEXECERROR is returned.
/FC[reate] {SQL | DTS};ParentFolderPath;NewFolderName/FC[reate] {SQL | DTS};ParentFolderPath;NewFolderName (Opcional).(Optional). Crie uma nova pasta com o nome que você especificou em NewFolderName.Create a new folder that has the name that you specified in NewFolderName. O local da nova pasta é indicado pelo ParentFolderPath.The location of the new folder is indicated by the ParentFolderPath.
/FDe[lete] {SQL | DTS}[;ParentFolderPath;FolderName]/FDe[lete] {SQL | DTS}[;ParentFolderPath;FolderName] (Opcional).(Optional). Exclui do SQL ServerSQL Server ou SSISSSIS a pasta que foi especificada pelo nome em FolderName.Deletes from SQL ServerSQL Server or SSISSSIS the folder that was specified by the name in FolderName. O local da pasta a ser excluída é indicado pelo 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] (Opcional).(Optional). Lista os conteúdos, tanto de pastas quanto de pacotes, em uma pasta no SSISSSIS ou no SQL ServerSQL Server.Lists the contents, both folders and packages, in a folder on SSISSSIS or SQL ServerSQL Server. O parâmetro opcional FolderPath especifica a pasta da qual você deseja exibir o conteúdo.The optional FolderPath parameter specifies the folder that you want to view the content of. O parâmetro opcional S especifica que você deseja exibir uma listagem do conteúdo das subpastas da pasta especificada no 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 (Opcional).(Optional). Verifica se a pasta especificada existe no SSISSSIS ou no SQL ServerSQL Server.Verifies if the specified folder exists on SSISSSIS or SQL ServerSQL Server. O parâmetro FolderPath é o caminho e o nome da pasta a ser verificada.The FolderPath parameter is the path and name of the folder to verify.
/Fi[le] filespec/Fi[le] filespec Essa opção especifica que o pacote SSISSSIS a ser operado está no sistema de arquivos.This option specifies that the SSISSSIS package to be operated on is located in the file system. O valor filespec pode ser fornecido como caminho local ou caminho UNC (Convenção de Nomenclatura Universal).The filespec value can be provided as either a Universal Naming Convention (UNC) path or local path.

Se a opção File for especificada na mesma linha de comando como qualquer uma das opções a seguir, DTEXEC_DTEXECERROR será retornado: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] (Opcional).(Optional). Renomeia uma pasta no SSISSSIS ou no SQL ServerSQL Server.Renames a folder on the SSISSSIS or SQL ServerSQL Server. ParentFolderPath é o local da pasta a ser renomeada.The ParentFolderPath is the location of the folder to rename. OldFolderName é o nome atual da pasta e NewFolderName é o novo nome a ser definido para a pasta.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 Exibe texto de ajuda extenso que mostra as opções do dtutil e descreve seu uso.Displays text extensive help that shows the dtutil options and describes their use. O argumento da opção é opcional.The option argument is optional. Se o argumento for incluído, o texto de Ajuda incluirá informações detalhadas sobre a opção especificada.If the argument is included, the Help text includes detailed information about the specified option. O exemplo a seguir exibe a ajuda para todas as opções:The following example displays help for all options:

dtutil /H

Os dois exemplos a seguir mostram como usar a opção /H para exibir a ajuda estendida para uma opção específica, a opção /Q [uiet] , neste exemplo: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] Cria um novo GUID para o pacote e atualiza a propriedade ID do pacote.Creates a new GUID for the package and updates the package ID property. Quando um pacote é copiado, a ID do pacote permanece a mesma; portanto, os arquivos de log contêm o mesmo GUID para ambos os pacotes.When a package is copied, the package ID remains the same; therefore, the log files contain the same GUID for both packages. Essa ação cria um novo GUID para o pacote copiado recentemente para distingui-lo do 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 Especifica uma ação de movimentação em um pacote SSISSSIS .Specifies a move action on an SSISSSIS package. Para usar esse parâmetro, primeiro especifique o local do pacote usando a opção /FI, /SQou /DT .To use this parameter, first specify the location of the package using the /FI, /SQ, or /DT option. Em seguida, especifique a ação Mover .Next, specify the Move action. Essa ação requer dois argumentos que são separados por um ponto-e-vírgula:This action requires two arguments, which are separated by a semicolon:

O argumento de destino pode especificar SQL, FILEou DTS.The destination argument can specify SQL, FILE, or DTS. Um destino SQL pode incluir as opções DESTUSER, DESTPASSWORDe DESTSERVER .A SQL destination can include the DESTUSER, DESTPASSWORD, and DESTSERVER options.

O argumento pathandname especifica o local do pacote: SQL usa o caminho e o nome do pacote, FILE usa um caminho UNC ou local e DTS usa um local que está relacionado à raiz do Repositório de Pacotes 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. Quando o destino for FILE ou DTS, o argumento de caminho não inclui o nome de arquivo.When the destination is FILE or DTS, the path argument does not include the file name. Em vez disso, ele usa o nome do pacote no local especificado como o nome de arquivo.Instead, it uses the package name at the specified location as the file name.



Quando a ação MOVER encontra um pacote existente no destino, o dtutil solicita que você confirme a substituição do pacote.When the MOVE action encounters an existing package at the destination, dtutil prompts you to confirm that you want to overwrite the package. A resposta Y substitui o pacote e N encerra o programa.The Y reply overwrites the package and the N reply ends the program. Quando o comando inclui a opção QUIET , nenhum prompt aparece e todos os pacotes existentes são substituídos.When the command includes the QUIET option, no prompt appears and any existing package is overwritten.
/Q[uiet]/Q[uiet] Para as solicitações de confirmação que podem aparecer quando um comando que inclui a opção COPY, MOVEou SIGN é executado.Stops the confirmation prompts that can appear when a command including the COPY, MOVE, or SIGN option is executed. Essas solicitações aparecem se um pacote com o mesmo nome do pacote especificado já existir no computador de destino ou se o pacote especificado já estiver assinado.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 Adiciona um comentário à linha de comando.Adds a comment to the command line. O argumento de comentário é opcional.The comment argument is optional. Se o texto de comentário incluir espaços, ele deverá ser colocado entre aspas.If the comment text includes spaces, the text must be enclosed in quotation marks. Você pode incluir várias opções REM em uma linha de comando.You can include multiple REM options in a command line.
/Si[gn] {SQL | File | DTS}; path; hash/Si[gn] {SQL | File | DTS}; path; hash Assina um pacote SSISSSIS .Signs an SSISSSIS package. Essa ação usa três argumentos necessários que são separados por ponto-e-vírgula; destination, path e hash:This action uses three required arguments, which are separated by semicolons; destination, path, and hash:

O argumento de destino pode especificar SQL, FILEou DTS.The destination argument can specify SQL, FILE, or DTS. Um destino SQL pode incluir as opções DESTUSER, DESTPASSWORD e DESTSERVER .A SQL destination can include the DESTUSER, DESTPASSWORD and DESTSERVER options.

O argumento de caminho especifica o local do pacote para aplicar a ação.The path argument specifies the location of the package to take action on.

O argumento de hash especifica um identificador de certificado expresso como uma cadeia de caracteres hexadecimal de comprimento variado.The hash argument specifies a certificate identifier expressed as a hexadecimal string of varying length.

Para obter mais informações, consulte Identificar a origem de pacotes com assinaturas digitais.For more information, see Identify the Source of Packages with Digital Signatures.



** Importante *\* Quando configurado para verificar a assinatura do pacote, o Integration ServicesIntegration Services apenas verifica se a assinatura digital está presente, se é válida e se provém de uma origem confiável.** 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 Servicesnão verifica se o pacote foi alterado. does not check whether the package has been changed.
/SourceP[assword] password/SourceP[assword] password Especifica a senha usada com as opções SQL e SOURCEUSER para ativar a recuperação de um pacote SSISSSIS armazenado em um banco de dados em uma instância do SQL ServerSQL Server que usa a Autenticação do 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. É um erro especificar SOURCEPASSWORD em uma linha de comando que não inclui a opção SOURCEUSER .It is an error to specify SOURCEPASSWORD in a command line that does not include the SOURCEUSER option.

Observação: Quando possível, use a Autenticação do Windows.When possible, use Windows Authentication.Note: Quando possível, use a Autenticação do Windows.When possible, use Windows Authentication.
/SourceS[erver] server_instance/SourceS[erver] server_instance Especifica o nome do servidor usado com a opção SQL para ativar a recuperação de um pacote SSISSSIS armazenado no 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. É um erro especificar SOURCESERVER em uma linha de comando que não inclui a opção SIGN SQL, COPY SQLou MOVE SQL .It is an error to specify SOURCESERVER in a command line that does not include the SIGN SQL, COPY SQL, or MOVE SQL option.

Um nome de instância do SQL ServerSQL Server pode ser especificado adicionando uma barra invertida e o nome de instância ao nome do servidor.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 Especifica o nome de usuário usado com as opções SOURCESERVER para ativar a recuperação de um pacote SSISSSIS armazenado no SQL ServerSQL Server usando a Autenticação do 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. É um erro especificar SOURCEUSER em uma linha de comando que não inclui a opção SIGN SQL, COPY SQLou MOVE SQL .It is an error to specify SOURCEUSER in a command line that does not include the SIGN SQL, COPY SQL, or MOVE SQL option.

Observação: Quando possível, use a Autenticação do Windows.When possible, use Windows Authentication.Note: Quando possível, use a Autenticação do Windows.When possible, use Windows Authentication.
/SQ[L] package_path/SQ[L] package_path Especifica o local de um pacote SSISSSIS .Specifies the location of an SSISSSIS package. Essa opção indica que o pacote está armazenado no banco de dados msdb .This option indicates that the package is stored in the msdb database. O argumento package_path especifica o caminho e nome do pacote SSISSSIS .The package_path argument specifies the path and name of the SSISSSIS package. Os nomes de pasta são finalizados com barras invertidas.Folder names are terminated with back slashes.

Se a opção SQL for especificada na mesma linha de comando como qualquer uma das opções a seguir, DTEXEC_DTEXECERROR será retornado:If the SQL option is specified on the same command line as any of the following options, a DTEXEC_DTEXECERROR is returned:

DTSDTS

FILEFILE

A opção SQL pode ser acompanhada por zero ou uma instância das seguintes opções:The SQL option may be accompanied by zero or one instance of the following options:

SOURCEUSERSOURCEUSER

SOURCEPASSWORDSOURCEPASSWORD

SOURCESERVERSOURCESERVER



Se SOURCEUSERNAME não for incluído, a Autenticação do Windows será usada para acessar o pacote.If SOURCEUSERNAME is not included, Windows Authentication is used to access the package. SOURCEPASSWORD é permitido somente se SOURCEUSER estiver presente.SOURCEPASSWORD is allowed only if SOURCEUSER is present. Se SOURCEPASSWORD não for incluído, será usada uma senha em branco.If SOURCEPASSWORD is not included, a blank password is used.

** Importante *\* Não use uma senha em branco.Do not use a blank password. Use uma senha forte.Use a strong password.** Important *\* Não use uma senha em branco.Do not use a blank password. Use uma senha forte.Use a strong password.

Códigos de saída do dtutildtutil Exit Codes

O utilitáriodtutil define um código de saída que alerta quando forem detectados erros de sintaxe, quando forem usados argumentos incorretos ou quando forem especificadas combinações de opções inválidas.dtutil sets an exit code that alerts you when syntax errors are detected, incorrect arguments are used, or invalid combinations of options are specified. Caso contrário, o utilitário indicará "A operação foi concluída com êxito". A tabela a seguir lista os valores que o utilitário dtutil pode definir ao sair.Otherwise, the utility reports "The operation completed successfully".The following table lists the values that the dtutil utility can set when exiting.

ValueValue DescriçãoDescription
00 O utilitário foi executado com êxito.The utility executed successfully.
11 O utilitário falhou.The utility failed.
44 O utilitário não pode localizar o pacote solicitado.The utility cannot locate the requested package.
55 O utilitário não pode carregar o pacote solicitado.The utility cannot load the requested package
66 O utilitário não pode resolver a linha de comando porque contém erros sintáticos ou semânticos.The utility cannot resolve the command line because it contains either syntactic or semantic errors.

ComentáriosRemarks

Você não pode usar arquivos de comandos ou redirecionamento com dtutil.You cannot use command files or redirection with dtutil.

A ordem das opções dentro da linha de comando não é significativa.The order of the options within the command line is not significant.

ExemplosExamples

Os exemplos a seguir detalham cenários comuns do uso da linha de comando.The following examples detail typical command line usage scenarios.

Exemplos de cópiaCopy Examples

Para copiar um pacote armazenado no banco de dados msdb em uma instância local do SQL ServerSQL Server usando a Autenticação do Windows para o Armazenamento de Pacotes do SSIS, use a seguinte sintaxe: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   

Para copiar um pacote de um local para outro no sistema de arquivos e fornecer à cópia outro nome, use a seguinte sintaxe: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  

Para copiar um pacote em um sistema de arquivos local para uma instância do SQL ServerSQL Server hospedado em outro computador, use a seguinte sintaxe: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  

Como as opções /DestU[ser] e /DestP[assword] não foram usadas, a Autenticação de Windows é assumida.Because the /DestU[ser] and /DestP[assword] options were not used, Windows Authentication is assumed.

Para criar uma nova ID a um pacote depois que ele for copiado, use a seguinte sintaxe:To create a new ID for a package after it is copied, use the following syntax:

dtutil /I /FILE copiedpkg.dtsx   

Para criar uma nova ID para todos os pacotes em uma determinada pasta, use a seguinte sintaxe: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  

Use apenas um sinal de porcentagem (%) ao digitar o comando no prompt de comando.Use a single percent sign (%) when typing the command at the command prompt. Use dois sinais de porcentagem (%%) se o comando for usado dentro de um arquivo em lotes.Use a double percent sign (%%) if the command is used inside a batch file.

Exemplos de exclusãoDelete Examples

Para excluir um pacote armazenado no banco de dados msdb em uma instância do SQL ServerSQL Server que usa a Autenticação do Windows, use a seguinte sintaxe: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  

Para excluir um pacote armazenado no banco de dados msdb em uma instância do SQL ServerSQL Server que usa a Autenticação do SQL ServerSQL Server , use a seguinte sintaxe: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  

Observação

Para excluir um pacote de um servidor nomeado, inclua a opção SOURCESERVER e seu argumento.To delete a package from a named server, include the SOURCESERVER option and its argument. Você só pode especificar um servidor usando a opção SQL .You can only specify a server by using the SQL option.

Para excluir um pacote armazenado no Armazenamento de Pacotes SSIS, use a seguinte sintaxe:To delete a package that is stored in the SSIS Package Store, use the following syntax:

dtutil /DTS delPackage.dtsx /DELETE  

Para excluir um pacote armazenado no sistema de arquivos, use a seguinte sintaxe:To delete a package that is stored in the file system, use the following syntax:

dtutil /FILE c:\delPackage.dtsx /DELETE  

Exemplos de existênciaExists Examples

Para determinar se existe um pacote no banco de dados msdb em uma instância local do SQL ServerSQL Server que usa a Autenticação do Windows, use a seguinte sintaxe: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  

Para determinar se existe um pacote no banco de dados msdb em uma instância local do SQL ServerSQL Server que usa a Autenticação do SQL ServerSQL Server , use a seguinte sintaxe: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  

Observação

Para determinar se existe um pacote em um servidor nomeado, inclua a opção SOURCESERVER e seu argumento.To determine whether a package exists on a named server, include the SOURCESERVER option and its argument. Você só pode especificar um servidor usando a opção SQL.You can only specify a server by using the SQL option.

Para determinar se existe um pacote no armazenamento de pacotes local, use a seguinte sintaxe:To determine whether a package exists in the local package store, use the following syntax:

dtutil /DTS srcPackage.dtsx /EXISTS  

Para determinar se existe um pacote no sistema de arquivos local, use a seguinte sintaxe:To determine whether a package exists in the local file system, use the following syntax:

dtutil /FILE c:\srcPackage.dtsx /EXISTS  

Exemplos de movimentaçãoMove Examples

Para mover um pacote armazenado no Repositório de Pacotes SSIS do banco de dados msdb em uma instância local do SQL ServerSQL Server que usa a Autenticação do Windows, use a seguinte sintaxe: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  

Para mover um pacote armazenado no banco de dados msdb em uma instância local do SQL ServerSQL Server que usa a Autenticação do SQL ServerSQL Server para o banco de dados msdb em outra instância local do SQL ServerSQL Server que usa a Autenticação do SQL ServerSQL Server , use a seguinte sintaxe: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  

Observação

Para mover um pacote de um servidor nomeado para outro, inclua as opções SOURCES e DESTS e seus argumentos.To move a package from one named server to another, include the SOURCES and the DESTS option and their arguments. Você só pode especificar os servidores usando a opção SQL .You can only specify servers by using the SQL option.

Para mover um pacote armazenado no Armazenamento de Pacotes SSIS, use a seguinte sintaxe:To move a package that is stored in the SSIS Package Store, use the following syntax:

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

Para mover um pacote armazenado no sistema de arquivos, use a seguinte sintaxe: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  

Exemplos de assinaturaSign Examples

Para assinar um pacote armazenado em um banco de dados do SQL ServerSQL Server em uma instância local do SQL ServerSQL Server que usa a Autenticação do Windows, use a seguinte sintaxe: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  

Para localizar informações sobre seu certificado, use CertMgr.To locate information about your certificate, use CertMgr. O código hash pode ser exibido no utilitário CertMgr selecionando o certificado e clicando em Exibir para exibir as propriedades.The hash code can be viewed in the CertMgr utility by selecting the certificate, and then clicking View to view the properties. A guia Detalhes fornece mais informações sobre o certificado.The Details tab provides more information about the certificate. A propriedade Thumbprint é usada como o valor de hash, com espaços removidos.The Thumbprint property is used as the hash value, with spaces removed.

Observação

O hash usado neste exemplo não é um hash real.The hash used in this example is not a real hash.

Para obter mais informações, consulte a seção CertMgr em Assinando e verificando o código de verificação com Authenticode.For more information, see the CertMgr section in Signing and Checking Code with Authenticode.

Exemplos de criptografiaEncrypt Examples

O exemplo a seguir criptografa o arquivo PackageToEncrypt.dtsx para o arquivo EncryptedPackage.dts usando criptografia completa de pacote, com uma senha.The following sample encrypts the file-based PackageToEncrypt.dtsx to the file-based EncryptedPackage.dts using full package encryption, with a password. A senha usada para a criptografia é EncPswd.The password that is used for the encryption is EncPswd.

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

Consulte tambémSee Also

Executar pacotes do SSIS (Integration Services)Run Integration Services (SSIS) Packages