New-TransportRule
적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
마지막으로 수정된 항목: 2007-08-13
New-TransportRule cmdlet를 사용하여 Microsoft Exchange Server 2007 허브 전송 서버 역할 또는 Edge 전송 서버 역할이 설치되어 있는 컴퓨터를 통과하는 전자 메일 메시지를 처리할 때 전송 규칙 에이전트에서 사용되는 새로운 전송 규칙을 만들 수 있습니다.
구문
New-TransportRule -Name <String> -Actions <TransportRuleAction[]> [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Exceptions <TransportRulePredicate[]>] [-Priority <Int32>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
자세한 설명
New-TransportRule cmdlet를 사용하여 Exchange 2007 조직의 허브 전송 서버 또는 Edge 전송 서버를 통과하는 전자 메일 메시지를 처리할 때 전송 규칙 에이전트에서 사용되는 새 전송 규칙을 만들 수 있습니다.
각 조건 및 예외는 지원되는 규칙 조건자를 사용해야 합니다. 각 조건자는 조건자 자체 및 테스트하려는 값으로 구성됩니다.
지원되는 전송 규칙 조건자 목록은 전송 규칙 조건부를 참조하십시오.
각 작업은 지원되는 규칙 작업을 사용해야 합니다. 각 작업은 작업 자체와 해당 작업을 수행하기 위해 사용되는 값으로 구성됩니다.
지원되는 전송 규칙 작업 목록은 전송 규칙 동작를 참조하십시오.
새 전송 규칙을 만드는 방법에 대한 자세한 내용은 새 전송 규칙을 만드는 방법을 참조하십시오.
전송 규칙 에이전트에 대한 자세한 내용은 전송 규칙 개요를 참조하십시오.
New-TransportRule cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.
- Exchange 조직 관리자 역할
Edge 전송 서버 역할이 설치된 컴퓨터에서 New-TransportRule cmdlet를 실행하려면 해당 컴퓨터의 로컬 관리자 그룹에 속한 계정을 사용하여 로그온해야 합니다.
사용 권한, 역할 위임 및 Exchange 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.
매개 변수
| 매개 변수 | 필수 | 종류 | 설명 |
|---|---|---|---|
Actions |
필수 |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[] |
모든 조건이 충족되었고 예외가 발생하지 않은 경우 전송 규칙이 전자 메일 메시지에 적용하는 작업을 지정하려면 이 매개 변수를 사용합니다. 각 규칙에는 적어도 하나 이상의 작업을 지정해야 합니다. |
Name |
필수 |
System.String |
만들려는 전송 규칙의 표시 이름을 지정하려면 이 매개 변수를 사용합니다. 이름 길이는 64자를 초과할 수 없습니다. |
Comments |
선택 |
System.String |
사용할 규칙이나 시간에 따른 변경 내용 등과 같은 정보를 규칙에 추가하려면 이 매개 변수를 사용합니다. 설명 길이는 1024자를 초과할 수 없습니다. |
Conditions |
선택 |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
전송 규칙에 의해 전송 규칙 에이전트에 전송된 전자 메일 메시지에 적용되는 조건을 지정하려면 이 매개 변수를 사용합니다. 규칙에서 조건을 구성하지 않으면 일치하는 예외가 없을 경우 모든 메시지에 규칙이 적용됩니다. |
Confirm |
선택 |
System.Management.Automation.SwitchParameter |
Confirm 매개 변수는 명령에서 처리 작업을 일시 중지하도록 하고 처리 작업을 계속하기 전 수행할 작업을 사용자가 확인하도록 합니다. Confirm 매개 변수에는 값을 지정할 필요가 없습니다. |
DomainController |
선택 |
Microsoft.Exchange.Data.Fqdn |
Active Directory 디렉터리 서비스에서 데이터를 검색하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 명령에 DomainController 매개 변수를 포함시킵니다. Edge 전송 서버 역할을 실행하는 컴퓨터에서는 DomainController 매개 변수가 지원되지 않습니다. Edge 전송 서버 역할은 로컬 ADAM(Active Directory Application Mode) 인스턴스에만 기록합니다. |
Enabled |
선택 |
System.Boolean |
전송 규칙을 만들 때 전송 규칙을 활성화할지 여부를 지정하려면 이 매개 변수를 사용합니다. 기본값은 |
Exceptions |
선택 |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
전송 규칙이 전자 메일 메시지에 적용하는 예외를 지정하려면 이 매개 변수를 사용합니다. 메시지에 일치하는 예외가 있으면 이 규칙에 지정된 어떤 작업도 메시지에 적용되지 않습니다. |
Priority |
선택 |
System.Int32 |
전송 규칙이 적용되는 순서를 지정하려면 이 매개 변수를 사용합니다. 규칙의 우선 순위를 수정하면 규칙 목록의 규칙 위치가 사용자가 지정한 우선 순위에 따라 변경되고, 전송 규칙 에이전트가 모든 규칙을 더 높은 우선 순위 값으로 증가시킵니다. 우선 순위 값이 낮은 규칙이 먼저 처리됩니다. 이 매개 변수의 값은 0보다 크거나 같아야 합니다. |
TemplateInstance |
선택 |
System.Management.Automation.PSObject |
이 매개 변수에 기존 개체를 제공하면 명령이 해당 개체의 구성을 사용하여 로컬 또는 대상 서버에서 해당 개체와 동일한 복사본을 만듭니다. 자세한 내용은 템플릿을 참조하십시오. |
WhatIf |
선택 |
System.Management.Automation.SwitchParameter |
WhatIf 매개 변수는 명령 실행 시 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 사용자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 매개 변수에는 값을 지정할 필요가 없습니다. |
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
|
|
예외
| 예외 | 설명 |
|---|---|
|
|
예제
다음 예는 허브 전송 서버에서 새 전송 규칙을 만드는 방법을 보여줍니다.
이 규칙은 다음 조건에 적용됩니다.
- 메일 그룹 간 이 조건의 첫 번째 조건자 속성 값은 "Sales Group" 메일 그룹입니다. 이 조건의 두 번째 조건자 속성 값은 "Brokerage Group" 메일 그룹입니다.
다음 예외가 적용됩니다.
제목에 텍스트 패턴 사용 이 예외의 값은 "언론 보도" 또는 "기업 커뮤니케이션"입니다.
사용자로부터 이 예외의 값은 Ted Bremer 및 Pilar Ackerman입니다.
다음 작업은 이전에 설명되던 조건과 일치하지만 "제목에 텍스트 패턴 사용" 또는 "사용자로부터" 예외와 일치하지 않는 모든 메시지에 적용됩니다.
반송 메시지를 보낸 사람에게 전송 이 작업에 대한 값은 "영업 부서 및 증권 부서 사이의 전자 메일 메시지 전송 금지"입니다."
메시지를 포함하는 로그 이벤트 이 작업에 대한 값은 "금지된 전자 메일 메시지가 거부됨"입니다.
$Condition1 = Get-TransportRulePredicate BetweenMemberOf
$Condition1.Addresses = @((Get-DistributionGroup "Sales Group"))
$Condition1.Addresses2 = @((Get-DistributionGroup "Brokerage Group"))
$Exception1 = GetTransportRulePredicate From
$Exception1.Addresses = @((Get-MailUser "Ted Bremer"), (Get-MailUser "Pilar Ackerman"))
$Exception2 = Get-TransportRulePredicate SubjectContains
$Exception2.Words = @("Press Release", "Corporate Communication")
$Action1 = Get-TransportRuleAction RejectMessage
$Action1.RejectReason = "E-mail messages sent between the Sales department and the Brokerage department are prohibited."
$Action2 = Get-TransportRuleAction LogEvent
$Action2.EventMessage = "A prohibited e-mail message has been rejected."
New-TransportRule -name "Block e-mail messages between Sales and Brokerage groups" -Condition @($Condition1) -Exception @($Exception1, $Exception2) -Action @($Action1, $Action2)