다음을 통해 공유

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

  • 아티클

이 항목에서는 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 파일에서 응용 프로그램을 컴퓨터에 설치할 때 설치 프로세스의 일부로 로컬 컴퓨터의 Windows 레지스트리에 관리되는 COM 어셈블리가 추가됩니다. 이 옵션을 지정하면 대상에 파일 위치도 지정해야 합니다.

    • 서비스 구성 요소를 등록합니다(regsvcs). 이 옵션을 선택하면 응용 프로그램을 .msi 파일로 내보내고 .msi 파일에서 응용 프로그램을 컴퓨터에 설치할 때 설치 프로세스의 일부로 로컬 컴퓨터의 Windows 레지스트리에 관리되는 COM+ 어셈블리가 추가됩니다. 이 옵션을 지정하면 대상에 파일 위치도 지정해야 합니다.

필수 구성 요소

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

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

BizTalk Server 관리 콘솔 사용

  1. 시작을 클릭하고 모든 프로그램을 클릭하고 Microsoft BizTalk Server 20xx를 클릭한 다음 BizTalk Server 관리를 클릭합니다.

  2. 콘솔 트리에서 BizTalk Server 관리를 확장하고, BizTalk 그룹을 확장하고, 애플리케이션을 확장한 다음, .NET 어셈블리를 추가할 애플리케이션을 확장합니다.

  3. 리소스 폴더를 마우스 오른쪽 단추로 클릭하고 추가를 가리킨 다음 리소스를 클릭합니다.

  4. 추가를 클릭하고 어셈블리를 클릭한 다음 열기를 클릭합니다.

  5. 파일 형식 드롭다운 목록에서 System.BizTalk:Assembly를 선택합니다.

  6. 옵션에서 이 어셈블리에 대한 배포 옵션을 선택합니다.

  7. 대상에서 파일 이름을 포함하여 애플리케이션이 .msi 파일에서 설치될 때 파일을 복사할 위치의 전체 경로를 입력합니다. 이 경로를 지정하지 않으면 설치 중에 로컬 파일 시스템에 파일이 복사되지 않습니다. 파일을 응용 프로그램 설치 폴더에 복사하려면 응용 프로그램 설치 시 응용 프로그램 설치 폴더의 값을 사용하는 %BTAD_InstallDir% 환경 변수를 경로에 사용할 수 있습니다. 이렇게 하면 대상 위치 지정 시 응용 프로그램 설치 폴더의 경로를 알 필요가 없습니다.

    예: %BTADInstall_Dir%\Assemblies\Orchestrations.dll

  8. 종속성 탭을 클릭하고 이 어셈블리가 종속되는 아티팩트가 표시됩니다.

  9. 이 어셈블리가 의존하는 아티팩트가 이 애플리케이션에 없는 경우 추가를 애플리케이션에 클릭하고 아티팩트를 찾은 다음 열기를 클릭합니다.

  10. 완료되었으면 확인을 클릭합니다.

명령줄 사용

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

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

    BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:Assembly [/Overwrite] /Source:value [/Destination:value] [/Options:GacOnAdd|GacOnInstall|GacOnImport|RegasmOnInstallRegsvcsOnInstall|] [/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 작업이 실패합니다. 전체 이름에는 어셈블리 파일 이름, 버전, Culture 및 공개 키 토큰이 포함됩니다. ListApp 명령을 사용하여 애플리케이션의 아티팩트 LUID를 볼 수 있습니다.
    /소스 어셈블리 파일의 파일 이름을 포함한 전체 경로입니다. 경로에 공백이 포함된 경우 경로를 큰따옴표(")로 묶어야 합니다.
    /대상 .msi 파일에서 응용 프로그램을 설치할 때 어셈블리 파일을 복사할 위치의 전체 경로입니다. 이를 지정하지 않으면 설치 중에 로컬 파일 시스템에 어셈블리 파일이 복사되지 않습니다. 경로에 공백이 포함된 경우 경로를 큰따옴표(")로 묶어야 합니다. RegasmOnInstall 또는 RegsvcsOnInstall 옵션을 지정할 때는 Destination도 지정해야 합니다. 참고: 경로에서 %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 관리 데이터베이스를 호스트하는 SQL Server 인스턴스의 이름(서버 이름\인스턴스 이름,포트 형식)입니다.

    인스턴스 이름은 해당 인스턴스 이름이 서버 이름과 다른 경우에만 필요합니다. 포트는 SQL Server에서 기본 포트 번호(1433) 이외의 포트 번호를 사용하는 경우에만 필요합니다.

    예:

    Server=MyServer

    Server=MyServer\MySQLServer,1533

    이 값을 지정하지 않으면 로컬 컴퓨터에서 실행 중인 SQL Server 인스턴스의 이름이 사용됩니다.
    /데이터베이스 BizTalk 관리 데이터베이스의 이름입니다. 이 값을 지정하지 않으면 로컬 SQL Server 인스턴스에서 실행 중인 BizTalk 관리 데이터베이스가 사용됩니다.

참고 항목

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