응용 프로그램에 가상 디렉터리를 추가하는 방법

이 항목에서는 BTSTask 명령줄 도구를 사용하여 BizTalk 응용 프로그램에 가상 디렉터리를 추가하는 방법을 설명합니다. BizTalk Server 관리 콘솔에서는 이 옵션을 사용할 수 없습니다. BizTalk Server와 상호 작용하는 사용자 지정 웹 서비스를 작성하거나 ASP.NET 웹 사이트를 만들고 응용 프로그램과 함께 가상 디렉터리를 배포하려는 경우 가상 디렉터리를 추가할 수 있습니다.

애플리케이션에 가상 디렉터리를 추가하는 또 다른 방법은 HTTP 수신 위치를 구성하는 방법에 설명된 대로 SOAP 또는 HTTP 수신 위치에 대한 가상 디렉터리를 지정하는 것입니다. 모든 경우에 BizTalk 관리 데이터베이스에 가상 디렉터리가 추가됩니다. 명령줄을 사용하여 가상 디렉터리를 추가하면 ListApp 명령을 사용할 때 애플리케이션의 아티팩트 목록뿐만 아니라 추가한 애플리케이션의 Resources 폴더에 BizTalk Server 관리 콘솔에도 표시됩니다. 나중에 응용 프로그램을 내보내고 다른 BizTalk 그룹으로 가져오면 해당 가상 디렉터리가 리소스 폴더에 표시됩니다.

응용 프로그램에 가상 디렉터리를 추가할 때는 다음 사항에 주의해야 합니다.

• 덮어쓰기 옵션을 지정하면 응용 프로그램에 있는 가상 디렉터리를 덮어쓸 수 있습니다. 덮어쓰기 옵션은 기존 가상 디렉터리에 추가하려는 가상 디렉터리의 이름이 같은 경우에만 필요합니다. 지정하지 않고 추가되는 것과 동일한 이름의 가상 디렉터리가 애플리케이션에 이미 있는 경우 추가 작업이 실패합니다.

• URL에 https가 포함된 가상 디렉터리를 추가할 때는 지정할 URL에 https 대신 http를 사용해야 합니다. https를 사용하면 가상 디렉터리 추가 작업이 실패합니다. URL에 http를 사용하여 가상 디렉터리를 추가하더라도 인터넷 정보 서비스 메타베이스의 URL에서 https 설정이 적용되어 가상 디렉터리가 제대로 작동합니다.

• 64비트 버전의 웹 서비스에서 가상 디렉터리를 추가하고 이 가상 디렉터리를 포함하는 응용 프로그램을 32비트 컴퓨터에 설치하려고 하면 가상 디렉터리가 설치되지 않습니다. 이러한 응용 프로그램은 64비트 컴퓨터에만 설치해야 합니다.

중요

가상 디렉터리를 포함하는 응용 프로그램을 가져올 때 가상 디렉터리에 대한 보안 설정은 응용 프로그램 내보내기 중 .msi 파일 생성 당시의 보안 설정이 적용됩니다. 프로덕션 환경에 응용 프로그램을 배포하는 경우 응용 프로그램을 내보내기 전에 해당 설정이 보안 요구 사항에 맞는지 확인해야 합니다.

하지만 가상 디렉터리가 대상 환경에 이미 있는 경우 기존 가상 디렉터리의 보안 설정이 적용됩니다. 해당 설정은 배포하는 가상 디렉터리의 설정에 맞게 변경되지 않습니다. 이 경우 기존 가상 디렉터리의 보안 설정이 요구 사항에 맞는지 확인해야 합니다.

주의

가상 디렉터리가 HTTPS(Hypertext Transfer Protocol over Secure Socket Layer) 프로토콜을 사용하는 경우 내보내는 동안 보안 설정이 유지되지 않으며 가져올 때는 가상 디렉터리가 루트의 보안 설정을 상속받습니다. 보안 설정이 요구 사항에 맞는지 확인해야 합니다.

필수 구성 요소

이 항목의 절차를 수행하려면 BizTalk Server 관리자 그룹의 멤버인 계정으로 로그온해야 합니다. 권한에 대한 자세한 내용은 BizTalk 애플리케이션 배포 및 관리에 필요한 권한을 참조하세요.

응용 프로그램에 가상 디렉터리를 추가하려면 다음을 수행하십시오.

1. 다음과 같이 명령 프롬프트를 엽니다. 시작을 클릭하고 실행을 클릭한 다음 를 입력 cmd한 다음 확인을 클릭합니다.

2. 다음 표에 설명된 것과 같이 적절한 값으로 대체하여 다음 명령을 입력합니다.

   BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:WebDirectory[/Overwrite] /Source:value [/Destination:value] [/Server:value] [/Database:value]

   예제:

   BTSTask AddResource /ApplicationName:MyApplication /Type: System.BizTalk:WebDirectory /Overwrite /Source: /Destination:http://Host1:90/MyVirtualDirectoryhttp://Host2:90/MyVirtualDirectory /Server:MyDatabaseServer /Database:BizTalkMgmtDb

   매개 변수	값
   /Applicationname	가상 디렉터리를 추가할 BizTalk 응용 프로그램의 이름입니다. 응용 프로그램 이름을 지정하지 않으면 해당 그룹의 기본 BizTalk 응용 프로그램이 사용됩니다. 이름에 공백이 포함된 경우 이름을 큰따옴표(")로 묶어야 합니다.
   /형식	System.BizTalk:WebDirectory (이 값은 대/소문자를 구분하지 않습니다.)
   /덮어쓸	기존 가상 디렉터리를 업데이트하기 위한 옵션입니다. 이 옵션을 지정하지 않은 경우 추가하려는 가상 디렉터리와 이름이 동일한 가상 디렉터리가 응용 프로그램에 이미 있으면 AddResources 작업이 실패합니다.
   /소스	소스 가상 디렉터리의 URI입니다.
   /대상	.msi 파일에서 응용 프로그램을 설치할 때 가상 디렉터리에 할당할 URI입니다. 이 매개 변수를 지정하지 않으면 Source 매개 변수의 값이 localhost와 함께 호스트로 사용됩니다.
   /서버	BizTalk 관리 데이터베이스를 호스트하는 SQL Server 인스턴스의 이름(서버 이름\인스턴스 이름,포트 형식)입니다. 인스턴스 이름은 해당 인스턴스 이름이 서버 이름과 다른 경우에만 필요합니다. 포트는 SQL Server에서 기본 포트 번호(1433) 이외의 포트 번호를 사용하는 경우에만 필요합니다. 예: Server=MyServer Server=MyServer\MySQLServer,1533 이 값을 지정하지 않으면 로컬 컴퓨터에서 실행 중인 SQL Server 인스턴스의 이름이 사용됩니다.
   /데이터베이스	BizTalk 관리 데이터베이스의 이름입니다. 이 값을 지정하지 않으면 로컬 SQL Server 인스턴스에서 실행 중인 BizTalk 관리 데이터베이스가 사용됩니다.

참고 항목

.NET 어셈블리, 인증서 및 기타 리소스 관리
AddResource 명령: 가상 디렉터리
BizTalk 애플리케이션 만들기 및 수정