다음을 통해 공유


New-HostedOutboundSpamFilterRule

이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.

New-HostedOutboundSpamFilterRule cmdlet을 사용하여 클라우드 기반 organization 아웃바운드 스팸 필터 규칙을 만듭니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

구문

Default (기본값)

New-HostedOutboundSpamFilterRule
    [-Name] <String>
    -HostedOutboundSpamFilterPolicy <HostedOutboundSpamFilterPolicyIdParameter>
    [-Comments <String>]
    [-Confirm]
    [-Enabled <Boolean>]
    [-ExceptIfFrom <RecipientIdParameter[]>]
    [-ExceptIfFromMemberOf <RecipientIdParameter[]>]
    [-ExceptIfSenderDomainIs <Word[]>]
    [-From <RecipientIdParameter[]>]
    [-FromMemberOf <RecipientIdParameter[]>]
    [-Priority <Int32>]
    [-SenderDomainIs <Word[]>]
    [-WhatIf]
    [<CommonParameters>]

Description

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 문서에서는 cmdlet에 대한 모든 매개 변수를 나열하지만 할당된 권한에 포함되지 않은 경우 일부 매개 변수에 액세스할 수 없을 수 있습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

New-HostedOutboundSpamFilterRule -Name "Contoso Executives" -HostedOutboundSpamFilterPolicy "Contoso Executives" -FromMemberOf Executives

이 예제에서는 임원 그룹의 구성원에게 적용되는 아웃바운드 스팸 필터 정책 이름 Contoso Executives와 연결된 Contoso Executives라는 새 아웃바운드 스팸 필터 규칙을 만듭니다.

매개 변수

-Comments

적용 가능: Exchange Online, Exchange Online Protection

Comments 매개 변수는 규칙의 용도, 변경 내역 등 규칙에 대한 설명을 지정합니다. 설명의 길이는 1,024자를 초과할 수 없습니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Confirm

적용 가능: Exchange Online, Exchange Online Protection

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

  • 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
  • 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Enabled

적용 가능: Exchange Online, Exchange Online Protection

Enabled 매개 변수는 규칙의 사용 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 규칙이 사용하도록 설정됩니다. 이 값은 기본값입니다.
  • $false: 규칙을 사용할 수 없습니다.

규칙의 속성에서 이 매개 변수의 값은 State 속성에 표시됩니다.

매개 변수 속성

형식:Boolean
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ExceptIfFrom

적용 가능: Exchange Online, Exchange Online Protection

ExceptIfFrom 매개 변수는 특정 보낸 사람의 메시지를 찾는 예외를 지정합니다. 보낸 사람을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

  • 이름
  • 별칭
  • DN(고유 이름)
  • DN(고유 이름)
  • 정식 DN
  • GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

매개 변수 속성

형식:

RecipientIdParameter[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ExceptIfFromMemberOf

적용 가능: Exchange Online, Exchange Online Protection

ExceptIfFromMemberOf 매개 변수는 그룹 멤버가 보낸 메시지를 찾는 예외를 지정합니다. 그룹을 고유하게 식별하는 어떤 값도 사용 가능합니다. 예시:

  • 이름
  • 별칭
  • DN(고유 이름)
  • DN(고유 이름)
  • 정식 DN
  • GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

매개 변수 속성

형식:

RecipientIdParameter[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ExceptIfSenderDomainIs

적용 가능: Exchange Online, Exchange Online Protection

ExceptIfSenderDomainIs 매개 변수는 지정된 도메인에서 이메일 주소가 있는 보낸 자를 찾는 예외를 지정합니다. 여러 개의 도메인을 쉼표로 구분하여 지정할 수 있습니다.

매개 변수 속성

형식:

Word[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-From

적용 가능: Exchange Online, Exchange Online Protection

From 매개 변수는 특정 보낸 사람의 메시지를 찾는 조건을 지정합니다. 보낸 사람을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

  • 이름
  • 별칭
  • DN(고유 이름)
  • DN(고유 이름)
  • 정식 DN
  • GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

매개 변수 속성

형식:

RecipientIdParameter[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-FromMemberOf

적용 가능: Exchange Online, Exchange Online Protection

FromMemberOf 매개 변수는 그룹 멤버가 보낸 메시지를 찾는 조건을 지정합니다. 그룹을 고유하게 식별하는 어떤 값도 사용 가능합니다. 예시:

  • 이름
  • 별칭
  • DN(고유 이름)
  • DN(고유 이름)
  • 정식 DN
  • GUID

Update 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"

매개 변수 속성

형식:

RecipientIdParameter[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-HostedOutboundSpamFilterPolicy

적용 가능: Exchange Online, Exchange Online Protection

HostedOutboundSpamFilterPolicy 매개 변수는 아웃바운드 스팸 필터 규칙과 연결된 아웃바운드 스팸 필터 정책을 지정합니다.

정책을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름
  • DN(고유 이름)
  • GUID.

기본 아웃바운드 스팸 필터 정책을 지정할 수 없으며 이미 다른 아웃바운드 스팸 필터 규칙과 연결된 정책을 지정할 수 없습니다.

매개 변수 속성

형식:HostedOutboundSpamFilterPolicyIdParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Name

적용 가능: Exchange Online, Exchange Online Protection

Name 매개 변수는 아웃바운드 스팸 필터 규칙의 고유한 이름을 지정합니다. 최대 길이는 64자입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

\ % & * + / = ? { } | < > ( ) ; : [ ] , " 문자를 사용하지 마세요.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Priority

적용 가능: Exchange Online, Exchange Online Protection

Priority 매개 변수는 규칙 처리 순서를 결정하는 규칙의 우선 순위 값을 지정합니다. 정수 값이 낮을수록 높은 우선 순위를 나타냅니다. 값 0은 우선 순위가 가장 높으며, 여러 규칙이 동일한 우선 순위 값을 가질 수 없습니다.

유효한 값과 이 매개 변수의 기본값은 기존 규칙의 수에 따라 달라집니다. 예를 들어 기존 규칙이 8개인 경우

  • 이 매개 변수의 유효한 값 및 기본값은 기존 규칙의 수에 따라 달라집니다. 예를 들어 기존 규칙이 8개인 경우
  • 기존의 8개 규칙에 사용할 수 있는 우선 순위 값은 0부터 7까지입니다.
  • 새 규칙(9번째 규칙)에 사용할 수 있는 우선 순위 값은 0부터 8까지입니다.

규칙의 우선 순위 값을 수정하면 목록의 규칙 위치가 지정한 우선 순위 값과 일치하도록 변경됩니다. 즉, 규칙의 우선 순위 값을 기존 규칙과 같은 값으로 설정하면 기존 규칙과 우선 순위가 더 낮은 다른 모든 규칙의 우선 순위 값이 1씩 커집니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SenderDomainIs

적용 가능: Exchange Online, Exchange Online Protection

SenderDomainIs 매개 변수는 지정된 도메인에서 이메일 주소가 있는 보낸 사람 을 찾는 조건을 지정합니다. 여러 개의 도메인을 쉼표로 구분하여 지정할 수 있습니다.

매개 변수 속성

형식:

Word[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

적용 가능: Exchange Online, Exchange Online Protection

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.