Administrar las opciones de configuración del servicio de registro centralizado en Skype Empresarial Server 2015Manage Centralized Logging Service configuration settings in Skype for Business 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 para Business Server 2015.Summary: Learn how to retrieve, update, and create configuration settings for the Centralized Logging Service in Skype for Business Server 2015.

El servicio de registro centralizado se controla y configurado por la configuración y los parámetros que se crean y utilizan el centralizado registro de controlador del servicio (CLSController) para enviar comandos a (agente de servicio de registro centralizado) del equipo individuales Con CLSAgent).The Centralized Logging Service is controlled and configured by settings and parameters that are created and used by the Centralized Logging Service Controller (CLSController) to send commands to the individual computer's Centralized Logging Service Agent (CLSAgent). 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.The agent processes the commands that are sent to it and (in the case of a Start command) uses the configuration of the scenarios, providers, trace duration, and flags to begin collecting trace logs according to the configuration information provided.

Importante

No todos los cmdlets de Windows PowerShell enumerados para el servicio de registro centralizado están diseñados para su uso con Skype para las implementaciones locales de Business Server 2015.Not all Windows PowerShell cmdlets listed for the Centralized Logging Service are intended for use with Skype for Business Server 2015 on-premises deployments. Aunque es posible que aparecen para que funcione, los cmdlets siguientes no están diseñados para funcionar con Skype para las implementaciones locales de 2015 de servidor empresarial:Although they may appear to work, the following cmdlets are not designed to function with Skype for Business Server 2015 on-premises deployments:

La configuración definida en estos cmdlets no obstaculizar ni causar ningún comportamiento adversa, pero están diseñados para su uso con Microsoft Office 365 y no se producirán los resultados esperados en las implementaciones locales.The settings defined in these cmdlets will not hinder or cause any adverse behavior, but they are designed for use with Microsoft Office 365 and will not yield the expected results in on-premises deployments. Esto no significa que estos cmdlets no sirvan para las implementaciones locales, sino que lo cierto es que tienen un uso más avanzado que no se aborda en esta documentación.This is not to say that there is no use for these cmdlets in on-premises deployments, but their use is a more advanced topic that is not covered in this documentation.

El servicio de registro centralizado se puede ejecutar en un ámbito que incluye un único equipo o un grupo de equipos, en un ámbito de sitio (es decir, un sitio definido como el sitio de Redmond que contiene una colección de equipo y grupos de servidores en la implementación) o en un ámbito global (es decir todos los equipos y grupos de servidores en la implementación).The Centralized Logging Service can be run at a scope that includes a single computer or a pool of computers, at a site scope (that is, a defined site such as the site Redmond that contains a collection of computer and pools in your deployment), or at a global scope (that is, all computers and pools in your deployment).

Para configurar el ámbito de servicio de registro centralizado mediante el uso de la Skype para Shell de administración de servidor empresarial, debe ser un miembro de la CsAdministrator o los grupos de seguridad de CsServerAdministrator acceso basado en roles (RBAC) del control o un rol RBAC personalizado que contiene cualquiera de estos dos grupos.To configure the Centralized Logging Service scope by using the Skype for Business Server Management Shell, you must be a member of either the CsAdministrator or the CsServerAdministrator role-based access control (RBAC) security groups, or a custom RBAC role that contains either of these two groups. Para devolver una lista de todas las funciones RBAC que se ha asignado este cmdlet para (incluidos los roles RBAC personalizados que haya creado), ejecute el siguiente comando desde el Skype para Business Server Management Shell o el símbolo del sistema de Windows PowerShell:To return a list of all the RBAC roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Skype for Business Server Management Shell or the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "<Skype for Business cmdlet>"}

Por ejemplo:For example:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}

Nota

Hay diferencias fundamentales entre los comandos de línea de comandos que se pueden ejecutar en Windows PowerShell o CLSController.There are fundamental differences between the command-line commands that you can run in Windows PowerShell or CLSController. Windows PowerShell proporciona un método enriquecido para configurar y definir escenarios y para volver a usar dichos escenarios de forma significativa para los escenarios de solución de problemas.Windows PowerShell provides a rich method to configure and define scenarios, and to reuse those scenarios in a meaningful way for your troubleshooting scenarios. 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.While CLSController does provide a fast and efficient way to issue commands and get results, the command set for CLSController is limited by the finite commands that you have available from the command line. A diferencia de los cmdlets de Windows PowerShell, CLSController no se puede definir nuevos escenarios, administrar ámbito en un sitio o nivel global y muchas otras limitaciones de un conjunto de comandos limitado que no se puede configurar de forma dinámica.Unlike the Windows PowerShell cmdlets, CLSController cannot define new scenarios, manage scope at a site or global level, and many other limitations of a finite command set that cannot be dynamically configured. Mientras CLSController proporciona un medio para ejecución rápida, Windows PowerShell proporciona un medio para extender la funcionalidad del servicio de registro centralizado más allá de lo que es posible con CLSController.While CLSController provides a means for fast execution, Windows PowerShell provides a means to extend the Centralized Logging Service functionality beyond what is possible with CLSController.

Ámbito de un único equipo puede definirse durante la ejecución de una Búsqueda-CsClsLogging, Show-CsClsLogging, Start-CsClsLogging, Stop-CsClsLogging, Sync-CsClsLogging y Update-CsClsLogging comando con el - parámetro Computers.A single computer scope can be defined during the execution of a Search-CsClsLogging, Show-CsClsLogging, Start-CsClsLogging, Stop-CsClsLogging, Sync-CsClsLogging and Update-CsClsLogging command using the -Computers parameter. -Equipos parámetro acepta una lista separada por comas de nombres de dominio completo (FQDN) para el equipo de destino.The -Computers parameter accepts a comma separated list of fully qualified domain names (FQDNs) for the target computer.

Sugerencia

También puede definir - grupos de servidores y una lista separada por comas de los grupos de servidores que se desean ejecutar los comandos de registro en.You can also define -Pools and a comma separated list of pools that you want to run the logging commands on.

Los ámbitos de sitio y Global se definen en los cmdlets New -, Set - y Remove - servicio de registro centralizado.Site and Global scopes are defined in the New-, Set-, and Remove- Centralized Logging Service cmdlets. En los siguientes ejemplos se muestra cómo establecer un ámbito de sitio y un ámbito global.The following examples demonstrate how to set a site and a global scope.

Importante

Los comandos que se muestran pueden contener parámetros y conceptos tratados en otras secciones.The commands shown may contain parameters and concepts that are covered in other sections. Los comandos de ejemplo están diseñados para demostrar el uso de la -Identity parámetro para definir el ámbito y los demás parámetros se incluyen para más precisión y para especificar el ámbito.The example commands are intended to demonstrate the use of the -Identity parameter to define scope, and the other parameters are included for completeness and to specify the scope. Para obtener información detallada acerca de los cmdlets Set-CsClsConfiguration , consulte Set-CsClsConfiguration en la documentación sobre operaciones.For details about the Set-CsClsConfiguration cmdlets, see Set-CsClsConfiguration in the Operations documentation.

Para recuperar la configuración actual del servicio de registro centralizadoTo retrieve the current Centralized Logging Service configuration

  1. 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.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Escriba lo siguiente en el símbolo de la línea de comandos:Type the following at the command-line prompt:

    Get-CsClsConfiguration
    

Use los cmdlets New-CsClsConfiguration y Set-CsClsConfiguration para crear una nueva configuración o para actualizar una configuración existente. Cuando se ejecuta Get-CsClsConfiguration, muestra información similar a la siguiente pantalla, donde la implementación tiene actualmente la configuración Global de forma predeterminada, pero no las configuraciones de sitios definidas:Use the New-CsClsConfiguration and Set-CsClsConfiguration cmdlets to create a new configuration or to update an existing configuration.When you run Get-CsClsConfiguration, it displays information similar to the following screen shot, where the deployment currently has the default Global configuration, but no site configurations defined:

Salida de ejemplo de Get-CsClsConfiguration.

Para recuperar la configuración actual del servicio de registro centralizado desde el almacén del equipo localTo retrieve the current Centralized Logging Service configuration from the computer local store

  1. 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.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Escriba lo siguiente en el símbolo de la línea de comandos:Type the following at the command-line prompt:

    Get-CsClsConfiguration -LocalStore
    

Cuando se use en el primer ejemplo donde Get-CsClsConfiguration no se especifica ningún parámetro, las referencias de comando el almacén de Administración Central para los datos.When you use the first example where Get-CsClsConfiguration does not specify any parameters, the command references the Central Management store for the data. Si se especifica el parámetro - LocalStore, el comando hace referencia a la LocalStore de equipo en lugar del almacén de Administración Central.If you specify the parameter -LocalStore, the command references the computer LocalStore instead of the Central Management store.

Para recuperar la lista de los escenarios actualmente definidosTo retrieve a listing of scenarios currently defined

  1. 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.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Escriba lo siguiente en el símbolo de la línea de comandos:Type the following at the command-line prompt:

    Get-CsClsConfiguration -Identity <scope and name> | Select-Object -ExpandProperty Scenarios
    

    Por ejemplo, para recuperar los escenarios definidos en el ámbito global:For example, to retrieve the scenarios that is defined at the global scope:

    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.The cmdlet Get-CsClsConfiguration always displays the scenarios that are a part of a given scope's configuration. En la mayoría de los casos, no se muestran todos los escenarios y están truncados.In most cases, all scenarios are not displayed, and are truncated. El comando usado aquí enumera todos los escenarios e información parcial sobre los proveedores, la configuración y las marcas que se utilizan.The command used here lists all of the scenarios and partial information about what providers, settings, and flags are used.

Para actualizar un ámbito global para el servicio de registro centralizado mediante el uso de Windows PowerShellTo update a global scope for the Centralized Logging Service by using Windows PowerShell

  1. 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.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Escriba lo siguiente en el símbolo de la línea de comandos:Type the following at the command-line prompt:

    Set-CsClsConfiguration -Identity <scope> -EtlFileRolloverSizeMB <size for logging file in megabytes>
    

    Por ejemplo:For example:

    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.The command tells the CLSAgent on each computer and pool in the deployment to set the size of the rollover value on the tracing file to 40 megabytes. Computers and pools in all sites are affected by the command, and will set their configured trace log rollover value to 40 megabytes.

Para actualizar un ámbito de sitio para el servicio de registro centralizado mediante Windows PowerShellTo update a site scope for the Centralized Logging Service by using Windows PowerShell

  1. 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.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Escriba lo siguiente en el símbolo de la línea de comandos:Type the following at the command-line prompt:

    Set-CsClsConfiguration -Identity <scope/site name> -EtlFileRolloverSizeMB <size for logging file in megabytes>
    

    Por ejemplo:For example:

    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.As noted in the example, the default location of the log files is %TEMP%\Tracing. However, because it is actually CLSAgent that is writing the file and CSLAgent runs as Network Service, the %TEMP% variable expands to %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.The command tells the CLSAgent on each computer and pool in the site Redmond to set the size of the rollover value on the tracing file to 40 megabytes. Computers and pools in other sites will not be affected by the command, and will continue to use the currently configured trace log rollover value defined either by default (20 megabytes) or during the start of the logging session.

Para crear una nueva configuración de servicio de registro centralizadoTo create a new Centralized Logging Service configuration

  1. 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.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Escriba lo siguiente en el símbolo de la línea de comandos:Type the following at the command-line prompt:

    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.New-CsClsConfiguration provides access to a large number of optional configuration settings. Para obtener información detallada acerca de las opciones de configuración, vea Get-CsClsConfiguration y Descripción centralizada de registro de la configuración del servicio.For details about the configuration options, see Get-CsClsConfiguration and Understanding Centralized Logging Service Configuration Settings.

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:For example, to create a new configuration that defines a network folder for cache files, rollover time period for the log files and rollover size for the log files, you would type:

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.You should carefully plan the creation of new configurations and how you define new properties for the Centralized Logging Service. 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.You should be cautious about making changes and make sure you understand the impact on your ability to properly log problem scenarios. 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.You should make changes to the configuration that will enhance your ability to manage logs to a size and a rollover period that will allow problem solving when it arises.

Para quitar una configuración existente del servicio de registro centralizadoTo remove an existing Centralized Logging Service configuration

  1. 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.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Escriba lo siguiente en el símbolo de la línea de comandos:Type the following at the command-line prompt:

    Remove-CsClsConfiguration -Identity <scope and name>
    

Por ejemplo, para quitar una configuración del servicio de registro centralizado que creó para aumentar el tiempo de conversión de archivo de registro, aumente el tamaño de archivo de registro de conversión y establezca la ubicación de memoria caché del archivo de registro en un recurso compartido de red de la siguiente manera:For example, to remove a Centralized Logging Service configuration that you created to increase the log file rollover time, increase the rollover log file size, and set the log file cache location to a network share as follows:

Remove-CsClsConfiguration -Identity "site:Redmond"

Nota

Esta es la configuración nueva que se creó en el procedimiento "para"crear una nueva configuración de servicio de registro centralizado.This is the new configuration that was created in the procedure "To create a new Centralized Logging Service configuration."

Si decide quitar una configuración de sitio, el sitio usará la configuración global.If you choose to remove a site-level configuration, the site will use the global settings.

Vea tambiénSee also

Configurar los proveedores de servicio de registro centralizado en Skype para Business Server 2015Configure providers for Centralized Logging Service in Skype for Business Server 2015

Configurar escenarios para el servicio de registro centralizado en Skype para Business Server 2015Configure scenarios for the Centralized Logging Service in Skype for Business Server 2015

Servicio de registro centralizado en Skype para profesionales de 2015Centralized Logging Service in Skype for Business 2015

Set-CsClsConfigurationSet-CsClsConfiguration

Get-CsClsConfigurationGet-CsClsConfiguration

New-CsClsConfigurationNew-CsClsConfiguration

Remove-CsClsConfigurationRemove-CsClsConfiguration