응용 프로그램에 BizTalk 어셈블리를 추가하는 방법

아티클
05/04/2023

이 항목에서는 BizTalk Server 관리 콘솔 또는 명령줄을 사용하여 응용 프로그램에 BizTalk 어셈블리를 추가하는 방법에 대해 설명합니다.

응용 프로그램에 BizTalk 어셈블리를 추가할 때는 다음과 같은 중요한 사항에 주의해야 합니다.

어셈블리를 추가하고 응용 프로그램에 이미 있는 동일한 LUID(Locally Unique Identifier)의 어셈블리를 덮어쓰려는 경우 덮어쓰기 옵션을 지정합니다. 이 값을 지정하지 않으면 추가하려는 어셈블리와 LUID가 같은 어셈블리가 응용 프로그램에 이미 있을 경우 작업이 실패합니다. LUID에는 어셈블리 파일 이름, 버전, culture 및 공개 키 토큰이 포함됩니다. ListApp 명령을 사용하여 애플리케이션의 아티팩트 LUID를 볼 수 있습니다.
추가하려는 어셈블리가 응용 프로그램에 포함되지 않은 다른 아티팩트에 종속된 경우에도 추가 작업이 실패합니다.
BizTalk 어셈블리를 추가할 때 GAC(전역 어셈블리 캐시)에 어셈블리를 설치하기 위한 다음 옵션 중 하나 이상을 지정할 수 있습니다.
- 리소스 추가 시 전역 어셈블리 캐시에 추가합니다(gacutil). 이 옵션을 선택하면 이 항목의 절차를 사용하여 응용 프로그램에 어셈블리를 추가할 때 로컬 컴퓨터의 GAC에 어셈블리가 설치됩니다.
- MSI 파일 가져오기 시 전역 어셈블리 캐시에 추가합니다(gacutil). 이 옵션을 선택하면 응용 프로그램을 .msi 파일로 내보내고 .msi 파일을 BizTalk 그룹으로 가져올 때 가져오기 프로세스의 일부로 로컬 컴퓨터의 GAC에 어셈블리가 설치됩니다.
- MSI 파일 설치 시 전역 어셈블리 캐시에 추가합니다(gacutil). 이 옵션을 선택하면 응용 프로그램을 .msi 파일로 내보내고 .msi 파일에서 응용 프로그램을 컴퓨터에 설치할 때 설치 프로세스의 일부로 로컬 컴퓨터의 GAC에 어셈블리가 설치됩니다.

필수 구성 요소

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

응용 프로그램에 BizTalk 어셈블리를 추가하려면 다음을 수행하십시오.

BizTalk Server 관리 콘솔 사용

시작을 클릭하고 모든 프로그램을 클릭하고 Microsoft BizTalk Server 20xx를 클릭한 다음 BizTalk Server 관리를 클릭합니다.
콘솔 트리에서 BizTalk Server 관리 및 BizTalk 어셈블리를 추가할 애플리케이션이 포함된 BizTalk 그룹을 확장합니다.
응용 프로그램 및 BizTalk 어셈블리를 추가할 응용 프로그램을 확장합니다.
리소스를 마우스 오른쪽 단추로 클릭하고 추가를 가리킨 다음 BizTalk 어셈블리를 클릭합니다.
추가를 클릭하고 BizTalk 어셈블리 파일을 선택한 다음 열기를 클릭합니다.
대상에 파일 이름을 포함하여 애플리케이션이 .msi 파일에서 설치될 때 어셈블리 파일을 복사할 위치의 전체 경로를 입력합니다. 이를 지정하지 않으면 설치 중에 로컬 파일 시스템에 어셈블리 파일이 복사되지 않습니다.
옵션에서 GAC에 BizTalk 어셈블리를 설치하는 옵션을 지정하고 확인을 클릭합니다.

명령줄 사용

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

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

BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:BizTalkAssembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport] [/Server:value] [/Database:value]

예제:

BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:BizTalkAssembly /Overwrite /Source:"C:\BizTalk Assemblies\MyOrchestration.dll" /Destination:"C:\New BizTalk Assemblies\ MyOrchestration.dll " /Server:MyDatabaseServer /Database:BizTalkMgmtDb

매개 변수	값
/Applicationname	BizTalk 어셈블리를 추가할 BizTalk 응용 프로그램의 이름입니다. 응용 프로그램 이름을 지정하지 않으면 기본 BizTalk 응용 프로그램이 사용됩니다. 이름에 공백이 포함된 경우 이름을 큰따옴표(")로 묶어야 합니다.
/형식	System.BizTalk:BizTalkAssembly
/덮어쓸	기존 어셈블리를 업데이트하기 위한 옵션입니다. 이 값을 지정하지 않으면 추가하려는 어셈블리와 LUID가 같은 어셈블리가 응용 프로그램에 이미 있을 경우 AddResource 작업이 실패합니다. ListApp 명령을 사용하여 애플리케이션의 아티팩트 LUID를 볼 수 있습니다. 덮어쓰려는 어셈블리를 다른 응용 프로그램에서 사용 중이면 이 매개 변수를 지정해도 AddResource 작업이 실패합니다.
/소스	어셈블리 파일의 파일 이름을 포함한 전체 경로입니다. 경로에 공백이 포함된 경우 경로를 큰따옴표(")로 묶어야 합니다.
/대상	.msi 파일에서 응용 프로그램을 설치할 때 어셈블리 파일을 복사할 위치의 전체 경로입니다. 이를 지정하지 않으면 설치 중에 로컬 파일 시스템에 어셈블리 파일이 복사되지 않습니다. 경로에 공백이 포함된 경우 경로를 큰따옴표(")로 묶어야 합니다.
/옵션	- GacOnAdd: AddResource 작업 중에 로컬 컴퓨터의 GAC(전역 어셈블리 캐시)에 어셈블리를 설치하도록 지정합니다. - GacOnInstall: 애플리케이션이 .msi 파일에서 설치될 때 GAC에 어셈블리를 설치하도록 지정합니다. - GacOnImport: 애플리케이션 .msi 파일을 가져올 때 GAC에 어셈블리를 설치하도록 지정합니다. 옵션이 여러 개인 경우 각 옵션을 쉼표로 구분해야 합니다.
/서버	BizTalk 관리 데이터베이스를 호스트하는 SQL Server 인스턴스의 이름(서버 이름\인스턴스 이름,포트 형식)입니다. 인스턴스 이름은 해당 인스턴스 이름이 서버 이름과 다른 경우에만 필요합니다. 포트는 SQL Server에서 기본 포트 번호(1433) 이외의 포트 번호를 사용하는 경우에만 필요합니다. 예: Server=MyServer Server=MyServer\MySQLServer,1533 이 값을 지정하지 않으면 로컬 컴퓨터에서 실행 중인 SQL Server 인스턴스의 이름이 사용됩니다.
/데이터베이스	BizTalk 관리 데이터베이스의 이름입니다. 이 값을 지정하지 않으면 로컬 SQL Server 인스턴스에서 실행 중인 BizTalk 관리 데이터베이스가 사용됩니다.

참고 항목

BizTalk 어셈블리 관리
AddResource 명령: BizTalk 어셈블리

다음을 통해 공유