Remove-CsTrustedApplicationComputer
上一次修改主题: 2012-03-26
删除受信任的应用程序计算机。
语法
Remove-CsTrustedApplicationComputer -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
建议将 Microsoft Lync Server 2010 部署中正在运行受信任应用程序的计算机添加到一个仅用于受信任应用程序的单独池中。但是,您可以将受信任应用程序计算机添加到同时用于其他用途的现有池中。使用此 cmdlet 可删除受信任的应用程序计算机。
使用此 cmdlet 删除受信任的应用程序计算机时,不仅将其从受信任的应用程序计算机列表中删除,还会从 Lync Server 2010 上的可用计算机列表中删除。换句话说,如果您调用 Get-CsTrustedApplicationComputer 或 Get-CsComputer,将不会再列出该计算机。如果受信任的应用程序计算机是池中的唯一计算机,则无法删除该计算机。如果您要删除池中的唯一计算机,则必须删除整个池(通过调用 Remove-CsTrustedApplicationPool 可实现此操作)。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsTrustedApplicationComputer cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTrustedApplicationComputer"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
XdsGlobalRelativeIdentity |
要删除的计算机的完全限定域名 (FQDN)。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.Xds.DisplayComputer 对象。接受通过管道传递的受信任应用程序计算机对象的输入。
返回类型
此 cmdlet 不会返回值。它会删除一个类型为 Microsoft.Rtc.Management.Xds.DisplayComputer 的对象。
示例
-------------------------- 示例 1 --------------------------
Remove-CsTrustedApplicationComputer -Identity Trust1.litwareinc.com
此示例删除 FQDN 为 Trust1.litwareinc.com 的计算机。
-------------------------- 示例 2 --------------------------
Get-CsTrustedApplicationComputer -Filter Trust* | Remove-CsTrustedApplicationComputer
此示例删除 FQDN 以字符串 Trust 开头的所有受信任的计算机。此示例首先调用 Get-CsTrustedApplicationComputer cmdlet,并为 Filter 参数传递值 Trust*。这将检索 FQDN 以 Trust 开头并以一组任意字符结尾的所有受信任的应用程序计算机。然后,将该计算机集合通过管道传递到 Remove-CsTrustedApplicationComputer cmdlet,后者会删除集合中的每一项(每台计算机)。请记住,如果删除这些计算机会导致空池,该操作将不会从池中删除计算机。