Remove-CsServerApplication
上一次修改主题: 2012-03-27
删除现有的服务器应用程序。服务器应用程序是由 Microsoft Lync Server 2010 托管的应用程序。
语法
Remove-CsServerApplication -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
服务器应用程序是指在 Lync Server 2010 下运行的各个程序。Remove-CsServerApplication cmdlet 为管理员提供了一种方法,用于删除作为 Lync Server 的一部分运行的任何应用程序。请注意,删除服务器应用程序与卸载该应用程序不同。当您运行 Remove-CsServerApplication 时,该应用程序不再在 Lync Server 下运行。但是,软件本身并未卸载,通过运行 New-CsServerApplication cmdlet 可以重新启用该应用程序。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Remove-CsServerApplication cmdlet:RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsServerApplication }
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的服务器应用程序的唯一标识符。服务器应用程序标识由托管应用程序的服务与应用程序名组成。例如,名为 QoEAgent 的服务器应用程序可能具有以下类似标识:service:Registrar:atl-cs-001.litwareinc.com/QoEAgent。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application 对象。Remove-CsServerApplication 接受通过管道传递的服务器应用程序对象的实例。
返回类型
Remove-CsServerApplication 删除 Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor"
在示例 1 中,删除 Identity 为 service:EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor 的服务器应用程序。由于标识必须是唯一的,因此该命令删除的应用程序始终不会超过一个。
-------------------------- 示例 2 --------------------------
Get-CsServerApplication | Where-Object {$_.Critical -eq $False} | Remove-CsServerApplication
在示例 2 中,将删除所有非关键服务器应用程序。为了执行此任务,该命令首先调用 Get-CsServerApplication,以返回组织中当前使用的所有服务器应用程序的集合。然后,将该集合通过管道传递到 Where-Object,后者会挑选 Critical 属性等于 False 的所有应用程序。然后,将筛选出的集合通过管道传递到 Remove-CsServerApplication,后者将删除集合中的每一项。
-------------------------- 示例 3 --------------------------
Get-CsServerApplication -Filter "service:EdgeServer:atl-cs-001.litwareinc.com/*" | Remove-CsServerApplication
上述命令删除配置为供服务 atl-cs-001.litwareinc.com 使用的所有服务器应用程序。为执行此操作,使用了带有 Filter 参数的 Get-CsServerApplication;筛选器值“service:EdgeServer:atl-cs-001.litwareinc.com/*”返回 Identity 以字符“service:EdgeServer:atl-cs-001.litwareinc.com/”开头的所有应用程序。接下来,将该集合通过管道传递到 Remove-CsServerApplication,后者将从 EdgeServer:atl-cs-001.litwareinc.com 中删除每个应用程序。