通过

Get-TransportRule

模块:
Exchange PowerShell

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。

使用 Get-TransportRule cmdlet 可查看组织中) (邮件流规则的传输规则。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Default （默认值） 

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.)"

在本地 Exchange 中，此示例返回在组织中强制实施名为 PII 的 DLP 策略的规则的摘要列表 (美国 ) 。

示例 4

Get-TransportRule | Where {$_.DlpPolicy -ne $null}

在本地 Exchange 中，此示例返回组织中强制实施 DLP 策略的所有规则的摘要列表。

参数

-DlpPolicy

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online

注意：此参数仅在本地 Exchange 中有效。

DlpPolicy 参数按指定数据丢失防护的名称筛选结果， (DLP) 策略。 如果值中有空格，请使用双引号 (") 将此值括起来。

利用组织中的 DLP 策略，可以防止意外泄露敏感数据。 每个 DLP 策略都使用一组传输规则强制实施。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DomainController

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

此参数只在本地 Exchange 中可用。

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。

边缘传输服务器上不支持 DomainController 参数。 边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ExcludeConditionActionDetails

适用：Exchange Online、Exchange Online Protection

此参数仅在基于云的服务中可用。

ExcludeConditionActionDetails 参数指定是否对结果隐藏特定详细信息。 有效值包含:

  • $true：“说明”、“条件”和“作”属性，以及任何配置的条件、异常和作属性值均为空。
  • $false：不隐藏任何属性或属性值。 此值为默认值。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Filter

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

Filter 参数使用 OPATH 筛选结果。 此参数搜索 Description 属性，其中包括条件、异常、操作以及传输规则的相关值。

此参数使用语法 "Description -like 'Text*'"。 例如，"Description -like '192.168.1.1*'"。

有关 Exchange 中的 OPATH 筛选器的详细信息，请参阅 其他 OPATH 语法信息。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Identity

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

Identity 参数指定要查看的规则。 可以使用唯一标识该规则的任何值。 例如：

  • 名称
  • 可分辨名称 (DN)
  • GUID

参数属性

类型:RuleIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:False
来自管道的值:True
来自管道的值（按属性名称）:True
来自剩余参数的值:False

-ResultSize

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。 默认值为 1000。

参数属性

类型:Unlimited
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-State

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online、Exchange Online Protection

State 参数指定按启用或禁用的规则筛选结果。 有效值包含:

  • 已启用：结果中仅返回已启用的规则。
  • 已禁用：结果中仅返回禁用的规则。

如果不使用此参数，则该命令返回所有规则（已启用的和已禁用的）。

参数属性

类型:RuleState
默认值:None
支持通配符:False
不显示: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 不返回任何数据。