Stop-CsWindowsService
Última modificación del tema: 2012-03-27
Stop-CsWindowsService permite detener un servicio de Microsoft Lync Server 2010.
Sintaxis
Stop-CsWindowsService [-Name <String>] [-ComputerName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Graceful <SwitchParameter>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Stop-CsWindowsService [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Graceful <SwitchParameter>] [-InputObject <NTService>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Muchos de los componentes de Lync Server 2010 se ejecutan como servicios estándar de Windows; por ejemplo, Aplicación de operador de conferencia es en realidad un servicio denominado RTCCAA. Si necesita detener un servicio de Lync Server, puede hacerlo usando el cmdlet Stop-CsWindowsService.
No olvide que Stop-CsWindowsService puede detener únicamente servicios de Lync Server. En consecuencia, se producirá un error si intenta detener un servicio ajeno a Lync Server (como el administrador de trabajos de impresión) con este cmdlet.
En el plano funcional, Stop-CsWindowsService es muy parecido al cmdlet genérico Stop-Service de Windows PowerShell. Así, si lo desea, podría usar Stop-Service para detener un servicio de Lync Server. En cualquier caso, Stop-CsWindowsService incluye un parámetro ComputerName que facilita la detención de un servicio en un equipo remoto: solo necesita incluir este parámetro seguido del nombre de dominio completo (FQDN) del equipo remoto. El cmdlet Stop-Service no tiene un parámetro comparable. Además, Stop-CsWindowsService tiene un parámetro Report que permite mantener un registro de los errores que pudieran producirse cuando se llama a este cmdlet.
Stop-CsWindowsService hace exactamente lo que indica su nombre: detiene cualquier servicio que desee detener, aunque sea un servicio que tenga servicios dependientes (es decir, que se ejecuten solo cuando lo haga el servicio que trata de detener). De manera predeterminada, si intenta detener un servicio que tiene servicios dependientes, Stop-CsWindowsService no solo detendrá el servicio en cuestión, sino también todos los servicios dependientes. Dado que esto puede producir consecuencias inesperadas, incluya el parámetro Graceful cuando llame a Stop-CsWindowsService. De esta forma, Stop-CsWindowsService evitará que el servicio en cuestión acepte solicitudes. Todas las solicitudes de servicio existentes se mantendrán como están, pero las nuevas solicitudes se rechazarán. A medida que las solicitudes existentes vayan finalizando, no se sustituirán. Al final, todas las solicitudes existentes se completarán y el servicio se apagará.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Stop-CsWindowsService localmente: RTCUniversalServerAdmins. Además, para ejecutar este cmdlet también es necesario poseer derechos de administrador local en el equipo de destino. 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 "Stop-CsWindowsService"}
Parámetros
| Parameter | Requerido | Tipo | Descripción |
|---|---|---|---|
Name |
Opcional |
Cadena de caracteres |
Nombre del servicio de Lync Server que desea detener. Recuerde que debe usar el nombre del servicio (por ejemplo, RTCCAA) y no el nombre para mostrar del servicio. Solo se puede pasar un nombre de servicio al parámetro Name y no se pueden usar caracteres comodín en el nombre del servicio. Puede usar el cmdlet Get-CsWindowsService para recuperar nombres de servicio. Recuerde que Stop-CsWindowsService solo puede detener servicios de Lync Server. No puede usar este cmdlet para detener otros servicios de Windows. Para estos servicios, puede que sea posible usar el cmdlet Stop-Service de Windows PowerShell. |
ComputerName |
Opcional |
Cadena de caracteres |
Nombre del equipo remoto que ejecuta el servicio que ha de detenerse. Si este parámetro no se incluye, Stop-CsWindowsService detendrá en el equipo local el servicio especificado. Se debe hacer referencia al equipo remoto mediante su FQDN; por ejemplo, atl-mcs-001.litwareinc.com. |
Graceful |
Opcional |
Parámetro modificador |
En lugar de apagar el servicio inmediatamente, espera a que todas las solicitudes de servicio existentes se hayan completado (si bien se rechazarán todas las nuevas solicitudes). El servicio no se apagará totalmente hasta que se hayan completado todas las solicitudes existentes. |
InputObject |
Opcional |
Objeto NTService |
Permite detener un servicio usando una referencia de objeto en lugar de un nombre de servicio. Por ejemplo, si usa Get-CsWindowsService para devolver información sobre un servicio y almacena el objeto devuelto en una variable llamada $x, puede detener el servicio usando el siguiente comando: $x = Get-CsWindowsService –Name "RTCCPS" Stop-CsWindowsService -InputObject $x.Name |
NoWait |
Opcional |
Parámetro modificador |
Cuando está presente, hace que el comando se ejecute y devuelva inmediatamente el control al aviso de Windows PowerShell. Si no está, no se devolverá el control hasta que el comando haya finalizado y se haya escrito en la pantalla un informe de estado. |
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. |
Report |
Opcional |
Cadena de caracteres |
Ruta a un archivo HTML en el que es posible escribir la información de error. Si se incluye este parámetro, todos los errores que se produzcan durante la ejecución de este cmdlet se registrarán en el archivo especificado (por ejemplo, C:\Logs\Service_report.html). |
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.Deployment.Core.NTService. Stop-CsWindowsService acepta instancias transferidas del objeto de servicio de Windows.
Tipos de valores devueltos
Ninguno. En su lugar, Stop-CsWindowsService detiene las instancias del objeto Microsoft.Rtc.Management.Deployment.Core.NTService.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Stop-CsWindowsService -Name "RTCRGS"
El comando que se muestra en el ejemplo 1 detiene el servicio de Aplicación de grupo de respuesta en el equipo local. El servicio Aplicación de grupo de respuesta se identifica al incluir el parámetro Name y del nombre de dicho servicio: RTCRGS.
-------------------------- Ejemplo 2 ------------------------
Stop-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com
En el ejemplo 2 también se detiene el servicio Aplicación de grupo de respuesta. Sin embargo, en este ejemplo, dicho servicio se encuentra en el equipo local atl-cs-001.litwareinc.com. Para detener un servicio en un equipo remoto, incluya el parámetro ComputerName seguido del FQDN del equipo remoto.
-------------------------- Ejemplo 3 ------------------------
Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Call Park*"} | Stop-CsWindowsService
En el Ejemplo 3 se muestra cómo detener un servicio incluso sin saber su nombre (en este ejemplo, RTCCPS). Para hacerlo, el comando llama primero a Get-CsWindowsService (sin ningún parámetro) para devolver una colección de todos los servicios de Lync Server en el equipo local. Esta colección completa se transfiere después al cmdlet Where-Object, que selecciona solo los servicios en los que la propiedad DisplayName incluya el valor de cadena "Call Park". La colección filtrada se transfiere a continuación a Stop-CsWindowsService, que detiene el servicio Aplicación de estacionamiento de llamadas.