Administrar las opciones de configuración del servicio de registro centralizado en Skype Empresarial Server 2015
Resumen: Obtenga información sobre cómo recuperar, actualizar y crear opciones de configuración para el servicio de registro centralizado en Skype Empresarial Server 2015.
El servicio de registro centralizado se controla y configura mediante configuraciones y parámetros creados y usados por el controlador de servicio de registro centralizado (CLSController) para enviar comandos al agente de servicio de registro centralizado (CLSAgent) de equipos individuales. El agente procesa los comandos que le envían y (en el caso del comando Start) usa la configuración de los escenarios, los proveedores, la duración del seguimiento y las marcas para empezar a recopilar registros de seguimiento de acuerdo con la información de configuración facilitada.
Importante
No todos los cmdlets de Windows PowerShell enumerados para el servicio de registro centralizado están pensados para usarse con implementaciones locales de Skype Empresarial Server 2015. Aunque parezcan funcionar, los cmdlets siguientes no están diseñados para funcionar con implementaciones locales de Skype Empresarial Server 2015:
- Cmdlets de CsClsRegion:Get-CsClsRegion , Set-CsClsRegion, New-CsClsRegion y Remove-CsClsRegion.
- Cmdlets de CsClsSearchTerm:Get-CsClsSearchTerm y Set-CsClsSearchTerm.
- Cmdlets de CsClsSecurityGroup:Get-CsClsSecurityGroup, Set-CsClsSecurityGroup, New-CsClsSecurityGroup y Remove-CsClsSecurityGroup.
La configuración definida en estos cmdlets no obstaculiza ni produce ningún comportamiento negativo, pero está diseñada para su uso con Microsoft 365 o Office 365 y no produce los resultados esperados en las implementaciones locales. Esto no quiere decir que no se usen estos cmdlets en las implementaciones locales, pero su uso es un artículo más avanzado que no se trata en esta documentación.
El servicio de registro centralizado se puede ejecutar en un ámbito que incluya un único equipo o un grupo de equipos, en un ámbito de sitio (es decir, un sitio definido como el sitio Redmond que contiene una colección de equipos y grupos en la implementación) o en un ámbito global (es decir, todos los equipos y grupos de la implementación).
Para configurar el ámbito del servicio de registro centralizado mediante el Shell de administración de Skype Empresarial Server, debe ser miembro de los grupos de seguridad de control de acceso basado en roles (RBAC) CsAdministrator o CsServerAdministrator, o bien un rol RBAC personalizado que contenga cualquiera de estos dos grupos. Para devolver una lista de todos los roles RBAC a los que está asignado este cmdlet (incluidos los roles RBAC personalizados que esté creando usted mismo), ejecute el siguiente comando desde el Shell de administración de Skype Empresarial Server o el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "<Skype for Business cmdlet>"}
Por ejemplo:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}
Nota
Existen diferencias fundamentales entre los comandos de la línea de comandos que puede ejecutar en Windows PowerShell o CLSController. Windows PowerShell proporciona un método enriquecido para configurar y definir escenarios, y para volver a usar esos escenarios de forma significativa para los escenarios de solución de problemas. Aunque CLSController ofrece una manera rápida y eficaz de emitir comandos y obtener resultados, el conjunto de comandos de CLSController se limita al número finito de comandos que hay disponibles en la línea de comandos. A diferencia de los cmdlets de Windows PowerShell, CLSController no puede definir nuevos escenarios, administrar el ámbito a nivel global o de sitio y muchas otras limitaciones de un conjunto de comandos finitos que no se puede configurar dinámicamente. Aunque CLSController proporciona un medio para una ejecución rápida, Windows PowerShell proporciona un medio para ampliar la funcionalidad del servicio de registro centralizado más allá de lo que es posible con CLSController.
Se puede definir un ámbito de equipo único durante la ejecución de un comando Search-CsClsLogging, Show-CsClsLogging, Start-CsClsLogging, Stop-CsClsLogging, Sync-CsClsLogging y Update-CsClsLogging mediante el parámetro -Computers. El parámetro -Computers acepta una lista de nombres de dominio completos (FQDN) separados por comas para el equipo de destino.
Propina
También puede definir -Pools y una lista de grupos separados por comas en la que desee ejecutar los comandos de registro.
Los ámbitos Sitio y Global se definen en los cmdlets del servicio de registro centralizado Nuevo, Conjunto y Quitar . En los siguientes ejemplos se muestra cómo establecer un ámbito de sitio y un ámbito global.
Importante
Los comandos que se muestran pueden contener parámetros y conceptos tratados en otras secciones. Los comandos de ejemplo están destinados a demostrar el uso del parámetro -Identity para definir el ámbito, y los otros parámetros se incluyen para completar y especificar el ámbito. Para más información sobre los cmdlets de Set-CsClsConfiguration, consulte Set-CsClsConfiguration en la documentación sobre operaciones.
Para recuperar la configuración actual del servicio de registro centralizado
Inicia el Shell de administración de Skype Empresarial Server: selecciona Inicio, todos los programas, Skype Empresarial 2015 y, a continuación, haz clic en Skype Empresarial Server Shell de administración.
Escriba lo siguiente en el símbolo de la línea de comandos:
Get-CsClsConfiguration
Use los cmdlets New-CsClsConfiguration y Set-CsClsConfiguration para crear una nueva configuración o actualizar una configuración existente. Cuando ejecuta Get-CsClsConfiguration, muestra información similar a la siguiente captura de pantalla, donde la implementación tiene actualmente la configuración global predeterminada, pero no se ha definido ninguna configuración de sitio:
Para recuperar la configuración actual del servicio de registro centralizado desde el almacén local del equipo
Inicie el Shell de administración de Skype Empresarial Server: seleccione Inicio, haga clic en Todos los programas, haga clic en Skype Empresarial 2015 y, a continuación, haga clic en Skype Empresarial Server Shell de administración.
Escriba lo siguiente en el símbolo de la línea de comandos:
Get-CsClsConfiguration -LocalStore
Si utiliza el primer ejemplo en el que Get-CsClsConfiguration no especifica ningún parámetro, el comando hace referencia al almacén de Administración central para los datos. Si especifica el parámetro -LocalStore, el comando hace referencia al equipo LocalStore en lugar del almacén de administración central.
Para recuperar la lista de los escenarios actualmente definidos
Inicie el Shell de administración de Skype Empresarial Server: seleccione Inicio, haga clic en Todos los programas, haga clic en Skype Empresarial 2015 y, a continuación, haga clic en Skype Empresarial Server Shell de administración.
Escriba lo siguiente en el símbolo de la línea de comandos:
Get-CsClsConfiguration -Identity <scope and name> | Select-Object -ExpandProperty ScenariosPor ejemplo, para recuperar los escenarios definidos en el ámbito global:
Get-CsClsConfiguration -Identity "global" | Select-Object -ExpandProperty Scenarios
El cmdlet Get-CsClsConfiguration siempre muestra los escenarios que forman parte de la configuración de un ámbito determinado. En la mayoría de los casos, no se muestran todos los escenarios y se truncan. El comando usado aquí enumera todos los escenarios e información parcial sobre los proveedores, la configuración y las marcas que se utilizan.
Para actualizar un ámbito global del servicio de registro centralizado con Windows PowerShell
Inicie el Shell de administración de Skype Empresarial Server: seleccione Inicio, haga clic en Todos los programas, haga clic en Skype Empresarial 2015 y, a continuación, haga clic en Skype Empresarial Server Shell de administración.
Escriba lo siguiente en el símbolo de la línea de comandos:
Set-CsClsConfiguration -Identity <scope> -EtlFileRolloverSizeMB <size for logging file in megabytes>Por ejemplo:
Set-CsClsConfiguration -Identity "global" -EtlFileRolloverSizeMB 40
El comando indica a CLSAgent en cada equipo y grupo de la implementación que establezca el tamaño del valor de sustitución en el archivo de seguimiento en 40 megabytes. El comando afectará a los equipos y grupos de todos los sitios, y establecerá el valor de sustitución del registro de seguimiento configurado en 40 megabytes.
Para actualizar el ámbito de un sitio para el servicio de registro centralizado mediante Windows PowerShell
Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server.
Escriba lo siguiente en el símbolo de la línea de comandos:
Set-CsClsConfiguration -Identity <scope/site name> -EtlFileRolloverSizeMB <size for logging file in megabytes>Por ejemplo:
Set-CsClsConfiguration -Identity "site/Redmond" -EtlFileRolloverSizeMB 40
Nota
Como se indica en el ejemplo, la ubicación predeterminada de los archivos de registro es %TEMP%\Tracing. Pero, como es CLSAgent quien realmente escribe en el archivo y CLSAgent se ejecuta como un servicio de red, la variable %TEMP% se expande a %WINDIR%\ServiceProfiles\NetworkService\AppData\Local.
El comando indica a CLSAgent en cada equipo y grupo del sitio Redmond que establezca el tamaño del valor de sustitución en el archivo de seguimiento en 40 megabytes. El comando no afectará a los equipos y grupos de los demás sitios, y continuarán usando el valor de sustitución del registro de seguimiento configurado definido de forma predeterminada (20 megabytes) o al inicio de la sesión de registro.
Para crear una nueva configuración del servicio de registro centralizado
Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server.
Escriba lo siguiente en el símbolo de la línea de comandos:
New-CsClsConfiguration -Identity <scope and name> [CsClsConfiguration options for this site]Nota
New-CsClsConfiguration proporciona acceso a una gran cantidad de opciones de configuración opcionales. Para obtener más información sobre las opciones de configuración, consulte Get-CsClsConfiguration y Descripción de la configuración del servicio de registro centralizado.
Por ejemplo, para crear una configuración que define una carpeta de red para archivos caché, el período de tiempo de sustitución para los archivos de registro y el tamaño de sustitución para los archivos de registro, escribiría:
New-CsClsConfiguration -Identity "site:Redmond" -CacheFileNetworkFolder "\\fs01.contoso.net\filestore\logfiles" -EtlFileRolloverMinutes 120 -EtlFileRolloverSizeMB 40
Debe planear cuidadosamente la creación de nuevas configuraciones y cómo definir nuevas propiedades para el servicio de registro centralizado. Hay que tener precaución a la hora de realizar cambios y asegurarse de que comprende cómo afectan a su capacidad para registrar correctamente escenarios de problemas. Es necesario realizar cambios en la configuración que mejoren su capacidad para administrar los registros y establecer un tamaño y un período de sustitución que permitan resolver el problema cuando se produzca.
Para quitar una configuración existente del servicio de registro centralizado
Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server.
Escriba lo siguiente en el símbolo de la línea de comandos:
Remove-CsClsConfiguration -Identity <scope and name>
Por ejemplo, para quitar una configuración del servicio de registro centralizado que ha creado para aumentar el tiempo de sustitución del archivo de registro, aumentar el tamaño del archivo de registro de reversión y establecer la ubicación de la caché de archivos de registro en un recurso compartido de red como se indica a continuación:
Remove-CsClsConfiguration -Identity "site:Redmond"
Nota
Esta es la nueva configuración que se creó en el procedimiento "Para crear una nueva configuración del servicio de registro centralizado".
Si decide quitar una configuración de sitio, el sitio usará la configuración global.
Vea también
Configurar proveedores para el servicio de registro centralizado en Skype Empresarial Server 2015
Configurar escenarios para el servicio de registro centralizado en Skype Empresarial Server 2015