Get-SweepRule
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.
Get-SweepRule cmdlet을 사용하여 사서함에서 스윕 규칙을 봅니다. 스윕 규칙은 받은 편지함 클린 유지하는 데 도움이 되도록 정기적으로 실행됩니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Get-SweepRule
[[-Identity] <SweepRuleIdParameter>]
[-BypassScopeCheck]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Provider <String>]
[-ResultSize <Unlimited>]
[<CommonParameters>] Description
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Get-SweepRule이 예제에서는 모든 스윕 규칙의 요약 목록을 반환합니다.
예 2
Get-SweepRule -Mailbox julia@contoso.com다음은 지정한 사서함에 있는 모든 스윕 규칙의 요약 목록을 반환하는 예제입니다.
예 3
Get-SweepRule -Identity "x2hlsdpGmUifjFgxxGIOJw=="다음은 지정한 RuleId 속성 값을 사용하여 Sweep 규칙에 대한 자세한 정보를 반환하는 예제입니다.
매개 변수
-BypassScopeCheck
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
BypassScopeCheck 스위치는 명령을 실행하는 사용자의 scope 검사 무시할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DomainController
적용 가능: 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 2016, Exchange Server 2019, Exchange Online
Identity 매개 변수는 보려는 스윕 규칙을 지정합니다. 규칙을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- RuleId 속성(예: x2hlsdpGmUifjFgxxGIOJw==).
- Exchange Online: (예:
MailboxAlias\RuleIDrzaher\2hlsdpGmUifjFgxxGIOJw==). - 온-프레미스 Exchange: (예:
MailboxCanonicalName\RuleIDcontoso.com/Users/Rick Zaher\x2hlsdpGmUifjFgxxGIOJw==).
| 형식: | SweepRuleIdParameter |
| Position: | 1 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Mailbox
적용 가능: 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 |
-Provider
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Online
Provider 매개 변수는 지정된 공급자에 의해 결과를 필터링합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ResultSize
적용 가능: Exchange Online
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
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 |