Get-CsTrustedApplication
上一次修改主题： 2012-03-23
检索受信任应用程序的设置。
语法
Get-CsTrustedApplication [-Identity <ExternalApplicationIdentity>]
Get-CsTrustedApplication [-Filter <String>]
Get-CsTrustedApplication [-ApplicationId <String>] [-TrustedApplicationPoolFqdn <String>]
详细说明
受信任应用程序是由第三方开发的应用程序，该应用程序被给予了受信任状态可作为 Microsoft Lync Server 2010 的一部分运行，但不是产品的内置部分。通过此 cmdlet 可以检索一个或多个受信任应用程序的端口和全局可路由用户代理 URI (GRUU) 设置。
使用此 cmdlet 检索单个受信任应用程序时，必须为 Identity 参数提供值。Identity 由应用程序所在的池的完全限定域名 (FQDN)，后跟斜线 (/)，再后跟应用程序 ID 组成。例如，TrustPool.litwareinc.com/tapp2，其中 TrustPool.litwareinc.com 是池 FQDN，tapp2 是应用程序 ID。请注意，通过调用此 cmdlet 来检索应用程序时，将会看到非常类似以下的 ID：TrustPool.litwareinc.com/urn:application:tapp2。请注意应用程序名称 (tapp2) 之前的前缀urn:application:。虽然此前缀属于 Identity 的一部分，但在为 Identity 参数指定值时不需要该前缀。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsTrustedApplication cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins 和 RTCUniversalReadOnlyAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsTrustedApplication\b"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
ExternalApplicationIdentity |
要检索的受信任应用程序的唯一标识符。必须按照格式 <池 FQDN>/<应用程序 ID> 输入 Identity 值，其中“池 FQDN”是应用程序所在的池的 FQDN，“应用程序 ID”是应用程序的名称。请注意，如果指定 Identity，则不能指定 ApplicationID 或 TrustedApplicationPoolFqdn。 |
Filter |
可选 |
字符串 |
一个包含通配符的字符串，用于根据与给定通配符字符串匹配的 Identity 值来检索受信任的应用程序。Identity 由受信任应用程序池 FQDN，后跟斜线 (/)，再后跟受信任应用程序 ID 组成。Filter 值将与 Identity 的任何部分匹配，包括 FQDN 和应用程序 ID。 |
ApplicationId |
可选 |
字符串 |
应用程序的名称。这可以包含应用程序 ID 前缀（但非必须）。例如，ApplicationId 值 urn:application:tapp1 和 tapp1 会返回同一个应用程序。如果为 ApplicationId 提供值，则不能为 Identity 提供值，但必须为 TrustedApplicationPoolFqdn 参数提供值。 |
TrustedApplicationPoolFqdn |
可选 |
字符串 |
应用程序所在的受信任应用程序池的 FQDN。如果为 TrustedApplicationPoolFqdn 提供值，则不能为 Identity 提供值，但必须为 ApplicationID 参数提供值。 |
输入类型
无。
返回类型
返回一个类型为 Microsoft.Rtc.Management.Xds.DisplayTrustedApplication 的对象。
示例
-------------------------- 示例 1 --------------------------
Get-CsTrustedApplication
此示例检索有关 Lync Server 2010 部署中定义的所有受信任应用程序的信息。
-------------------------- 示例 2 --------------------------
Get-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2
示例 2 检索 Identity 为 TrustPool.litwareinc.com/urn:application:tapp2 的受信任应用程序。请注意，可以省去 urn:application: 前缀，Get-CsTrustedApplication 会自动添加前缀并检索正确的应用程序。
-------------------------- 示例 3 --------------------------
Get-CsTrustedApplication -Filter *trust*
示例 3 检索 Identity 与指定为 Filter 值的通配符字符串匹配的所有受信任应用程序。在此示例中，通过 Filter 值 *trust*，该命令将检索 Identity 中任意位置包含字符串“trust”的所有受信任应用程序。此字符串可以包含在 Identity 的任何部分中，例如池 FQDN 或应用程序 ID 中。因此，此命令将检索具有以下 Identity 的受信任应用程序，例如 TrustedPool.litwareinc.com/urn:application:application1、Pool1.litwareinc.com/urn:application:trustedapp 和 Pool1.litwareinc.com/urn:application:trust。
-------------------------- 示例 4 --------------------------
Get-CsTrustedApplication -ApplicationId tapp2 -TrustedApplicationPoolFqdn TrustPool.litwareinc.com
示例 4 将返回与示例 2（其中 Identity 指定为唯一参数）相同的结果。两个示例之间的唯一差别是，示例 2 根据 Identity（由受信任池 FQDN 后跟应用程序 ID 组成）来检索受信任应用程序。在此示例中，应用程序 ID 和受信任池 FQDN 被输入作为两个不同参数的值：ApplicationId 和 TrustedApplicationPoolFqdn。
-------------------------- 示例 5 --------------------------
Get-CsTrustedApplication | Where-Object {$_.TrustedApplicationPoolFqdn -eq "TrustPool.litwareinc.com"}
示例 5 检索池 TrustPool.litwareinc.com 中的所有受信任应用程序。该示例首先调用 Get-CsTrustedApplication cmdlet。这将返回 Lync Server 部署中定义的所有受信任应用程序的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会逐项查找整个集合，以找到 TrustedApplicationPoolFqdn 属性值等于 (-eq) TrustPool.litwareinc.com 的设置。