Get-CsTrustedApplicationPool
上一次修改主题: 2012-03-23
检索包含托管受信任应用程序的计算机的一个或多个池的设置。
语法
Get-CsTrustedApplicationPool [-Identity <XdsGlobalRelativeIdentity>] [-PoolFqdn <String>]
Get-CsTrustedApplicationPool [-Filter <String>] [-PoolFqdn <String>]
详细说明
建议将 Microsoft Lync Server 2010 部署中正在运行受信任应用程序的计算机添加到一个仅用于受信任应用程序的单独池中。但是,您可以将受信任应用程序计算机添加到同时用于其他用途的现有池中。此 cmdlet 可检索定义为受信任应用程序池的一个或多个池。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Get-CsTrustedApplicationPool cmdlet:RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回已分配此 cmdlet 的基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的所有自定义 RBAC 角色),请从 Windows PowerShell 提示符运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsTrustedApplicationPool"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
可选 |
XdsGlobalRelativeIdentity |
要检索其设置的池的完全限定域名 (FQDN) 或服务 ID。 |
Filter |
可选 |
字符串 |
包含一个或多个通配符的字符串,该字符串用于搜索 Identity 与通配符字符串相匹配的池。例如,如果指定字符串 *Redmond*,则系统将检索标识包含字符串 Redmond 的所有受信任应用程序池,如 TrustedApplicationPool:Redmond.litwareinc.com。 |
PoolFqdn |
可选 |
字符串 |
要检索的池的 FQDN。这与 Identity 参数操作方式相同,不同之处在于 Identity 还可以接受服务 ID。 |
输入类型
无。
返回类型
检索一个或多个类型为 Microsoft.Rtc.Management.Xds.DisplayExternalServer 的对象。
示例
-------------------------- 示例 1 --------------------------
Get-CsTrustedApplicationPool
示例 1 检索 Lync Server 2010 部署内定义为受信任应用程序池的所有池。
-------------------------- 示例 2 --------------------------
Get-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com
在此示例中,我们使用 Identity 参数确保仅检索一个受信任应用程序池,在此处是 FQDN 为 TrustPool.litwareinc.com 的池。
-------------------------- 示例 3 --------------------------
Get-CsTrustedApplicationPool -Filter *:TrustPool.*
此示例将在池 FQDN 中检索包含站点 TrustPool 的所有受信任应用程序池。使用值为 *:TrustPool.* 的 Filter 参数。该筛选器字符串将搜索包含字符串“:TrustPool.”的所有受信任应用程序池的 Identity 值。例如,此命令将检索 Identity 值为 TrustedApplicationPool:TrustPool.litwareinc.com 的池。
-------------------------- 示例 4 --------------------------
Get-CsTrustedApplicationPool | Where-Object {$_.ServiceId -like "Redmond1*"}
Filter 参数仅针对 Identity 进行搜索,对于受信任应用程序池,则针对格式为 TrustedApplicationPool:<FQDN> 的服务 ID 进行搜索。此示例将针对格式为 <site>-ExternalServer-<id> 的服务 ID 搜索池,例如,Redmond1-ExternalServer-1。这将允许用户查找特定站点上托管的受信任池。此示例首先调用不带参数的 Get-CsTrustedApplicationPool,以检索所有受信任应用程序池的集合。然后,将该集合通过管道传递到 Where-Object cmdlet,后者将该集合的范围缩减到仅包含服务 ID ($_.ServiceId) 与通配符字符串 Redmond1* 匹配 (-like) 的池。结果将是 FQDN 以字符串 Redmond1 开头的所有受信任应用程序池(如 Redmond1-ExternalServer-1、Redmond1-ExternalServer-2 和 Redmond1-ExternalServer-3)的集合。