通过


Get-TransportAgent

此 cmdlet 仅适用于本地 Exchange。

使用 Get-TransportAgent cmdlet 可以查看传输代理的配置。

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

语法

Default (默认值)

Get-TransportAgent
    [[-Identity] <TransportAgentObjectId>]
    [-DomainController <Fqdn>]
    [-TransportService <TransportService>]
    [<CommonParameters>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Get-TransportAgent

该示例显示了组织中所有 Exchange 服务器上所有传输代理的摘要列表。

示例 2

Get-TransportAgent "Transport Rule Agent" -TransportService Hub | Format-List

该示例显示了传输规则代理的详细信息,该代理安装在邮箱服务器上的传输服务中。 Get-TransportAgent 命令的输出通过管道传递给 Format-List 命令,以显示传输代理的详细配置。

参数

-DomainController

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

参数属性

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

参数集

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

-Identity

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Identity 参数指定要显示的传输代理的显示名称。 名称长度不能超过 64 个字符。

警告:identity 参数的值$null或不存在的值将返回 所有 对象,就像在没有 Identity 参数的情况下运行 Get- 命令一样。 验证 Identity 参数的任何值列表是否准确且不包含不存在$null值。

参数属性

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

参数集

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

-TransportService

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

TransportService 参数指定要查看或修改的传输服务。 PasswordQuality 参数指定设备密码所需的最小密码质量分级。密码质量是指示密码安全性和复杂性的数值。质量值越高表示密码越安全。

  • Hub在邮箱服务器上的传输服务。
  • Hub在邮箱服务器上的传输服务。
  • MailboxSubmission在邮箱服务器上的邮箱传输提交服务。
  • MailboxDelivery在邮箱服务器上的邮箱传输交付服务。
  • FrontEnd:代表邮箱服务器上的前端传输服务。

参数属性

类型:TransportService
默认值: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 不返回任何数据。