인터셉터 관리 명령

새 BAM 인터셉터 기능을 지원하기 위해 BAM 관리 유틸리티에 네 가지 새로운 명령이 추가되었습니다.

이 명령을 사용하여 인터셉터를 배포, 검색 및 제거할 수 있습니다. 구성된 인터셉터를 나열하는 명령도 제공됩니다.

• deploy-interceptor: 인터셉터 구성을 배포합니다.

• get-interceptorlist: 가로채기가 배포되는 활동 목록을 가져옵니다.

• get-interceptor: 인터셉터 구성을 가져옵니다.

• remove-interceptor: 인터셉터 구성을 제거합니다.

참고

-Trace:on|off 매개 변수 스위치를 포함하여 모든 BM 유틸리티 명령에서 추적을 사용하도록 설정할 수 있습니다. 추적 스위치를 사용하면 구성 파일의 추적 설정이 재정의됩니다. 이 스위치는 일반적인 BM 명령과 함께 사용할 수 있습니다.

참고

UAC(사용자 계정 컨트롤)를 지원하는 시스템에서는 관리 권한을 사용하여 도구를 실행해야 할 수 있습니다.

deploy-interceptor 명령

사용 현황

bm.exe deploy-interceptor -FileName:<Configuration XML Filename> [-Force:True ] [-Server:<server>] [-Database:<database>]

매개 변수

매개 변수	Description
FileName:<Configuration XML Filename>	인터셉터 구성을 포함하는 XML 파일 이름입니다.
Force:True	선택 사항: 이벤트 원본 이름 충돌이 감지되면 인터셉터 구성을 강제로 배포합니다.
Server:<server>	선택 사항: 인터셉터를 배포할 서버의 이름입니다. 서버는 bm.exe를 실행 중인 컴퓨터와 동일한 도메인에 있어야 합니다.
Database:<database>	선택 사항: 인터셉터를 구성할 BAM 주 가져오기 데이터베이스의 이름입니다.

이 명령은 지정된 서버 및 데이터베이스에 인터셉터 구성을 배포합니다. 배포 중에 BAM 관리 유틸리티는 다음과 같은 유효성 검사를 수행합니다.

• XSD 유효성 검사: 인터셉터 구성은 일반적인 인터셉터 구성 스키마에 대해 유효성을 검사합니다.

• 활동이 존재하며(기본 가져오기 데이터베이스에 배포되었으며) 검사점이 유효한지(존재하며 데이터 유형이 일치하는지) 유효성을 검사합니다.

  이벤트 소스 이름 충돌이 검색될 경우 충돌을 알리는 경고가 throw됩니다. 충돌의 경우 –Force:True 매개 변수 플래그를 사용하지 않으면 배포가 실패합니다.

참고

–Force:True 매개 변수는 동일한 이름의 이벤트 원본을 참조하는 인터셉터 구성을 잠재적으로 제거합니다. –Force:True 매개 변수를 사용하기 전에 get-interceptor 명령을 사용하여 기존 인터셉터 구성의 백업을 만들어야 합니다.

예

bm.exe deploy-interceptor  -FileName:myInceptor.xml  
bm.exe deploy-interceptor  -FileName:myInceptor.xml -Force:True  

get-interceptorlist 명령

사용 현황

bm.exe get-interceptorlist [-Server:<server>] [-Database:<database>]

매개 변수

매개 변수	Description
Server:<server>	선택 사항: 배포된 인터셉터 목록을 반환할 서버의 이름입니다. 서버는 bm.exe를 실행 중인 컴퓨터와 동일한 도메인에 있어야 합니다.
Database:<database>	선택 사항: 배포된 인터셉터를 검색할 BAM 기본 가져오기 데이터베이스의 이름입니다.

이 명령은 인터셉터를 사용하도록 설정한 활동 및 연관된 이벤트 소스 목록을 반환합니다.

예제

bm.exe get-interceptorlist   

get-interceptor 명령

사용 현황

bm.exe get-interceptor [-Server:<server>] [-Database:<database>] -FileName: <Configuration XML Filename> [ -Activity: <Activity Name>] [-EventSource: <이벤트 원본 이름>]

매개 변수

매개 변수	Description
Server:<server>	선택 사항: 배포된 인터셉터를 검색할 서버의 이름입니다. 서버는 bm.exe를 실행 중인 컴퓨터와 동일한 도메인에 있어야 합니다.
Database:<database>	선택 사항: 배포된 인터셉터를 검색할 BAM 주 가져오기 데이터베이스의 이름입니다.
FileName:<Configuration XML Filename>	인터셉터 구성을 쓸 XML 파일 이름입니다.
활동:<활동 이름>	선택 사항: 구성된 인터셉터를 반환할 작업을 지정합니다. EventSource 매개 변수와 함께 사용하여 반환할 구성을 추가로 지정할 수 있습니다.
EventSource:<이벤트 원본 이름>	선택 사항: 구성된 인터셉터를 반환할 이벤트 원본을 지정합니다. Activity 매개 변수와 함께 사용하여 반환할 구성을 추가로 지정할 수 있습니다.

활동 이름이나 이벤트 소스 이름을 지정하지 않은 경우 이 명령은 모든 이벤트 소스 및 활동의 인터셉터 구성을 포함하는 유효한 구성 파일을 반환합니다.

활동 이름만 지정한 경우 이 명령은 해당 활동의 모든 이벤트 소스에 대한 유효한 인터셉터 구성 파일을 반환합니다.

이벤트 소스 이름만 지정한 경우 이 명령은 모든 활동과 관련된 이벤트 소스에 대한 유효한 인터셉터 구성 파일을 반환합니다.

활동 이름과 이벤트 소스 이름을 모두 지정한 경우 이 명령은 해당 활동의 해당 이벤트 소스에 대한 유효한 인터셉터 구성 파일을 반환합니다.

예

bm.exe get-interceptor   
bm.exe get-interceptor  -Activity:ShippingPO  

remove-interceptor 명령

사용 현황

bm.exe remove-interceptor [-Server:<server>] [-Database:<database>] [ -Activity: <Activity Name>][-EventSource: <이벤트 원본 이름>]

매개 변수

매개 변수	Description
Server:<server>	선택 사항: 인터셉터를 구성할 서버의 이름입니다. 서버는 bm.exe를 실행 중인 컴퓨터와 동일한 도메인에 있어야 합니다.
Database:<database>	선택 사항: 인터셉터를 구성할 데이터베이스의 이름입니다.
활동: <활동 이름>	선택 사항: 지정된 인터셉터를 제거할 작업을 지정합니다. EventSource 매개 변수와 함께 사용하여 반환할 구성을 추가로 지정할 수 있습니다.
EventSource: <이벤트 원본 이름>	선택 사항: 지정된 인터셉터를 제거할 이벤트 원본을 지정합니다. Activity 매개 변수와 함께 사용하여 반환할 구성을 추가로 지정할 수 있습니다.

활동 이름만 지정한 경우 이 명령은 해당 활동의 모든 이벤트 소스에 대한 인터셉터를 제거합니다.

이벤트 소스 이름만 지정한 경우 이 명령은 해당 활동에 대한 이벤트 소스 부분만 제거합니다.

예제

bm.exe remove-interceptor   

참고 항목

BAM 관리 유틸리티