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 不返回任何数据。