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