Remove-CsTrustedApplicationPool
上一次修改主题: 2012-03-25
删除包含托管受信任应用程序的计算机的池。
语法
Remove-CsTrustedApplicationPool -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
建议将 Microsoft Lync Server 2010 部署中正在运行受信任应用程序的计算机添加到一个仅用于受信任应用程序的单独池中。但是,您可以将受信任应用程序计算机添加到同时用于其他用途的现有池中。该 cmdlet 可删除现有的受信任应用程序池。然而,不能删除未包含 Registrar 值的受信任应用程序池。如果没有为受信任应用程序池分配 Registrar,则必须使用 Set-CsTrustedApplicationPool cmdlet 添加 Registrar 值,然后删除该池。
请记住,删除池也会删除与该池相关联的所有计算机、应用程序和应用程序终结点。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsTrustedApplicationPool cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTrustedApplicationPool"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
XdsGlobalRelativeIdentity |
要删除的池的完全限定域名 (FQDN) 或服务 ID。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.Xds.DisplayExternalServer 对象。接受通过管道传递的受信任应用程序池对象的输入。
返回类型
此 cmdlet 不会返回值。它会删除类型为 Microsoft.Rtc.Management.Xds.DisplayExternalServer 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com
此示例删除 FQDN 为 TrustPool.litwareinc.com 的池。我们使用 Identity 参数来指定要删除的池的 FQDN。由于标识是唯一的,因此该命令最多只会删除一个池。
-------------------------- 示例 2 --------------------------
Get-CsTrustedApplicationPool | Where-Object {$_.PoolFqdn -match "trust*"} | Remove-CsTrustedApplicationPool
此示例删除 FQDN 以字符串“trust”开头的所有受信任池。该命令的第一部分调用 Get-CsTrustedApplicationPool cmdlet,以检索 Lync Server 2010 基础结构中所有受信任应用程序池的集合。将此集合通过管道传递到 Where-Object cmdlet。Where-Object cmdlet 将检查集合中的每一项,确定 PoolFqdn 是否与通配符字符串 trust* 相匹配。这将生成一个 PoolFqdn 以字符串 trust 开头,后跟任意字符的所有受信任应用程序池的集合。最后,将此集合通过管道传递到 Remove-CsTrustedApplicationPool cmdlet,后者将删除集合中的每一项。