Get-CsService
Última modificación del tema: 2012-03-23
Devuelve información sobre los servicios y los roles de servidor que se estén usando en su infraestructura de Microsoft Lync Server 2010. Un servicio es una instancia de un rol que se ha implementado en un grupo de servidores de Lync Server 2010. Por ejemplo, puede tener un grupo de servidores de equipos que ejecuten todos el servicio Monitoring Server.
Sintaxis
Get-CsService [-Identity <XdsGlobalRelativeIdentity>] [-PoolFqdn <String>]
Get-CsService [-ApplicationServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ApplicationDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ArchivingServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ArchivingDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-CentralManagement <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-CentralManagementDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ConferencingServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-Director <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-EdgeServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-PoolFqdn <String>] [-TrustedApplicationPool <SwitchParameter>]
Get-CsService [-FileStore <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ManagementServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MediationServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MonitoringServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MonitoringDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-PoolFqdn <String>] [-PstnGateway <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-ProvisionServer <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-ProvisionDatabase <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-Registrar <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-UserServer <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-UserDatabase <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-WebServer <SwitchParameter>]
Get-CsService [-Filter <String>] [-PoolFqdn <String>]
Descripción detallada
Las prestaciones de Lync Server 2010 suelen expresarse en forma de servicios o roles de servidor. Por ejemplo, puede configurar Lync Server para guardar automáticamente una transcripción de cada sesión de mensajería instantánea que tenga lugar en la organización. Para ello, debe instalar el rol del servidor Servidor de archivado. Los servicios y roles de servidor pueden configurarse al instalar Lync Server, o bien una vez que el software esté en funcionamiento.
El cmdlet Get-CsService permite devolver información sobre los roles y servicios de servidor que se están ejecutando en la organización. Si se llama a Get-CsService sin parámetros adicionales, devolverá información detallada sobre todos sus servicios y roles de servidor. También puede restringir los datos devueltos a un grupo de servidores especificado mediante el parámetro PoolFqdn. Asimismo, puede usar un número cualquiera de parámetros modificadores para restringir los datos devueltos a un tipo de servicio específico. Un parámetro modificador es un parámetro que no requiere ningún valor de parámetro. Por ejemplo, este comando devuelve información sobre todos sus servidores de archivado:
Get-CsService –ArchivingServer
Tenga en cuenta que solo puede usar un parámetro modificador por comando. El siguiente comando, que intenta devolver información sobre los servidores de archivado y los servidores de supervisión, no se completará correctamente:
Get-CsService –ArchivingServer –MonitoringServer
Si necesita devolver información de varios roles de servidor, use Get-CsService para devolver una recopilación completa de los datos de servicio y, a continuación, transfiera los datos al cmdlet Where-Object:
Get-CsService | Where-Object {$_.Role –eq "ArchivingServer" –or $_.Role –eq "MonitoringServer"}
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsService de manera local: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsService"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Identificador único del servicio o rol de servidor específico que se va a devolver. Por ejemplo: -Identity "Registrar:atl-cs-001.litwareinc.com". |
Filter |
Opcional |
Cadena de caracteres |
Permite usar caracteres comodín para especificar el servicio (o servicios) que se va a devolver. No se pueden usar los parámetros Identity y Filter en el mismo comando. |
ApplicationDatabase |
Opcional |
Parámetro modificador |
Devuelve información sobre las bases de datos de aplicaciones usadas en la organización. Las bases de datos de aplicaciones se usan en el Servicio de aplicaciones. |
ApplicationServer |
Opcional |
Parámetro modificador |
Devuelve información sobre Servicio de aplicaciones. El Servicio de aplicaciones permite ejecutar aplicaciones creadas mediante Microsoft Unified Communications Managed API (UCMA). |
ArchivingDatabase |
Opcional |
Parámetro modificador |
Devuelve información sobre las bases de datos de archivado usadas en la organización. Las bases de datos de archivado almacenan las transcripciones de las sesiones de mensajería instantánea. |
ArchivingServer |
Opcional |
Parámetro modificador |
Devuelve información sobre los servidores de archivado usados en la organización. Los servidores de archivado permiten guardar las transcripciones de las sesiones de mensajería instantánea. |
CentralManagement |
Opcional |
Parámetro modificador |
Devuelve información sobre el Servicio de administración central usado en la organización. El Servicio de administración central se usa para enviar datos de configuración a los equipos que ejecutan servicios Lync Server 2010. |
CentralManagementDatabase |
Opcional |
Parámetro modificador |
Devuelve información sobre el Almacén de administración central usado en la organización. La Almacén de administración central mantiene la información de configuración para Lync Server. |
ConferencingServer |
Opcional |
Parámetro modificador |
Devuelve información sobre el Servicio de conferencia A/V usado en la organización. El Servicio de conferencia A/V se usa para realizar reuniones y conferencias. |
Director |
Opcional |
Parámetro modificador |
Devuelve información sobre los directores usados en la organización. Los directores están autorizados para administrar las solicitudes y la autenticación de usuarios, pero no hospedan cuentas de usuario. Los directores suelen usarse para administrar las solicitudes de usuarios externos. |
EdgeServer |
Opcional |
Parámetro modificador |
Devuelve información sobre los servidores perimetrales usados en la organización. Los servidores perimetrales proporcionan conectividad entre la red interna e Internet. |
FileStore |
Opcional |
Parámetro modificador |
Devuelve información sobre los almacenes de archivos usados en la organización. El almacén de archivos se usa para conservar los archivos de Lync Server, tales como los archivos de audio usados por el servicio de anuncio. |
ManagementServer |
Opcional |
Parámetro modificador |
Devuelve información sobre el Servidor de administración central usado en la organización. Servidor de administración central suele instalarse con los servidores front-ent y es responsable del acceso a la información de la Almacén de administración central. |
MediationServer |
Opcional |
Parámetro modificador |
Devuelve información sobre los servidores de mediación usados en la organización. Los servidores de mediación permiten proporcionar un puente entre la red de Enterprise Voice y la red telefónica conmutada (RTC). |
MonitoringServer |
Opcional |
Parámetro modificador |
Devuelve información sobre los servidores de supervisión usados en la organización. Los servidores de supervisión se usan para realizar un seguimiento del uso de teléfono y la calidad de las llamadas de Enterprise Voice. |
MonitoringDatabase |
Opcional |
Parámetro modificador |
Devuelve información sobre las bases de datos de supervisión usadas en la organización. Las bases de datos de supervisión almacenan información sobre el uso de teléfono y la calidad de las llamadas de Enterprise Voice. |
PoolFqdn |
Opcional |
Cadena de caracteres |
Nombre de dominio completo (FQDN) del grupo de servidores que hospeda el servicio o el rol de servidor. Si usa el parámetro PoolFqdn sin especificar ningún parámetro específico del servicio, se devolverán todos los servicios y roles de servidor que se encuentren en el grupo de servidores. |
ProvisionServer |
Opcional |
Parámetro modificador |
Devuelve información sobre el servicio de servidores de aprovisionamiento usado en la organización. El servicio de servidor de aprovisionamiento se usa para administrar certificados de Lync Server. |
ProvisionDatabase |
Opcional |
Parámetro modificador |
Devuelve información sobre las bases de datos de aprovisionamiento usadas en la organización. Las bases de datos de aprovisionamiento conservan información sobre los certificados de Lync Server. |
PstnGateway |
Opcional |
Parámetro modificador |
Devuelve información sobre las puertas de enlace RTC (red telefónica conmutada) usadas en la organización. Las puertas de enlace RTC convierten las señales de dispositivos de Enterprise Voice a señales que puedan comprender los dispositivos RTC, y viceversa. |
Registrar |
Opcional |
Parámetro modificador |
Devuelve información sobre los registradores usados en la organización. Los registradores se usan para autenticar a los usuarios y realizar un seguimiento del estado actual del usuario. |
TrustedApplicationPool |
Opcional |
Parámetro modificador |
Devuelve información sobre los grupos de servidores de aplicación de confianza usados en la organización. Los grupos de servidores de aplicación de confianza hospedan equipos que ejecutan aplicaciones de confianza. |
UserDatabase |
Opcional |
Parámetro modificador |
Devuelve información sobre el Base de datos de usuarios usado en la organización. Las bases de datos de usuario almacenan datos que son necesarios para el servicio de servidor de usuario. |
UserServer |
Opcional |
Parámetro modificador |
Devuelve información sobre el servicio Servicios de usuarios usado en la organización. El servicio Servicios de usuarios proporciona funciones como la replicación de usuarios, el aprovisionamiento en banda, la publicación y notificación de información de presencia y el intercambio de tarjetas de contacto. |
WebServer |
Opcional |
Parámetro modificador |
Devuelve información sobre el servicio Servicios web usado en la organización. El servicio Servicios web hospeda aplicaciones web, tales como el servicio de libreta de direcciones. |
Tipos de entrada
Ninguno. Get-CsService no acepta entradas transferidas.
Tipos de valores devueltos
Get-CsService devuelve diferentes objetos en función de los parámetros usados para llamar al cmdlet. Por ejemplo, si incluye el parámetro -MonitoringDatabase, Get-CsService devolverá instancias del objeto Microsoft.Rtc.Management.Xds.DisplayMonitoringDatabase. Para determinar los objetos devueltos usando otros parámetros, llame a Get-CsService usando uno de los parámetros y, a continuación, transfiera el objeto devuelto al cmdlet Get-Member. Por ejemplo: Get-CsService -Registrar | Get-Member.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsService
El comando que se muestra en el Ejemplo 1 devuelve información sobre todos los servicios y roles de servidor de Lync Server 2010 que se están ejecutando en la organización.
-------------------------- Ejemplo 2 ------------------------
Get-CsService -ApplicationServer
El ejemplo 2 solo devuelve información sobre el Servicio de aplicaciones. Puede devolver información de otros servicios o roles de servidor mediante el parámetro pertinente. Por ejemplo, este comando devuelve información sobre el almacén de archivos:
Get-CsService -FileStore
-------------------------- Ejemplo 3 ------------------------
Get-CsService -PoolFqdn "atl-cs-001.litwareinc.com" | Select-Object Identity
El comando anterior devuelve el valor de Identity para cada uno de los servicios ubicados en el grupo de servidores atl-cs-001.litwareinc.com. Para ello, el comando primero llama a Get-CsService y al parámetro PoolFqdn para devolver únicamente aquellos servicios y roles de servidor que se encuentren en el grupo de servidores atl-cs-001.litwareinc.com. A continuación, la recopilación se transfiere al cmdlet Select-Object, que devuelve el valor de Identity de todos los elementos de la recopilación.
-------------------------- Ejemplo 4 ------------------------
Get-CsService | Where-Object {$_.SiteID -eq "site:Redmond"}
En el Ejemplo 4, se devuelve información para todos los servicios y roles de servidor que se encuentren en el sitio de Redmond. Para ello, primero se llama a Get-CsService sin ningún parámetro para devolver una recopilación de todos los servicios y roles de servidor que están en uso en la organización. Estos datos se transfieren al cmdlet Where-Object, que selecciona solo los elementos cuya propiedad SiteID sea igual a site:Redmond.
-------------------------- Ejemplo 5 ------------------------
Get-CsService | Where-Object {$_.DependentServiceList -like "*Registrar*"}
El comando mostrado en el Ejemplo 5 devuelve información sobre todos los servicios que incluyen el registrador como servicio dependiente. Para ello, se llama a Get-CsService para devolver una recopilación de todos los servicios y roles de servidor que están actualmente en uso. A continuación, esta recopilación se transfiere a Where-Object, que selecciona todos los elementos cuya propiedad DependentServiceList contenga el valor de cadena de caracteres "Registrar". Los criterios de Where-Object se especifican mediante el operador -like y el valor de comodín "*Registrar*".