Remove-CsTrustedApplication
上一次修改主题： 2012-03-26
从关联的受信任服务中删除受信任应用程序。
语法
Remove-CsTrustedApplication -Identity <ExternalApplicationIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
受信任应用程序是第三方开发的应用程序，向其授予受信任状态以使其作为 Microsoft Lync Server 2010 的一部分运行，但它不是产品的内置部分。此 cmdlet 从受信任应用程序池中删除受信任应用程序。注意，不删除应用程序自身，而是仅删除与受信任应用程序池和受信任服务的关联。
使用此 cmdlet 删除受信任应用程序时，必须提供 Identity 参数的值。Identity 是托管应用程序的池的完全限定域名 (FQDN) 后跟左斜线 (/) 再跟应用程序 ID。例如 TrustPool.litwareinc.com/tapp2，其中 TrustPool.litwareinc.com 是池 FQDN，tapp2 是应用程序 ID。注意，如果通过调用 Get-CsTrustedApplication 查看现有应用程序，则将看到类似于这种形式的 ID：TrustPool.litwareinc.com/urn:application:tapp2。请注意应用程序名称 (tapp2) 之前的前缀urn:application:。虽然此前缀是 Identity 的一部分，但在指定 Identity 参数的值时不需要此前缀。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsTrustedApplication cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTrustedApplication\b"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
外部应用程序标识 |
要从受信任应用程序池中删除的受信任应用程序的唯一标识符。必须按照格式 <池 FQDN>/<应用程序 ID> 输入 Identity 值，其中“池 FQDN”是应用程序所在的池的 FQDN，“应用程序 ID”是应用程序的名称。 |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.Xds.DisplayTrustedApplication 对象。接受通过管道传递的受信任应用程序对象的输入。
返回类型
此 cmdlet 不返回值。它删除一个类型为 Microsoft.Rtc.Management.Xds.DisplayTrustedApplication 的对象。
示例
-------------------------- 示例 1 ------------------------
Remove-CsTrustedApplication -Identity TrustPool.litwareinc.com/tapp2
此示例从关联的受信任服务中删除 Identity 为 TrustPool.litwareinc.com/tapp2 的受信任应用程序。
-------------------------- 示例 2 ------------------------
Get-CsTrustedApplication -Filter *trust* | Remove-CsTrustedApplication
示例 2 删除标识中包括字符串“trust”的所有受信任应用程序。命令首先调用 Get-CsTrustedApplication，其中传递 *trust* 的 Filter 值。此命令将检索在 Identity 中的任意位置具有字符串 trust 的所有受信任应用程序。然后，将检索的受信任应用程序的集合通过管道传递给 Remove-CsTrustedApplication cmdlet，后者删除每个受信任应用程序。（注意，不删除应用程序自身，而是仅删除与受信任应用程序池和受信任服务的关联。）