Start-CsWindowsService
Última modificación del tema: 2012-03-27
Start-CsWindowsService permite iniciar un servicio de Microsoft Lync Server 2010.
Sintaxis
Start-CsWindowsService [-Name <String>] [-ComputerName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]
Start-CsWindowsService [-Confirm [<SwitchParameter>]] [-Force <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 uno de los servicios de Lync Server está detenido actualmente, puede reiniciarlo usando el cmdlet Start-CsWindowsService.
No obstante, no olvide que Start-CsWindowsService puede iniciar únicamente servicios de Lync Server. En consecuencia, se producirá un error si intenta iniciar un servicio ajeno a Lync Server (como el administrador de trabajos de impresión) con este cmdlet.
En el plano funcional, Start-CsWindowsService es muy parecido al cmdlet genérico Start-Service de Windows PowerShell. Así, si lo desea, también podría usar Start-Service para iniciar un servicio de Lync Server. Por otra parte, Start-CsWindowsService incluye un parámetro ComputerName que facilita el inicio de un servicio en un equipo remoto: solo necesita incluir este parámetro seguido del nombre de dominio completo (FQDN) del equipo remoto. Stop-Service carece de un parámetro comparable. Además, el parámetro Report del cmdlet permite mantener un registro de los errores ocurridos al llamar a Start-CsWindowsService.
Al igual que sucede con otros servicios de Windows, algunos servicios de Lync Server dependen de otro servicio; por ejemplo, el servicio de operador de conferencia de Lync Server no se puede ejecutar si no se está ejecutando el servicio Servicio de aplicaciones. Si trata de iniciar un servicio que depende de otro, Start-CsWindowsService iniciará ambos servicios, lo cual significa que, si intenta iniciar el servicio de operador de conferencia, el cmdlet iniciará primero el Servicio de aplicaciones y, a continuación, el servicio de operador de conferencia. Sin embargo, Start-CsWindowsService no iniciará automáticamente ningún servicio dependiente de un servicio: si inicia el Servicio de aplicaciones, el comando no iniciará automáticamente el servicio de operador de conferencia.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Start-CsWindows 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 "Start-CsWindowsService"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Name |
Opcional |
Cadena de caracteres |
Nombre del servicio de Lync Server que desea iniciar. 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. Los nombres de servicio se pueden recuperar por medio del cmdlet Get-CsWindowsService. Recuerde que Start-CsWindowsService solo puede iniciar servicios de Lync Server. No puede usar este cmdlet para iniciar otros servicios de Windows. Para estos servicios, puede que sea posible usar el cmdlet Start-Service de Windows PowerShell. |
ComputerName |
Opcional |
Cadena de caracteres |
Nombre del equipo remoto que hospeda el servicio que se iniciará; si no se incluye este parámetro, Start-CsWindowsService iniciará el servicio (o servicios) especificado en el equipo local. Se debe hacer referencia al equipo remoto mediante su FQDN; por ejemplo, atl-cs-001.litwareinc.com. |
InputObject |
Opcional |
Objeto NTService |
Permite iniciar un servicio usando una referencia a un objeto, en lugar del nombre del 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 iniciar el servicio usando el siguiente comando: $x = Get-CsWindowsService -Name "RTCCPS" Start-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 de acceso a un archivo HTML donde se puede almacenar la información sobre errores. 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. Start-CsWindowsService acepta instancias transferidas del objeto de servicio de Windows.
Tipos de valores devueltos
Ninguno. En su lugar, Start-CsWindowsService inicia instancias del objeto Microsoft.Rtc.Management.Deployment.Core.NTService.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Start-CsWindowsService
El comando que se muestra en el ejemplo 1 inicia todos los servicios de Lync Server en el equipo local. Para hacerlo, llama a Start-CsWindowsService sin ningún parámetro. Tenga en cuenta que no recibirá ningún error si trata de iniciar un servicio ya iniciado.
-------------------------- Ejemplo 2 ------------------------
Start-CsWindowsService -Name "RTCRGS"
El comando anterior inicia el servicio de Aplicación de grupo de respuesta en el equipo local. Para ello, el comando usa el parámetro Name seguido del nombre de servicio: RTCRGS.
-------------------------- Ejemplo 3 ------------------------
Start-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com
El comando que se muestra en el ejemplo 3 inicia también el servicio de Aplicación de grupo de respuesta; sin embargo, en este caso, el servicio se inicia en el equipo remoto atl-cs-001.litwareinc.com. Para iniciar un servicio en un equipo remoto, incluya el parámetro ComputerName seguido del FQDN del equipo remoto.
-------------------------- Ejemplo 4 ------------------------
Get-CsWindowsService | Where-Object {$_.Status -ne "Running"} | Start-CsWindowsService
En el ejemplo 4, el comando busca en el equipo local todos los servicios de Lync Server que no se están ejecutando y, a continuación, inicia todos los servicios inactivos. Para hacerlo, el comando llama primero a Get-CsWindowsService para devolver una colección de todos los servicios de Lync Server. A continuación, la colección se transfiere al cmdlet Where-Object, que selecciona solo los servicios cuya propiedad Status no es igual a Running. Después, la colección filtrada se transfiere a Start-CsWindowsService, que inicia cada uno de los servicios de la colección.