dtutil 유틸리티dtutil Utility

dtutil 명령 프롬프트 유틸리티를 사용하여 SQL ServerSQL Server Integration ServicesIntegration Services 패키지를 관리합니다.The dtutil command prompt utility is used to manage SQL ServerSQL Server Integration ServicesIntegration Services packages. 이 유틸리티는 패키지를 복사, 이동, 삭제하거나 패키지가 있는지 여부를 확인할 수 있습니다.The utility can copy, move, delete, or verify the existence of a package. 이러한 동작은 SSISSSIS MicrosoftMicrosoft SQL ServerSQL Server 패키지 저장소 및 파일 시스템 중 하나에 저장된 SSISSSIS 패키지에서 수행할 수 있습니다.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. 유틸리티가 msdb에 저장된 패키지에 액세스하는 경우 명령 프롬프트에 사용자 이름과 암호를 입력해야 할 수 있습니다.If the utility accesses a package that is stored in msdb, the command prompt may require a user name and a password. SQL ServerSQL Server 인스턴스에서 SQL ServerSQL Server 인증을 사용하면 사용자 이름과 암호를 모두 입력해야 합니다.If the instance of SQL ServerSQL Server uses SQL ServerSQL Server Authentication, the command prompt requires both a user name and a password. 사용자 이름이 누락된 경우 dtutil 은 Windows 인증을 사용하여 SQL ServerSQL Server 에 로그온하려고 시도합니다.If the user name is missing, dtutil tries to log on to SQL ServerSQL Server using Windows Authentication. 패키지 저장소 유형은 /SQL, /FILE/DTS 옵션으로 식별됩니다.The storage type of the package is identified by the /SQL, /FILE, and /DTS options.

dtutil 명령 프롬프트 유틸리티는 명령 파일이나 리디렉션 사용을 지원하지 않습니다.The dtutil command prompt utility does not support the use of command files or redirection.

dtutil 명령 프롬프트 유틸리티에는 다음과 같은 기능이 있습니다.The dtutil command prompt utility includes the following features:

  • 명령 프롬프트의 설명은 명령 프롬프트 동작을 자동으로 문서화하여 쉽게 이해할 수 있게 해줍니다.Remarks in the command prompt, which makes the command prompt action self-documenting and easier to understand.

  • 덮어쓰기 보호는 패키지를 복사하거나 이동할 때 기존 패키지를 덮어쓰기 전에 확인 메시지를 표시합니다.Overwrite protection, to prompt for a confirmation before overwriting an existing package when you are copying or moving packages.

  • 콘솔 도움말은 dtutil명령 옵션에 대한 정보를 제공합니다.Console help, to provide information about the command options for dtutil.

참고

SQL Server Management StudioSQL Server Management Studio 인스턴스에 연결된 경우에는 dtutil에서 수행하는 대부분의 작업을 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. 자세한 내용은 패키지 관리(SSIS 서비스)를 참조하세요.For more information, see Package Management (SSIS Service).

옵션은 순서에 관계없이 입력할 수 있습니다.The options can be typed in any order. 파이프("|") 문자는 OR 연산자이며 가능한 값을 표시하는 데 사용됩니다.The pipe ("|") character is the OR operator and is used to show possible values. OR 파이프로 구분된 옵션 중 하나를 사용해야 합니다.You must use one of the options that are delimited by the OR pipe.

모든 옵션은 슬래시(/) 또는 빼기 기호(-)로 시작해야 합니다.All options must start with a slash (/) or a minus sign (-). 단, 슬래시 또는 빼기 기호와 옵션 텍스트 사이에는 공백이 없어야 합니다. 그렇지 않으면 명령이 실패합니다.However, do not include a space between the slash or minus sign and the text for the option; otherwise, the command will fail.

인수는 따옴표로 묶거나 공백이 없는 문자열이어야 합니다.Arguments must be strings that are either enclosed in quotation marks or contain no white space.

작은따옴표로 묶인 문자열 안의 큰따옴표는 이스케이프된 작은따옴표를 나타냅니다.Double quotation marks within strings that are enclosed in quotation marks represent escaped single quotation marks.

암호를 제외한 옵션 및 인수는 대/소문자를 구분하지 않습니다.Options and arguments, except for passwords, are not case sensitive.

64비트 컴퓨터에서의 설치 고려 사항Installation Considerations on 64-bit Computers

64비트 컴퓨터의 경우 Integration ServicesIntegration Services 에서 64비트 버전의 dtexec 유틸리티(dtexec.exe) 및 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). 이러한 Integration ServicesIntegration Services 도구의 32비트 버전을 설치하려면 설치 도중 클라이언트 도구 또는 SQL Server Data Tools(SSDT)SQL Server Data Tools (SSDT) 를 선택해야 합니다.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.

기본적으로 64비트 및 32비트 버전의 Integration ServicesIntegration Services 명령 프롬프트 유틸리티가 모두 설치되어 있는 64비트 컴퓨터는 명령 프롬프트에서 32비트 버전을 실행합니다.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. 64비트 버전에 대한 디렉터리 경로 앞에 32비트 버전에 대한 디렉터리 경로가 PATH 환경 변수에 나타나기 때문에 32비트 버전이 실행됩니다.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. (일반적으로 32 비트 디렉터리 경로 <드라이브 >: 파일 (x86) \Microsoft SQL Server\130\DTS\Binn, 64 비트 디렉터리 경로 \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.)

참고

SQL Server 에이전트를 사용하여 유틸리티를 실행하는 경우 SQL Server 에이전트는 64비트 버전의 유틸리티를 자동으로 사용합니다.If you use SQL Server Agent to run the utility, SQL Server Agent automatically uses the 64-bit version of the utility. SQL Server 에이전트는 PATH 환경 변수가 아닌 레지스트리를 사용하여 유틸리티에 대한 올바른 실행 파일을 찾습니다.SQL Server Agent uses the registry, not the PATH environment variable, to locate the correct executable for the utility.

명령 프롬프트에서 64비트 버전의 유틸리티를 실행하기 위해 다음 동작 중 하나를 수행할 수 있습니다.To ensure that you run the 64-bit version of the utility at the command prompt, you can take one of the following actions:

  • 명령 프롬프트 창을 열고 64 비트 버전의 유틸리티가 포함 된 디렉터리로 변경, (<드라이브 >: files\microsoft SQL Server\130\DTS\Binn), 다음 해당 위치에서 유틸리티를 실행 합니다.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.

  • 전체 경로 입력 하 여 명령 프롬프트 유틸리티를 실행 (<드라이브 >: files\microsoft SQL Server\130\DTS\Binn) 64 비트 버전의 유틸리티에 있습니다.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.

  • 64 비트 경로 배치 하 여 PATH 환경 변수에서의 경로 순서를 영구적으로 변경 (<드라이브 >: files\microsoft SQL Server\130\DTS\Binn) 앞의 32 비트 경로 (<드라이브 >: \ \ 프로그램 파일 (x86) \Microsoft SQL Server\130\DTS\Binn) 변수에 합니다.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.

구문Syntax

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

매개 변수Parameters

옵션Option DescriptionDescription
/?/? 명령 프롬프트 옵션을 표시합니다.Displays the command prompt options.
/C[opy] location;destinationPathandPackageName/C[opy] location;destinationPathandPackageName SSISSSIS 패키지에 대해 Copy 동작을 지정합니다.Specifies a copy action on an SSISSSIS package. 이 매개 변수를 사용하려면 먼저 /FI, /SQ또는 /DT 옵션을 사용하여 패키지 위치를 지정해야 합니다.Use of this parameter requires that you first specify the location of the package using the /FI, /SQ, or /DT option. 그런 다음 대상 위치 및 대상 패키지 이름을 지정합니다.Next, specify the destination location destination package name. destinationPathandPackageName 인수는 SSISSSIS 패키지를 복사할 대상 위치를 지정합니다.The destinationPathandPackageName argument specifies where the SSISSSIS package is copied to. 대상 locationSQL인 경우 명령에 DestUser, DestPasswordDestServer 인수도 지정해야 합니다.If the destination location is SQL, the DestUser, DestPassword and DestServer arguments must also be specified in the command.

Copy 동작을 수행할 때 대상 위치에 기존 패키지가 있을 경우 dtutil 에서 패키지를 삭제할 것인지 묻는 메시지를 표시합니다.When the Copy action encounters an existing package at the destination, dtutil prompts the user to confirm package deletion. Y 로 응답하면 패키지를 덮어쓰고 N 으로 응답하면 프로그램을 종료합니다.The Y reply overwrites the package and the N reply ends the program. 명령에 Quiet 인수가 포함된 경우 메시지가 표시되지 않으며 기존 패키지를 덮어씁니다.When the command includes the Quiet argument, no prompt appears and any existing package is overwritten.
/Dec[rypt] password/Dec[rypt] password 선택 사항입니다.(Optional). 암호가 암호화된 패키지를 로드할 때 사용할 해독 암호를 설정합니다.Sets the decryption password that is used when you load a package with password encryption.
/Del[ete]/Del[ete] SQL, DTS 또는 FILE 옵션으로 지정된 패키지를 삭제합니다.Deletes the package specified by the SQL, DTS or FILE option. dtutil 에서 패키지를 삭제할 수 없을 경우 프로그램이 종료됩니다.If dtutil cannot delete the package, the program ends.
/DestP[assword] password/DestP[assword] password SQL ServerSQL Server 인증을 사용하는 대상 SQL ServerSQL Server 인스턴스에 연결하기 위해 SQL 옵션에 사용할 암호를 지정합니다.Specifies the password that is used with the SQL option to connect to a destination SQL ServerSQL Server instance using SQL ServerSQL Server Authentication. DESTPASSWORD 옵션이 포함되지 않은 명령줄에서 DTSUSER 를 지정하면 오류가 생성됩니다.An error is generated if DESTPASSWORD is specified in a command line that does not include the DTSUSER option.

참고: 가능하면 Windows 인증을 사용하세요.When possible, use Windows Authentication..Note: 가능하면 Windows 인증을 사용하세요.When possible, use Windows Authentication..
/DestS[erver] server_instance/DestS[erver] server_instance 대상이 SQL ServerSQL Server에 저장되도록 하는 모든 동작에 사용할 서버 이름을 지정합니다.Specifies the server name that is used with any action that causes a destination to be saved to SQL ServerSQL Server. SSISSSIS 패키지를 저장할 때 로컬 서버나 기본 서버가 아닌 서버를 식별하는 데 사용됩니다.It is used to identify a non-local or non-default server when saving an SSISSSIS package. 와 관련된 동작이 없는 명령줄에서 DESTSERVER 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. 이 옵션과 조합하여 사용할 수 있는 적합한 명령에는 SIGN SQL, COPY SQL또는 MOVE SQL 옵션과 같은 동작이 있습니다.Actions such as SIGN SQL, COPY SQL, or MOVE SQL options would be appropriate commands to combine with this option.

서버 이름에 백슬래시 및 인스턴스 이름을 추가하여 SQL ServerSQL Server 인스턴스 이름을 지정할 수 있습니다.A SQL ServerSQL Server instance name can be specified by adding a backslash and the instance name to the server name.
/DestU[ser] username/DestU[ser] username 인증을 사용하는인스턴스에 연결하기 위해 SIGN SQL, COPY SQLSQL ServerSQL Server MOVE SQL 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. DESTUSER , SIGN SQL또는 COPY SQL옵션이 포함되지 않은 명령줄에서 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 선택 사항이며, 이 옵션을 선택할 경우 지정된 프로세스 dtexec 유틸리티 또는 dtsDebugHost.exe 프로세스가 일시 중지되고 디버그 덤프 파일 .mdmp 및 .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.

참고: /Dump옵션을 사용하려면 디버그 프로그램 사용자 권한(SeDebugPrivilege)을 할당받아야 합니다.Note: To use the /Dumpoption, you must be assigned the Debug Programs user right (SeDebugPrivilege).

일시 중지할 프로세스의 process ID 를 찾으려면 Windows 작업 관리자를 사용합니다.To find the process ID for the process that you want to pause, use Windows Task Manager.

기본적으로 Integration ServicesIntegration Services 폴더에서 디버그 덤프 파일을 저장 <드라이브 >: 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.

dtexec 유틸리티 dtsDebugHost.exe 프로세스에 대한 자세한 내용은 dtexec UtilityBuilding, 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.

디버그 덤프 파일에 대한 자세한 내용은 Generating Dump Files for Package Execution을 참조하십시오.For more information about debug dump files, see Generating Dump Files for Package Execution.

참고: 디버그 덤프 파일에는 중요한 정보가 들어 있을 수 있습니다.Note: Debug dump files may contain sensitive information. ACL(액세스 제어 목록)을 사용하여 파일에 대한 액세스를 제한하거나 파일을 액세스가 제한된 폴더에 복사합니다.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 사용할 SSISSSIS 패키지가 SSISSSIS 패키지 저장소에 있음을 지정합니다.Specifies that the SSISSSIS package to be operated on is located in the SSISSSIS Package Store. filespec 인수는 SSISSSIS 패키지 저장소의 루트에서 시작하는 폴더 경로를 포함해야 합니다.The filespec argument must include the folder path, starting with the root of the SSISSSIS Package Store. 기본적으로 구성 파일에서 루트 폴더의 이름은 "MSDB" 및 "File System"입니다.By default, the names of the root folders in the configuration file are "MSDB" and "File System." 공백이 포함된 경로는 큰따옴표를 사용하여 구분해야 합니다.Paths that contain a space must be delimited by using double quotation marks.

다음 옵션을 지정한 것과 동일한 명령줄에서 DT[S] 옵션을 지정하면 DTEXEC_DTEXECERROR가 반환됩니다.If the DT[S] option is specified on the same command line as any of the following options, a DTEXEC_DTEXECERROR is returned:

FILEFILE

SQLSQL

SOURCEUSERSOURCEUSER

SOURCEPASSWORDSOURCEPASSWORD

SOURCESERVERSOURCESERVER
/En[crypt] {SQL | FILE}; Path;ProtectionLevel[;password]/En[crypt] {SQL | FILE}; Path;ProtectionLevel[;password] 선택 사항입니다.(Optional). 로드된 패키지를 지정된 보호 수준과 암호를 사용하여 암호화하고 Path에 지정된 위치에 저장합니다.Encrypts the loaded package with the specified protection level and password, and saves it to the location specified in Path. ProtectionLevel 은 암호가 필요한지 여부를 결정합니다.The ProtectionLevel determines whether a password is required.

SQL - 경로는 대상 패키지 이름입니다.SQL - Path is the destination package name.

FILE - 경로는 패키지의 정규화된 경로 및 파일 이름입니다.FILE - Path is the fully-qualified path and file name for the package.

DTS - 현재 이 옵션은 지원되지 않습니다.DTS - This option is not supported currently.

ProtectionLevel 옵션:ProtectionLevel options:

수준 0: 중요한 정보를 따로 암호화하지 않습니다.Level 0: Strips sensitive information.

수준 1: 로컬 사용자 자격 증명을 사용하여 중요한 정보를 암호화합니다.Level 1: Sensitive information is encrypted by using local user credentials.

수준 2: 필수 암호를 사용하여 중요한 정보를 암호화합니다.Level 2: Sensitive information is encrypted by using the required password.

수준 3: 필수 암호를 사용하여 패키지를 암호화합니다.Level 3: Package is encrypted by using the required password.

수준 4: 로컬 사용자 자격 증명을 사용하여 패키지를 암호화합니다.Level 4: Package is encrypted by using local user credentials.

수준 5: 패키지에서 SQL ServerSQL Server 저장소 암호화를 사용합니다.Level 5 Package uses SQL ServerSQL Server storage encryption.
/Ex[ists]/Ex[ists] 선택 사항입니다.(Optional). 패키지가 있는지 여부를 확인하는 데 사용됩니다.Used to determine whether a package exists. dtutilSQL, DTS 또는 FILE 옵션을 사용하여 지정된 패키지를 찾으려고 시도합니다.dtutil tries to locate the package specified by either the SQL, DTS or FILE options. dtutil에서 지정된 패키지를 찾지 못할 경우 DTEXEC_DTEXECERROR가 반환됩니다.If dtutil cannot locate the package specified, a DTEXEC_DTEXECERROR is returned.
/FC[reate] {SQL | DTS};ParentFolderPath;NewFolderName/FC[reate] {SQL | DTS};ParentFolderPath;NewFolderName 선택 사항입니다.(Optional). NewFolderName에 지정된 이름으로 새 폴더를 만듭니다.Create a new folder that has the name that you specified in NewFolderName. 새 폴더의 위치는 ParentFolderPath로 표시됩니다.The location of the new folder is indicated by the ParentFolderPath.
/FDe[lete] {SQL | DTS}[;ParentFolderPath;FolderName]/FDe[lete] {SQL | DTS}[;ParentFolderPath;FolderName] 선택 사항입니다.(Optional). SQL ServerSQL Server 또는 SSISSSIS 에서 FolderName에 이름이 지정된 폴더를 삭제합니다.Deletes from SQL ServerSQL Server or SSISSSIS the folder that was specified by the name in FolderName. 삭제할 폴더의 위치는 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] 선택 사항입니다.(Optional). SSISSSIS 또는 SQL ServerSQL Server의 폴더에 있는 폴더와 패키지 모두의 내용을 나열합니다.Lists the contents, both folders and packages, in a folder on SSISSSIS or SQL ServerSQL Server. 선택 사항인 FolderPath 매개 변수는 내용을 표시할 폴더를 지정합니다.The optional FolderPath parameter specifies the folder that you want to view the content of. 선택 사항인 S 매개 변수는 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 선택 사항입니다.(Optional). 지정된 폴더가 SSISSSIS 또는 SQL ServerSQL Server에 있는지 확인합니다.Verifies if the specified folder exists on SSISSSIS or SQL ServerSQL Server. FolderPath 매개 변수는 확인할 폴더의 경로와 이름입니다.The FolderPath parameter is the path and name of the folder to verify.
/Fi[le] filespec/Fi[le] filespec 이 옵션은 사용할 SSISSSIS 패키지가 파일 시스템에 있음을 지정합니다.This option specifies that the SSISSSIS package to be operated on is located in the file system. UNC(범용 명명 규칙) 경로나 로컬 경로로 filespec 값을 지정할 수 있습니다.The filespec value can be provided as either a Universal Naming Convention (UNC) path or local path.

다음 옵션과 동일한 명령줄에서 File 옵션을 지정하면 DTEXEC_DTEXECERROR가 반환됩니다.If the File option is specified on the same command line as any of the following options, a DTEXEC_DTEXECERROR is returned:

DTSDTS

SQLSQL

SOURCEUSERSOURCEUSER

SOURCEPASSWORDSOURCEPASSWORD

SOURCESERVERSOURCESERVER
/FR[ename] {SQL | DTS} [;ParentFolderPath; OldFolderName;NewFolderName]/FR[ename] {SQL | DTS} [;ParentFolderPath; OldFolderName;NewFolderName] 선택 사항입니다.(Optional). SSISSSIS 또는 SQL ServerSQL Server에서 폴더 이름을 바꿉니다.Renames a folder on the SSISSSIS or SQL ServerSQL Server. ParentFolderPath 는 이름을 바꿀 폴더의 위치입니다.The ParentFolderPath is the location of the folder to rename. OldFolderName 은 폴더의 현재 이름이며 NewFolderName 은 폴더에 지정할 새 이름입니다.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 광범위한 내용을 다루는 도움말을 표시합니다. 이 도움말에서는 dtutil 옵션을 표시하고 그 사용 방법을 설명합니다.Displays text extensive help that shows the dtutil options and describes their use. 옵션 인수는 선택 사항입니다.The option argument is optional. 이 인수를 포함할 경우 도움말 텍스트에는 지정된 옵션에 대한 자세한 내용이 포함됩니다.If the argument is included, the Help text includes detailed information about the specified option. 다음 예에서는 모든 옵션에 대한 도움말을 표시합니다.The following example displays help for all options:

dtutil /H

다음 두 예에서는 /H 옵션을 사용하여 특정 옵션에 대한 자세한 도움말을 표시하는 방법을 보여 줍니다. 이 예에서 도움말을 표시할 특정 옵션은 /Q [uiet] 입니다.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] 패키지를 위한 새 GUID를 만들고 패키지 ID 속성을 업데이트합니다.Creates a new GUID for the package and updates the package ID property. 패키지를 복사해도 패키지 ID는 동일하게 유지되므로 로그 파일에는 두 패키지 모두에 대해 동일한 GUID가 포함됩니다.When a package is copied, the package ID remains the same; therefore, the log files contain the same GUID for both packages. 이 동작은 새로 복사된 패키지에 대해 새 GUID를 만들어 원본과 구별합니다.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 SSISSSIS 패키지에 대해 Move 동작을 지정합니다.Specifies a move action on an SSISSSIS package. 이 매개 변수를 사용하려면 먼저 /FI, /SQ또는 /DT 옵션을 사용하여 패키지 위치를 지정합니다.To use this parameter, first specify the location of the package using the /FI, /SQ, or /DT option. 그런 다음 Move 동작을 지정합니다.Next, specify the Move action. 이 동작에는 세미콜론으로 구분되는 두 인수가 필요합니다.This action requires two arguments, which are separated by a semicolon:

대상 인수는 SQL, FILE또는 DTS를 지정할 수 있습니다.The destination argument can specify SQL, FILE, or DTS. SQL 대상은 DESTUSER, DESTPASSWORDDESTSERVER 옵션을 포함할 수 있습니다.A SQL destination can include the DESTUSER, DESTPASSWORD, and DESTSERVER options.

pathandname 인수는 패키지 위치를 지정합니다. SQL 은 패키지 경로와 패키지 이름을 사용하고 FILE 은 UNC 또는 로컬 경로를 사용하며 DTSSSISSSIS 패키지 저장소의 루트에 상대적인 위치를 사용합니다.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. 대상이 FILE 또는 DTS인 경우 path 인수에는 파일 이름이 포함되지 않습니다.When the destination is FILE or DTS, the path argument does not include the file name. 대신 지정된 위치의 패키지 이름을 파일 이름으로 사용합니다.Instead, it uses the package name at the specified location as the file name.



MOVE 동작을 수행할 때 대상에 기존 패키지가 있을 경우 dtutil 에서 패키지를 덮어쓸 것인지 묻는 메시지를 표시합니다.When the MOVE action encounters an existing package at the destination, dtutil prompts you to confirm that you want to overwrite the package. Y 로 응답하면 패키지를 덮어쓰고 N 으로 응답하면 프로그램을 종료합니다.The Y reply overwrites the package and the N reply ends the program. 명령에 QUIET 옵션이 포함된 경우 메시지가 표시되지 않으며 기존 패키지를 덮어씁니다.When the command includes the QUIET option, no prompt appears and any existing package is overwritten.
/Q[uiet]/Q[uiet] COPY, MOVE또는 SIGN 옵션이 포함된 명령을 실행할 때 나타날 수 있는 확인 메시지를 표시하지 않습니다.Stops the confirmation prompts that can appear when a command including the COPY, MOVE, or SIGN option is executed. 이 메시지는 지정된 패키지와 이름이 같은 패키지가 대상 컴퓨터에 이미 있을 경우 또는 지정된 패키지에 이미 서명이 된 경우 나타납니다.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 명령줄에 주석을 추가합니다.Adds a comment to the command line. 주석 인수는 선택 사항입니다.The comment argument is optional. 주석 텍스트에 공백이 포함된 경우 텍스트를 따옴표로 묶어야 합니다.If the comment text includes spaces, the text must be enclosed in quotation marks. 명령줄에 여러 REM 옵션을 포함할 수 있습니다.You can include multiple REM options in a command line.
/Si[gn] {SQL | File | DTS}; path; hash/Si[gn] {SQL | File | DTS}; path; hash SSISSSIS 패키지에 서명합니다.Signs an SSISSSIS package. 이 동작에서는 세미콜론으로 구분되는 세 인수(대상, path, hash)를 사용합니다.This action uses three required arguments, which are separated by semicolons; destination, path, and hash:

대상 인수는 SQL, FILE또는 DTS를 지정할 수 있습니다.The destination argument can specify SQL, FILE, or DTS. SQL 대상은 DESTUSER, DESTPASSWORDDESTSERVER 옵션을 포함할 수 있습니다.A SQL destination can include the DESTUSER, DESTPASSWORD and DESTSERVER options.

path 인수는 동작을 수행할 패키지의 위치를 지정합니다.The path argument specifies the location of the package to take action on.

hash 인수는 다양한 길이의 16진수 문자열로 표현되는 인증서 식별자를 지정합니다.The hash argument specifies a certificate identifier expressed as a hexadecimal string of varying length.

자세한 내용은 디지털 서명을 사용하여 패키지 원본 확인을 참조하세요.For more information, see Identify the Source of Packages with Digital Signatures.



** 중요 *\* 패키지의 서명을 확인하도록 구성된 경우 Integration ServicesIntegration Services 는 디지털 서명이 있는지, 유효한지, 그리고 신뢰할 수 있는 원본에서 제공된 것인지만 확인합니다.** 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 는 패키지가 변경되었는지 여부는 확인하지 않습니다 . does not check whether the package has been changed.
/SourceP[assword] password/SourceP[assword] password 인증을 사용하는 인스턴스의 데이터베이스에 저장된 패키지를 검색할 수 있도록 SQL SSISSSISSQL ServerSQL Server SOURCEUSER 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. SOURCEUSER 옵션이 포함되지 않은 명령줄에서 SOURCEPASSWORD 를 지정하면 오류가 발생합니다.It is an error to specify SOURCEPASSWORD in a command line that does not include the SOURCEUSER option.

참고: 가능하면 Windows 인증을 사용하세요.When possible, use Windows Authentication.Note: 가능하면 Windows 인증을 사용하세요.When possible, use Windows Authentication.
/SourceS[erver] server_instance/SourceS[erver] server_instance 에 저장된 패키지를 검색할 수 있도록 SSISSSIS SQL 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. SQL , SQL, SQL SQL또는 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.

서버 이름에 백슬래시 및 인스턴스 이름을 추가하여 SQL ServerSQL Server 인스턴스 이름을 지정할 수 있습니다.A SQL ServerSQL Server instance name can be specified by adding a backslash and the instance name to the server name.
/SourceU[ser] username/SourceU[ser] username 인증을 사용하는 에 저장된 SSISSSIS 패키지를 검색할 수 있도록 SQL ServerSQL Server SOURCESERVER 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. SOURCEUSER , SIGN SQL또는 COPY SQL옵션이 포함되지 않은 명령줄에서 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.

참고: 가능하면 Windows 인증을 사용하세요.When possible, use Windows Authentication.Note: 가능하면 Windows 인증을 사용하세요.When possible, use Windows Authentication.
/SQ[L] package_path/SQ[L] package_path SSISSSIS 패키지의 위치를 지정합니다.Specifies the location of an SSISSSIS package. 이 옵션은 패키지가 msdb 데이터베이스에 저장되었음을 나타냅니다.This option indicates that the package is stored in the msdb database. package_path 인수는 SSISSSIS 패키지의 경로와 이름을 지정합니다.The package_path argument specifies the path and name of the SSISSSIS package. 폴더 이름은 백슬래시로 끝납니다.Folder names are terminated with back slashes.

다음 옵션과 같은 명령줄에서 SQL 옵션을 지정하면 DTEXEC_DTEXECERROR가 반환됩니다.If the SQL option is specified on the same command line as any of the following options, a DTEXEC_DTEXECERROR is returned:

DTSDTS

FILEFILE

SQL 옵션은 다음 옵션 중 하나와 함께 사용하거나 혼자 사용할 수 있습니다.The SQL option may be accompanied by zero or one instance of the following options:

SOURCEUSERSOURCEUSER

SOURCEPASSWORDSOURCEPASSWORD

SOURCESERVERSOURCESERVER



SOURCEUSERNAME 이 포함되지 않은 경우 패키지에 액세스하기 위해 Windows 인증이 사용됩니다.If SOURCEUSERNAME is not included, Windows Authentication is used to access the package. SOURCEPASSWORDSOURCEUSER 가 있는 경우에만 허용됩니다.SOURCEPASSWORD is allowed only if SOURCEUSER is present. SOURCEPASSWORD 를 포함하지 않으면 빈 암호가 사용됩니다.If SOURCEPASSWORD is not included, a blank password is used.

** 중요 *\* 빈 암호를 사용하지 마세요.Do not use a blank password. 강력한 암호를 사용하세요.Use a strong password.** Important *\* 빈 암호를 사용하지 마세요.Do not use a blank password. 강력한 암호를 사용하세요.Use a strong password.

dtutil 종료 코드dtutil Exit Codes

dtutil 은 구문 오류가 있거나, 잘못된 인수가 사용되었거나, 잘못된 옵션 조합이 지정된 경우 경고를 표시하는 종료 코드를 설정합니다.dtutil sets an exit code that alerts you when syntax errors are detected, incorrect arguments are used, or invalid combinations of options are specified. 그 이외의 경우 이 유틸리티는 "작업이 완료되었습니다"라는 메시지를 표시합니다. 다음 표에는 dtutil 유틸리티가 종료 시 설정할 수 있는 값이 나열되어 있습니다.Otherwise, the utility reports "The operation completed successfully".The following table lists the values that the dtutil utility can set when exiting.

ValueValue 설명Description
00 유틸리티가 성공적으로 실행되었습니다.The utility executed successfully.
1.1 유틸리티가 실패했습니다.The utility failed.
44 유틸리티는 요청된 패키지를 찾을 수 없습니다.The utility cannot locate the requested package.
55 유틸리티는 요청된 패키지를 로드할 수 없습니다.The utility cannot load the requested package
66 명령줄에 구문 오류나 의미 체계 오류가 있으므로 유틸리티는 명령줄을 확인할 수 없습니다.The utility cannot resolve the command line because it contains either syntactic or semantic errors.

주의Remarks

dtutil에서는 명령줄을 사용할 수 없거나 리디렉션할 수 없습니다.You cannot use command files or redirection with dtutil.

명령줄에서 옵션 순서는 중요하지 않습니다.The order of the options within the command line is not significant.

Examples

다음 예에서는 일반적인 명령줄 사용 시나리오를 보여 줍니다.The following examples detail typical command line usage scenarios.

복사 예Copy Examples

Windows 인증을 사용하는 로컬 인스턴스의 msdb SQL ServerSQL Server 데이터베이스에 저장된 패키지를 SSIS 패키지 저장소에 복사하려면 다음 구문을 사용합니다.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   

파일 시스템의 임의 위치에서 다른 위치로 패키지를 복사하고 복사본에 다른 이름을 지정하려면 다음 구문을 사용합니다.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  

로컬 파일 시스템에 있는 패키지를 다른 컴퓨터에서 호스팅되는 SQL ServerSQL Server 인스턴스에 복사하려면 다음 구문을 사용합니다.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  

/DestU[ser]/DestP[assword] 옵션을 사용하지 않았기 때문에 Windows 인증이 사용됩니다.Because the /DestU[ser] and /DestP[assword] options were not used, Windows Authentication is assumed.

패키지를 복사한 다음 새 ID를 만들려면 다음 구문을 사용합니다.To create a new ID for a package after it is copied, use the following syntax:

dtutil /I /FILE copiedpkg.dtsx   

특정 폴더의 모든 패키지에 대해 새 ID를 만들려면 다음 구문을 사용합니다.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 a single percent sign (%) when typing the command at the command prompt. 배치 파일 내에서 명령을 사용하는 경우에는 이중 백분율 기호(%%)를 사용합니다.Use a double percent sign (%%) if the command is used inside a batch file.

삭제 예Delete Examples

Windows 인증을 사용하는 인스턴스에서 msdb SQL ServerSQL Server 데이터베이스에 저장된 패키지를 삭제하려면 다음 구문을 사용합니다.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  

인증을 사용하는 인스턴스에서 SQL ServerSQL Server msdb SQL ServerSQL Server 데이터베이스에 저장된 패키지를 삭제하려면 다음 구문을 사용합니다.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  
참고

명명된 서버에서 패키지를 삭제하려면 SOURCESERVER 옵션 및 해당 인수를 포함합니다.To delete a package from a named server, include the SOURCESERVER option and its argument. SQL 옵션을 사용해야만 서버를 지정할 수 있습니다.You can only specify a server by using the SQL option.

SSIS 패키지 저장소에 저장된 패키지를 삭제하려면 다음 구문을 사용합니다.To delete a package that is stored in the SSIS Package Store, use the following syntax:

dtutil /DTS delPackage.dtsx /DELETE  

파일 시스템에 저장된 패키지를 삭제하려면 다음 구문을 사용합니다.To delete a package that is stored in the file system, use the following syntax:

dtutil /FILE c:\delPackage.dtsx /DELETE  

존재 확인 예Exists Examples

Windows 인증을 사용하는 의 로컬 인스턴스에서 msdb SQL ServerSQL Server 데이터베이스에 패키지가 있는지 여부를 확인하려면 다음 구문을 사용합니다.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  

인증을 사용하는 의 로컬 인스턴스에서 SQL ServerSQL Server msdb SQL ServerSQL Server 데이터베이스에 패키지가 있는지 여부를 확인하려면 다음 구문을 사용합니다.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  
참고

명명된 서버에 패키지가 있는지 확인하려면 SOURCESERVER 옵션 및 해당 인수를 포함합니다.To determine whether a package exists on a named server, include the SOURCESERVER option and its argument. SQL 옵션을 사용해야만 서버를 지정할 수 있습니다.You can only specify a server by using the SQL option.

로컬 패키지 저장소에 패키지가 있는지 확인하려면 다음 구문을 사용합니다.To determine whether a package exists in the local package store, use the following syntax:

dtutil /DTS srcPackage.dtsx /EXISTS  

로컬 파일 시스템에 패키지가 있는지 확인하려면 다음 구문을 사용합니다.To determine whether a package exists in the local file system, use the following syntax:

dtutil /FILE c:\srcPackage.dtsx /EXISTS  

이동 예Move Examples

SSIS 패키지 저장소에 저장된 패키지를 Windows 인증을 사용하는 로컬 인스턴스의 msdb SQL ServerSQL Server 데이터베이스로 이동하려면 다음 구문을 사용합니다.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  

인증을 사용하는 로컬 인스턴스의 SQL ServerSQL Server msdb SQL ServerSQL Server 데이터베이스에 저장된 패키지를 인증을 사용하는 다른 로컬 인스턴스의 SQL ServerSQL Server msdb SQL ServerSQL Server 데이터베이스로 이동하려면 다음 구문을 사용합니다.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  
참고

명명된 서버 간에 패키지를 이동하려면 SOURCESDESTS 옵션과 해당 인수를 포함합니다.To move a package from one named server to another, include the SOURCES and the DESTS option and their arguments. SQL 옵션을 사용해야만 서버를 지정할 수 있습니다.You can only specify servers by using the SQL option.

SSIS 패키지 저장소에 저장된 패키지를 이동하려면 다음 구문을 사용합니다.To move a package that is stored in the SSIS Package Store, use the following syntax:

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

파일 시스템에 저장된 패키지를 이동하려면 다음 구문을 사용합니다.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  

서명 예Sign Examples

Windows 인증을 사용하는 로컬 SQL ServerSQL Server 인스턴스의 SQL ServerSQL Server 데이터베이스에 저장된 패키지에 서명하려면 다음 구문을 사용합니다.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  

인증서에 대한 정보를 찾으려면 CertMgr을 사용합니다.To locate information about your certificate, use CertMgr. 해시 코드는 CertMgr 유틸리티에서 인증서를 선택한 다음 속성을 표시하는 보기 를 클릭하여 볼 수 있습니다.The hash code can be viewed in the CertMgr utility by selecting the certificate, and then clicking View to view the properties. 자세히 탭에는 인증서에 대한 자세한 정보가 제공됩니다.The Details tab provides more information about the certificate. Thumbprint 속성은 공백이 제거된 다음 해시 값으로 사용됩니다.The Thumbprint property is used as the hash value, with spaces removed.

참고

이 예에 사용된 해시는 실제 해시가 아닙니다.The hash used in this example is not a real hash.

자세한 내용은 Authenticode로 코드 서명 및 확인(Signing and Checking Code with Authenticode)의 CertMgr 섹션을 참조하십시오.For more information, see the CertMgr section in Signing and Checking Code with Authenticode.

암호화 예Encrypt Examples

다음 예에서는 암호와 함께 전체 패키지 암호화를 사용하여 파일 기반 PackageToEncrypt.dtsx를 파일 기반 EncryptedPackage.dts로 암호화합니다.The following sample encrypts the file-based PackageToEncrypt.dtsx to the file-based EncryptedPackage.dts using full package encryption, with a password. 암호화에 사용된 암호는 EncPswd입니다.The password that is used for the encryption is EncPswd.

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

관련 항목:See Also

Integration Services(SSIS) 패키지 실행Run Integration Services (SSIS) Packages