다음을 통해 공유

Get-InboxRule

모듈:
ExchangePowerShell
적용 대상:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.

Get-InboxRule cmdlet을 사용하여 받은 편지함 규칙 속성을 봅니다. 받은 편지함 규칙은 지정된 조건에 따라 받은 편지함의 메시지를 처리하고 지정된 폴더로 메시지 이동, 메시지 삭제 등의 작업을 수행하는 데 사용됩니다.

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

구문

Get-InboxRule
   [[-Identity] <InboxRuleIdParameter>]
   [-BypassScopeCheck]
   [-DescriptionTimeFormat <String>]
   [-DescriptionTimeZone <ExTimeZoneValue>]
   [-DomainController <Fqdn>]
   [-IncludeHidden]
   [-Mailbox <MailboxIdParameter>]
   [-ResultSize <Unlimited>]
   [-SkipCount <Int32>]
   [-SweepRules]
   [-UseCustomRouting]
   [<CommonParameters>]

Description

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

참고: 이 cmdlet은 Exchange Online View-Only 조직 관리 역할 그룹의 구성원 또는 Microsoft Entra ID 전역 읽기 권한자 역할에 대해 작동하지 않습니다.

예제

예 1

Get-InboxRule -Mailbox Joe@Contoso.com

다음은 사서함 Joe@Contoso.com에 대한 모든 받은 편지함 규칙을 검색하는 예제입니다.

예 2

Get-InboxRule "ReceivedLastYear" -Mailbox joe@contoso.com -DescriptionTimeFormat "MM/dd/yyyy" -DescriptionTimeZone "Pacific Standard Time"

다음은 규칙을 만들 때 ReceivedBeforeDate 매개 변수가 설정된 사서함 joe@contoso.com 에서 받은 편지함 규칙 ReceivedLastYear를 검색하는 예제입니다. DescriptionTimeFormat 및 DescriptionTimeZone 매개 변수는 이 예제에서 규칙의 Description 속성에 사용되는 시간 및 표준 시간대의 서식을 지정하는 데 사용됩니다.

매개 변수

-BypassScopeCheck

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Online

BypassScopeCheck 스위치는 명령을 실행하는 사용자의 scope 검사 무시할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DescriptionTimeFormat

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

DescriptionTimeFormat 매개 변수는 규칙 설명의 시간 값 형식을 지정합니다. 예시:

MM/dd/yyyy는 MM이 2자리 월이고 dd는 2자리 일이고 yyyy는 4자리 연도입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DescriptionTimeZone

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

DescriptionTimeZone 매개 변수는 규칙 설명의 시간 값에 사용되는 표준 시간대를 지정합니다.

$false: 규칙이나 정책은 사용되지 않도록 설정되어 있습니다.

사용 가능한 값을 보려면 명령을 $TimeZone = Get-ChildItem "HKLM:\Software\Microsoft\Windows NT\CurrentVersion\Time zones" | foreach {Get-ItemProperty $_.PSPath}; $TimeZone | sort Display | Format-Table -Auto PSChildname,Display실행합니다.

값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다. 기본값은 Exchange 서버의 표준 시간대 설정입니다.

형식:ExTimeZoneValue
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DomainController

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

형식:Fqdn
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Identity

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Identity 매개 변수는 보려는 받은 편지함 규칙을 지정합니다. 규칙을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

  • 이름
  • RuleIdentity 속성(예: 16752869479666417665).
  • Exchange Online: (예: MailboxAlias\RuleIdentityrzaher\16752869479666417665).
  • 온-프레미스 Exchange: (예: MailboxCanonicalName\RuleIdentitycontoso.com/Users/Rick Zaher\16752869479666417665).
형식:InboxRuleIdParameter
Position:1
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-IncludeHidden

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

IncludeHidden 스위치는 결과에 숨겨진 받은 편지함 규칙을 포함할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Mailbox

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Mailbox 매개 변수는 받은 편지함 규칙이 포함되어 있는 사서함을 지정합니다. 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

  • 이름
  • 별칭
  • DN(고유 이름)
  • DN(고유 이름)
  • Domain\Username
  • 전자 메일 주소
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 사용자 ID 또는 UPN(사용자 계정 이름)
형식:MailboxIdParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ResultSize

적용 가능: Exchange Online, Exchange Online Protection

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 쿼리와 일치하는 모든 요청을 반환하려면 이 매개 변수의 값으로 unlimited를 사용합니다. 기본값은 1,000입니다.

형식:Unlimited
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SkipCount

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

{{ Fill SkipCount Description }}

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SweepRules

적용 가능: Exchange Server 2016, Exchange Server 2019

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

SweepRules 스위치는 결과에서 스윕 규칙만 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

스윕 규칙은 받은 편지함 클린 유지하는 데 도움이 되도록 정기적으로 실행됩니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UseCustomRouting

적용 가능: Exchange Online

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

{{ Fill UseCustomRouting description }}

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Input types

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

출력

Output types

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.