Get-CsWindowsService
Última modificación del tema: 2012-03-23
Get-CsWindowsService devuelve información detallada sobre los componentes Microsoft Lync Server 2010 que se ejecutan como servicios de Windows.
Sintaxis
Get-CsWindowsService [-Name <String>] [-ComputerName <String>] [-ExcludeActivityLevel <SwitchParameter>] [-Report <String>]
Descripción detallada
Diversos componentes Lync Server 2010 se ejecutan como servicios estándar de Windows; por ejemplo, el Lync Server Aplicación de operador de conferencia es en realidad un servicio denominado RTCCAA. El cmdlet Get-CsWindowsService permite recuperar información detallada acerca de estos servicios de Lync Server exclusivamente. Eso se debe a que el cmdlet ha sido diseñado para ignorar cualquier tipo de servicio que no forme parte de Lync Server.
El hecho de que Get-CsWindowsService filtre automáticamente servicios no pertenecientes a Lync Server es una de las ventajas que ofrece el cmdlet sobre el cmdlet genérico Get-Service que se envía como parte de Windows PowerShell. Además, existe otra razón importante para usar Get-CsWindowsService si necesita recuperar información de un servicio de Lync Server: Get-CsWindowsService devuelve datos útiles que no devuelve Get-Service. Por ejemplo, cuando se recupera información sobre el servicio de Operador de conferencia de Lync Server, Get-CsWindowsService informa la cantidad de llamadas simultáneas que controla el servicio (nivel de actividad del servicio). Get-Service no lo hace.
De manera predeterminada, Get-CsWindowsService se ejecuta en el equipo local. Sin embargo, al incluir el parámetro -ComputerName podrá devolver información sobre los servicios de Lync Server que se ejecutan en un equipo remoto.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Get-CsWindowsService de forma local: RTCUniversalServerAdmins. Además, para ejecutar este cmdlet, también debe ser miembro del grupo Usuarios del monitor del sistema del equipo de destino. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsWindowsService"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Name |
Opcional |
Cadena de caracteres |
Nombre del servicio del que desea devolver la información. Tenga en cuenta que debe usar el nombre del servicio (por ejemplo, RTCCAA) y no el nombre para mostrar del servicio. Solo puede pasar un único nombre de servicio al parámetro Name; además, no puede usar comodines en el nombre de servicio. Además recuerde que Get-CsWindowsService solo devuelve información de servicios de Lync Server; no puede usar este cmdlet para devolver información de otros servicios de Windows. En esos servicios, podría usar el cmdlet Windows PowerShell Get-Service. Si no incluye este parámetro, Get-CsWindowsService devolverá información sobre todos sus servicios de Lync Server. |
ComputerName |
Opcional |
Cadena de caracteres |
Nombre del equipo remoto desde donde se recuperará la información de servicio; si este parámetro no está incluido, Get-CsWindowsService devolverá información sobre los servicios de Lync Server que se ejecutan en el equipo local. Se debe hacer referencia al equipo remoto mediante su nombre de dominio completo (FQDN); por ejemplo, atl-mcs-001.litwareinc.com. |
ExcludeActivityLevel |
Opcional |
Parámetro modificador |
Si está incluido, este parámetro hace que Get-CsWindowsService devuelva solo el estado de servicio y no el nivel de actividad de servicio. |
Report |
Opcional |
Cadena de caracteres |
Ruta hacia un archivo HTML donde se puede almacenar 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á en el archivo especificado (por ejemplo, C:\Logs\Service_report.html). |
Tipos de entrada
Ninguno. Get-CsWindowsService no acepta entradas canalizadas.
Tipos de valores devueltos
Get-CsWindowsService devuelve instancias del objeto Microsoft.Rtc.Management.Deployment.Core.NTService.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsWindowsService
El comando que se muestra en el Ejemplo 1 devuelve información sobre todos los servicios de Lync Server que se ejecutan en el equipo local. Para ello, se llama a Get-CsWindowsService sin parámetros.
-------------------------- Ejemplo 2 --------------------------
Get-CsWindowsService | Format-List
En el Ejemplo 2 además se devuelve información sobre los servicios de Lync Server en el equipo local; sin embargo, en este caso, los datos se muestran en formato de lista. (Entre otras cosas, permite ver todos los valores de propiedades para cada servicio. En la vista predeterminada tabular, solo se muestra un subconjunto de valores de propiedades). Para realizar esta tarea, primero se llama a Get-CsWindowsService y, a continuación, la información resultante se canaliza al cmdlet Format-List.
-------------------------- Ejemplo 3 --------------------------
Get-CsWindowsService -Name "RTCSrv"
En el Ejemplo 3, se devuelve información de un único servicio de Lync Server: el servicio con el nombre RTCSrv.
-------------------------- Ejemplo 4 --------------------------
Get-CsWindowsService -Name "RTCSrv" | Select-Object -ExpandProperty RoleName
En el Ejemplo 4 se visualiza la información detallada para todos los roles de servicio controlados por el servicio RTCSrv. Para realizar esta tarea, primero se usa Get-CsWindowsService para devolver información sobre el servicio RTCSrv. A continuación, esta información se transfiere al cmdlet Select-Object, que usa el parámetro ExpandProperty para mostrar todos los roles que administra el servicio RTCSrv. Recuerde que este comando devolverá un mensaje de error si el servicio no tiene nombre de rol.
-------------------------- Ejemplo 5 --------------------------
Get-CsWindowsService -Computer atl-cs-001.litwareinc.com
El comando que se muestra en el Ejemplo 5 devuelve información sobre los servicios de Lync Server instalados en el equipo remoto atl-cs-001.litwareinc.com. Para ello, se incluye el parámetro ComputerName seguido por el FQDN del equipo remoto.
-------------------------- Ejemplo 6 --------------------------
Get-CsWindowsService -Report C:\Logs\Services.html
El comando anterior devuelve información sobre todos los servicios de Lync Server instalados en el equipo local. También se incluye el parámetro Report para guardar información de error en un archivo denominado C:\Logs\Services.html. Si Get-CsWindowsService detecta problemas al recuperar datos de servicio, la información acerca de ese problema se registrará en Services.html.
-------------------------- Ejemplo 7 --------------------------
Get-CsWindowsService | Where-Object {$_.Status -eq "Running"}
En el Ejemplo 7, la información se devolverá solo para los servicios de Lync Server del equipo local que se está ejecutando actualmente. Para realizar esta tarea, el comando primero llama a Get-CsWindowsService para devolver una recopilación de servicios de Lync Server con o sin ejecución. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que elige solo aquellos servicios donde la propiedad Status es igual a Running.
-------------------------- Ejemplo 8 --------------------------
Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Application Sharing*"}
En el ejemplo 8 se muestra cómo se puede recuperar información para un servicio en particular aún si no se conoce el nombre real de ese servicio (en este caso, RTCASMCU). Para realizar esta tarea, primero se llama a Get-CsWindowsService sin ningún parámetro, que devolverá una recopilación de servicios de Lync Server en el equipo local. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que solo selecciona el único servicio donde la propiedad DisplayName incluye (-como) el valor de cadena "Aplicación compartida". Resultado final: se muestra información de Lync Server Servicio de conferencia de uso compartido de aplicaciones.
-------------------------- Ejemplo 9 --------------------------
Get-CsWindowsService | Where-Object {$_.RoleName -contains "ApplicationServer"}
En el Ejemplo 9 se devuelve información sobre cualquier servicio que hospede el rol de Application Server. Para ello, el comando primero llama a Get-CsWindowsService para devolver una recopilación de todos los servicios de Lync Server en el equipo local. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona los servicios cuya propiedad RoleName incluye (-contiene) ApplicationServer.