이 항목에서는 BizTalk Server 관리 콘솔 또는 명령줄을 사용하여 BizTalk 어셈블리가 아닌 .NET 어셈블리를 BizTalk 애플리케이션에 추가하는 방법을 설명합니다. 애플리케이션에 .NET 어셈블리를 추가할 때는 다음과 같은 중요한 사항에 유의하세요.
애플리케이션에 이미 있는 어셈블리를 덮어쓰려면 덮어쓰기 옵션을 지정합니다. 두 어셈블리에 동일한 LUID가 있는 경우에만 덮어쓰기 옵션이 필요합니다. 지정하지 않고 어셈블리가 추가되는 어셈블리와 동일한 LUID를 가진 애플리케이션에 이미 있는 경우 추가 작업이 실패합니다. ListApp 명령을 사용하여 애플리케이션에서 아티팩트 LUID를 볼 수 있습니다.
.NET 어셈블리를 추가할 때 GAC(전역 어셈블리 캐시)에 어셈블리를 설치하기 위한 다음 옵션 중 하나 이상을 지정할 수 있습니다.
리소스를 추가할 때 전역 어셈블리 캐시에 추가합니다 (gacutil). 이 옵션을 선택하면 이 항목의 절차를 사용하여 어셈블리가 애플리케이션에 추가될 때 어셈블리가 로컬 컴퓨터의 GAC에 설치됩니다.
MSI 파일 가져오기(gacutil)의 전역 어셈블리 캐시에 추가합니다. 이 옵션을 선택하면 애플리케이션을 .msi 파일로 내보내고 .msi 파일을 BizTalk 그룹으로 가져오는 경우 어셈블리는 가져오기 프로세스의 일부로 로컬 컴퓨터의 GAC에 설치됩니다. 애플리케이션에 정책뿐만 아니라 정책에 의존하는 어셈블리가 포함된 경우 이 옵션을 선택합니다. 정책을 포함하는 애플리케이션을 가져올 때 정책이 의존하는 모든 어셈블리가 GAC에 있어야 하므로 이 작업을 수행해야 합니다.
MSI 파일 설치(gacutil)의 전역 어셈블리 캐시에 추가합니다. 이 옵션을 선택하면 애플리케이션을 .msi 파일로 내보내고 애플리케이션이 .msi 파일의 컴퓨터에 설치된 경우 설치 프로세스의 일부로 로컬 컴퓨터의 GAC에 어셈블리가 설치됩니다.
COM 구성 요소에 표시하도록 설정(regasm). 이 옵션을 선택하면 애플리케이션을 .msi 파일로 내보내고 애플리케이션이 .msi 파일의 컴퓨터에 설치된 경우 설치 프로세스의 일부로 관리되는 COM 어셈블리가 로컬 컴퓨터의 Windows 레지스트리에 추가됩니다. 이 옵션을 지정하는 경우 대상에서 파일의 위치도 지정해야 합니다.
서비스 구성 요소(regsvcs)를 등록합니다. 이 옵션을 선택하면 애플리케이션을 .msi 파일로 내보내고 애플리케이션이 .msi 파일의 컴퓨터에 설치된 경우 관리되는 COM+ 어셈블리가 설치 프로세스의 일부로 로컬 컴퓨터의 Windows 레지스트리에 추가됩니다. 이 옵션을 지정하는 경우 대상에서 파일의 위치도 지정해야 합니다.
필수 조건
이 항목의 절차를 수행하려면 BizTalk Server Administrators 그룹의 구성원인 계정으로 로그온해야 합니다. 권한에 대한 자세한 내용은 BizTalk 애플리케이션 배포 및 관리에 필요한 사용 권한을 참조하세요.
애플리케이션에 .NET 어셈블리를 추가하려면
BizTalk Server 관리 콘솔 사용
시작을 클릭하고 모든 프로그램을 클릭하고 Microsoft BizTalk Server 20xx를 클릭한 다음 BizTalk Server 관리를 클릭합니다.
콘솔 트리에서 BizTalk Server Administration을 확장하고 BizTalk 그룹을 확장한 다음 애플리케이션을 확장한 다음 .NET 어셈블리를 추가할 애플리케이션을 확장합니다.
리소스 폴더를 마우스 오른쪽 단추로 클릭하고 추가를 가리킨 다음 리소스를 클릭합니다.
추가를 클릭하고 어셈블리를 클릭한 다음 열기를 클릭합니다.
파일 형식 드롭다운 목록에서 System.BizTalk:Assembly를 선택합니다.
옵션에서 이 어셈블리에 대한 배포 옵션을 선택합니다.
대상에서 파일 이름을 포함하여 .msi 파일에서 애플리케이션을 설치할 때 파일을 복사할 위치의 전체 경로를 입력합니다. 이 경로가 제공되지 않으면 설치하는 동안 파일이 로컬 파일 시스템에 복사되지 않습니다. 파일을 애플리케이션 설치 폴더에 복사하려면 경로에서 %BTAD_InstallDir% 환경 변수를 사용하면 애플리케이션이 설치될 때 애플리케이션 설치 폴더의 값을 사용합니다. 이렇게 하면 대상 위치를 지정할 때 애플리케이션 설치 폴더의 경로를 알 필요가 없습니다.
예: %BTADInstall_Dir%\Assemblies\Orchestrations.dll
종속성 탭을 클릭하고 이 어셈블리가 종속되는 아티팩트가 표시됩니다.
이 어셈블리가 의존하는 아티팩트가 이 애플리케이션에 없는 경우 추가하려면 [애플리케이션에 추가]를 클릭하고 아티팩트를 찾은 다음 [열기]를 클릭합니다.
완료되었으면 확인을 클릭합니다.
명령줄 사용
다음과 같이 명령 프롬프트를 엽니다. 시작을 클릭하고 실행을 클릭한 다음 입력
cmd한 다음 확인을 클릭합니다.다음 표에 설명된 대로 적절한 값을 대체하여 다음 명령을 입력합니다.
BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Assembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstall|RegsvcsOnInstall] [/Server:value] [/Database:value]
예제:
BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:Assembly /Overwrite /Source:"C:\Source Assemblies\MyAssembly.dll" /Destination:"%BTAD_InstallDir%\New Assemblies\MyAssembly.dll" /Options:GacOnAdd,RegasmOnInstall /Server:MyDatabaseServer /Database:BizTalkMgmtDb
매개 변수 가치 /ApplicationName 어셈블리를 추가할 BizTalk 애플리케이션의 이름입니다. 애플리케이션 이름을 지정하지 않으면 그룹에 대한 기본 BizTalk 애플리케이션이 사용됩니다. 이름에 공백이 포함된 경우 큰따옴표(")로 묶어야 합니다. /형 System.BizTalk:Assembly (이 값은 대/소문자를 구분하지 않습니다.) /덮어쓸 기존 어셈블리를 업데이트하는 옵션입니다. 지정하지 않은 경우 어셈블리가 추가되는 어셈블리와 동일한 전체 이름을 사용하는 애플리케이션에 이미 있는 경우 AddResource 작업이 실패합니다. 전체 이름에는 어셈블리 파일 이름, 버전, 문화권 및 공개 키 토큰이 포함됩니다. ListApp 명령을 사용하여 애플리케이션에서 아티팩트 LUID를 볼 수 있습니다. /소스 파일 이름을 포함하여 어셈블리 파일의 전체 경로입니다. 경로에 공백이 포함된 경우 큰따옴표(")로 묶어야 합니다. /목적지 애플리케이션이 .msi 파일에서 설치될 때 어셈블리 파일을 복사할 위치의 전체 경로입니다. 제공되지 않으면 설치하는 동안 어셈블리 파일이 로컬 파일 시스템에 복사되지 않습니다. 경로에 공백이 있는 경우 큰따옴표(")로 묶어야 합니다. RegasmOnInstall 또는 RegsvcsOnInstall 옵션을 지정하는 경우 대상도 지정해야 합니다. 메모: 경로에서 %BTAD_InstallDir% 환경 변수를 사용할 수 있습니다. 애플리케이션이 설치될 때 애플리케이션 설치 폴더의 값을 사용합니다. 이렇게 하면 대상 위치를 지정할 때 애플리케이션 설치 폴더의 경로를 알 필요가 없습니다. 예: %BTAD_InstallDir%\Assemblies\Orchestrations.dll /옵션 - GacOnAdd: AddResource 작업 중에 로컬 컴퓨터의 GAC(전역 어셈블리 캐시)에 어셈블리를 설치합니다.
- GacOnInstall: 애플리케이션이 .msi 파일에서 설치될 때 GAC에 어셈블리를 설치합니다.
- GacOnImport: 애플리케이션 .msi 파일을 가져올 때 GAC에 어셈블리를 설치합니다.
- RegasmOnInstall: 애플리케이션이 .msi 파일에서 설치될 때 관리되는 COM 어셈블리를 Windows 레지스트리에 추가합니다. 이 옵션을 지정하는 경우 대상도 지정해야 합니다.
- RegsvcsOnInstall:애플리케이션이 .msi 파일에서 설치될 때 관리되는 COM+ 어셈블리를 Windows 레지스트리에 추가합니다. 이 옵션을 지정하는 경우 대상도 지정해야 합니다.
여러 옵션을 쉼표로 구분해야 합니다./서버 BizTalk Management 데이터베이스를 호스팅하는 SQL Server 인스턴스의 이름(ServerName\InstanceName, Port 형식)입니다.
인스턴스 이름은 인스턴스 이름이 서버 이름과 다른 경우에만 필요합니다. 포트는 SQL Server가 기본값(1433) 이외의 포트 번호를 사용하는 경우에만 필요합니다.
예제:
Server=MyServer
Server=MyServer\MySQLServer,1533
제공되지 않으면 로컬 컴퓨터에서 실행되는 SQL Server 인스턴스의 이름이 사용됩니다./데이터베이스 BizTalk Management 데이터베이스의 이름입니다. 지정하지 않으면 SQL Server의 로컬 인스턴스에서 실행되는 BizTalk Management 데이터베이스가 사용됩니다.
또한 참조하십시오
.NET 어셈블리, 인증서 및 기타 리소스 관리
AddResource 명령: .NET 어셈블리
BizTalk 애플리케이션 만들기 및 수정