Install-TransportAgent

  • 아티클

 

적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

마지막으로 수정된 항목: 2007-07-27

Install-TransportAgent cmdlet를 사용하여 Microsoft Exchange Server 2007 조직에 Edge 전송 서버 역할 또는 허브 전송 서버 역할이 설치되어 있는 컴퓨터에 전송 에이전트를 등록합니다.

구문

Install-TransportAgent -Name <String> -AssemblyPath <String> -TransportAgentFactory <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

자세한 정보

Install-TransportAgent cmdlet는 Edge 전송 서버 또는 허브 전송 서버에 사용할 전송 에이전트를 등록하는 데 사용합니다.

경고

전송 에이전트는 발생하는 모든 전자 메일 메시지에 대한 모든 액세스 권한을 가집니다. Exchange는 전송 에이전트의 동작을 제한하지 않습니다. 불안정하거나 보안 결함을 가진 전송 에이전트는 Exchange의 안정성 및 보안에 영향을 줄 수 있습니다. 따라서 완전히 신뢰할 수 있고 테스트 환경에서 완전하게 테스트된 전송 에이전트만 설치해야 합니다.

Install-TransportAgent cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.

  • 대상 서버에 대한 Exchange Server 관리자 역할 및 로컬 관리자 그룹

Edge 전송 서버 역할이 설치되어 있는 컴퓨터에서 Install-TransportAgent cmdlet를 실행하려면 해당 컴퓨터의 로컬 관리자 그룹 구성원 계정을 사용하여 로그온해야 합니다.

사용 권한, 역할 위임 및 Exchange 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.

매개 변수

매개 변수 필수 종류 설명

AssemblyPath

필수

System.String

이 매개 변수는 전송 에이전트 Microsoft .NET 어셈블리의 위치를 지정합니다. UNC(Universal Naming Convention) 파일 경로는 사용할 수 없습니다.

Name

필수

System.String

이 매개 변수는 설치할 전송 에이전트의 표시 이름을 지정합니다. 이름의 길이는 64자를 초과할 수 없습니다.

TransportAgentFactory

필수

System.String

이 매개 변수는 전송 에이전트 팩터리의 Microsoft .NET 클래스 형식을 지정합니다. 설치 중인 전송 에이전트의 개발자가 전송 에이전트 팩터리 및 관련 정보를 제공합니다. 자세한 내용은 전송 에이전트 개발자가 제공한 설명서를 참조하십시오.

Confirm

선택

System.Management.Automation.SwitchParameter

Confirm 매개 변수는 명령에서 처리 작업을 일시 중지하도록 하고 처리 작업을 계속하기 전 수행할 작업을 사용자가 확인하도록 합니다. Confirm 매개 변수에는 값을 지정할 필요가 없습니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

이 구성 변경을 Active Directory 디렉터리 서비스에 기록하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 명령에 DomainController 매개 변수를 포함시킵니다. Edge 전송 서버 역할을 실행하는 컴퓨터에서는 DomainController 매개 변수가 지원되지 않습니다. Edge 전송 서버 역할은 로컬 ADAM 인스턴스에만 기록하고 읽습니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

WhatIf 매개 변수는 명령 실행 시 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 사용자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 매개 변수에는 값을 지정할 필요가 없습니다.

입력 형식

반환 형식

오류

오류 설명

 

예외

예외 설명

 

예제

다음 예에서는 가상 바이러스 백신 에이전트를 Edge 전송 서버 또는 허브 전송 서버에 설치하는 방법을 보여줍니다.

Install-TransportAgent -Name "Antivirus for Exchange" -TransportAgentFactory "vendor.exchange.avTransportAgentfactory" -AssemblyPath "c:\Program Files\Vendor\TransportAgent\AvTransportAgentFactory.dll"