Get-TransportRule
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수 및 설정은 한 환경 또는 다른 환경에만 사용할 수 있습니다.
Get-TransportRule cmdlet을 사용하여 organization 전송 규칙(메일 흐름 규칙)을 봅니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Get-TransportRule
[[-Identity] <RuleIdParameter>]
[-DomainController <Fqdn>]
[-State <RuleState>]
[-DlpPolicy <String>]
[-ExcludeConditionActionDetails <Boolean>]
[-Filter <String>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
사서함 서버에서 이 cmdlet은 Active Directory에 저장된 Exchange organization 모든 규칙을 반환합니다. Edge 전송 서버에서 이 cmdlet은 로컬 서버에 구성된 규칙만 반환합니다.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 문서에서는 cmdlet에 대한 모든 매개 변수를 나열하지만 할당된 권한에 포함되지 않은 경우 일부 매개 변수에 액세스할 수 없을 수 있습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Get-TransportRule
이 예제에서는 organization 모든 규칙의 요약 목록을 반환합니다.
예 2
Get-TransportRule "Ethical Wall - Sales and Brokerage Departments" | Format-List
이 예제에서는 "윤리적 벽 - 영업 및 중개 부서"라는 규칙에 대한 자세한 정보를 반환합니다.
파이프라인에 대한 자세한 내용은 파이프라인 정보를 참조하세요. 명령의 출력을 사용하는 방법에 대한 자세한 내용은 명령 출력 작업을 참조하세요.
예 3
Get-TransportRule -DlpPolicy "PII (U.S.)"
온-프레미스 Exchange에서 이 예제에서는 organization PII(미국)라는 DLP 정책을 적용하는 규칙의 요약 목록을 반환합니다.
예 4
Get-TransportRule | Where {$_.DlpPolicy -ne $null}
온-프레미스 Exchange에서 이 예제에서는 organization DLP 정책을 적용하는 모든 규칙의 요약 목록을 반환합니다.
매개 변수
-DlpPolicy
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
참고: 이 매개 변수는 온-프레미스 Exchange에서만 작동합니다.
DlpPolicy 매개 변수는 지정된 DLP(데이터 손실 방지) 정책의 이름으로 결과를 필터링합니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
조직에서 DLP 정책을 사용하면 중요한 정보의 무단 공개를 방지할 수 있습니다. 각 DLP 정책은 전송 규칙 집합을 사용하여 적용됩니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-DomainController
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com
Microsoft Edge 전송 서버에서는 DomainController 매개 변수가 지원되지 않습니다. Microsoft Edge 전송 서버는 AD LDS(Active Directory Lightweight Directory Service)의 로컬 인스턴스를 사용하여 데이터를 읽고 씁니다.
매개 변수 속성
| 형식: | Fqdn |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ExcludeConditionActionDetails
적용 가능: 온-프레미스 사서함에 대한 Exchange Online 기본 제공 보안 추가 기능
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
ExcludeConditionActionDetails 매개 변수는 결과에서 특정 세부 정보를 숨길지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 설명, 조건 및 작업 속성뿐만 아니라 구성된 조건, 예외 및 작업 속성 값은 비어 있습니다.
- $false: 속성 또는 속성 값이 숨겨지지 않습니다. 이 값은 기본값입니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Filter
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, 온-프레미스 사서함에 대한 기본 제공 보안 추가 기능
Filter 매개 변수는 OPATH를 사용하여 결과를 필터링합니다. 이 매개 변수는 전송 규칙의 조건, 예외, 작업 및 관련 값을 포함하는 Description 속성을 검색합니다.
이 매개 변수는 "Description -like 'Text*'" 구문을 사용합니다. 예를 들면 "Description -like '192.168.1.1*'"와 같습니다.
Exchange의 OPATH 필터에 대한 자세한 내용은 추가 OPATH 구문 정보를 참조하세요.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, 온-프레미스용 기본 제공 보안 추가 기능 사서함
Identity 매개 변수는 보려는 규칙을 지정합니다. 규칙을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:
- 이름
- DN(고유 이름)
- GUID
주의: identity 매개 변수의 값 $null 또는 존재하지 않는 값은 Identity 매개 변수 없이 Get- 명령을 실행한 것처럼 모든 개체를 반환합니다. Identity 매개 변수에 대한 값 목록이 정확하고 존재하지 않는 $null 값이 포함되어 있지 않은지 확인합니다.
매개 변수 속성
| 형식: | RuleIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-ResultSize
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, 온-프레미스 사서함에 대한 기본 제공 보안 추가 기능
ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 쿼리와 일치하는 모든 요청을 반환하려면 이 매개 변수의 값으로 unlimited를 사용합니다. 기본값은 1,000입니다.
매개 변수 속성
| 형식: | Unlimited |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-State
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, 온-프레미스용 기본 제공 보안 추가 기능 사서함
State 매개 변수는 사용 또는 사용 안 함 규칙을 사용하여 결과를 필터링하도록 지정합니다. 유효한 값은 다음과 같습니다.
- 사용: 활성화된 규칙만 결과에 반환됩니다.
- 사용 안 함: 비활성화된 규칙만 결과에 반환됩니다.
이 매개 변수를 사용하지 않으면 사용하도록 설정된 규칙과 사용하지 않도록 설정된 규칙이 모두 반환됩니다.
매개 변수 속성
| 형식: | RuleState |
| 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를 참조하세요.
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.