Remove-CsServerApplication
Última modificación del tema: 2012-03-27
Quita una aplicación existente del servidor. Las aplicaciones de servidor son aplicaciones hospedadas por Microsoft Lync Server 2010.
Sintaxis
Remove-CsServerApplication -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Las aplicaciones de servidor son los programas individuales que se ejecutan en Lync Server 2010. El cmdlet Remove-CsServerApplication proporciona una método para que los administradores eliminen cualquier aplicación que se ejecute como parte de Lync Server. Tenga en cuenta que eliminar una aplicación de un servidor no es lo mismo que desinstalar una aplicación. Cuando se ejecuta Remove-CsServerApplication, la aplicación deja de ejecutarse en Lync Server. Sin embargo, el software no se desinstala y la aplicación puede volver a habilitarse usando el cmdlet New-CsServerApplication.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsServerApplication localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsServerApplication }
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único de la aplicación de servidor que se eliminará. Las Identidades de las aplicaciones de servidor están formadas por el servicio donde se hospeda la aplicación y el nombre de la aplicación. Por ejemplo, la aplicación de servidor llamada QoEAgent podría tener una Identidad similar a esta: service:Registrar:atl-cs-001.litwareinc.com/QoEAgent. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no son graves y que pueden surgir al ejecutar el comando. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application. Remove-CsServerApplication acepta instancias transferidas del objeto de aplicación del servidor.
Tipos de valores devueltos
Remove-CsServerApplication elimina las instancias existentes del objeto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Remove-CsServerApplication -Identity "service:EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor"
En el ejemplo 1 se quita la aplicación de servidor con Identity igual a service:EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor. Dado que las Identidades han de ser únicas, este comando nunca eliminará más de una aplicación.
-------------------------- Ejemplo 2 ------------------------
Get-CsServerApplication | Where-Object {$_.Critical -eq $False} | Remove-CsServerApplication
En el Ejemplo 2, se eliminan todas las aplicaciones que no son fundamentales para el servidor. Para realizar esta tarea, el comando llama primero a Get-CsServerApplication para devolver una colección de todas las aplicaciones de servidor que se usan en la organización. Esta colección se transfiere a Where-Object, que selecciona todas las aplicaciones en las que la propiedad Critical sea igual a False. A continuación, la colección filtrada se transfiere a Remove-CsServerApplication, que elimina cada uno de los elementos de la colección.
-------------------------- Ejemplo 3 ------------------------
Get-CsServerApplication -Filter "service:EdgeServer:atl-cs-001.litwareinc.com/*" | Remove-CsServerApplication
El comando anterior elimina todas las aplicaciones del servidor que han sido configuradas para su uso por parte del servicio EdgeServer:atl-cs-001.litwareinc.com. Para ello, se usa Get-CsServerApplication junto al parámetro Filter. El valor de filtrado "service:EdgeServer:atl-cs-001.litwareinc.com/*" devuelve todas las aplicaciones con un parámetro Identity que comience por los caracteres "service:EdgeServer:atl-cs-001.litwareinc.com/". Después, la colección se transfiere a Remove-CsServerApplication, que elimina cada aplicación de EdgeServer:atl-cs-001.litwareinc.com.