Get-TransportRule
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Get-TransportRule cmdlet 查看组织中) (邮件流规则的传输规则。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Get-TransportRule
[[-Identity] <RuleIdParameter>]
[-DomainController <Fqdn>]
[-State <RuleState>]
[-DlpPolicy <String>]
[-ExcludeConditionActionDetails <Boolean>]
[-Filter <String>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
说明
在邮箱服务器上,此 cmdlet 返回 Exchange 组织中存储在 Active Directory 中的所有规则。 在边缘传输服务器上,此 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 策略的规则摘要列表 (U.S.) 。
示例 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 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
边缘传输服务器上不支持 DomainController 参数。 边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。
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 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求,则请将此参数的值设为无限制。 默认值为 1000。
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 不返回任何数据。