Administrar la configuración del servicio de registro centralizado en Lync Server 2013
Última modificación del tema: 2014-02-04
El servicio de registro centralizado se puede ejecutar en un ámbito que incluya un único equipo, 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 Lync Server, debe ser miembro de los grupos de seguridad de CsAdministrator o de control de acceso basado en roles (RBAC) de 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 se ha asignado este cmdlet (incluidos los roles RBAC personalizados que haya creado usted mismo), ejecute el siguiente comando desde el Shell de administración de Lync Server o el símbolo del Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "<Lync Server 2013 cmdlet>"}
Por ejemplo:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}
Nota
Windows PowerShell proporciona más opciones y opciones de configuración adicionales que no están disponibles mediante CLSController.exe. CLSController ofrece un método rápido y conciso para ejecutar comandos, pero está limitado al conjunto de comandos disponibles para EL CLSController. Windows PowerShell no se limita solo al comando disponible para el procesador de comandos del CLSController y proporciona un conjunto más amplio de comandos y un conjunto más completo de opciones. Por ejemplo, CLSController.exe proporciona opciones de ámbito para equipos y grupos. Con Windows PowerShell, puede indicar equipos o grupos en la mayoría de los comandos y, al definir nuevos escenarios (CLSController tiene un número finito de escenarios que no son modificables por el usuario), puede definir un sitio o un ámbito global. Esta eficaz característica de Windows PowerShell le permite definir un escenario un sitio o un ámbito global, pero limitar el registro real a un equipo o grupo.
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 un único equipo durante la ejecución de un comando de Search-CsClsLogging, Show-CsClsLogging, Start-CsClsLogging, Stop-CsClsLogging, Sync-CsClsLogging y Update-CsClsLogging usando el parámetro –Computers. Este parámetro acepta una lista separada por comas de nombres de dominio completos (FQDN) para el equipo de destino.
Propina
También puede especificar –Pools y una lista separada por comas de los grupos donde quiera 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 pretenden mostrar el uso del parámetro –Identity para definir el ámbito, y los demás parámetros se incluyen para completar la información y para 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
Inicie el Shell de administración de Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync Server.
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 configuración o para actualizar una configuración existente.
Al ejecutar Get-CsClsConfiguration, se muestra información similar a la siguiente captura de pantalla, en la que la implementación tiene actualmente la configuración global predeterminada, pero ninguna configuración de sitio definida:
.jpg "Salida de ejemplo de Get-CsClsConfiguration.")
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 Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync Server.
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 Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync Server.
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 están truncados. 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 Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync Server.
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 Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync 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> -EtlFileFolder <default location %TEMP%\Tracing>Por ejemplo:
Set-CsClsConfiguration -Identity "site/Redmond" -EtlFileRolloverSizeMB 40 -EtlFileFolder "C:\LogFiles\Tracing"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 Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync 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 las opciones de configuración del servicio de registro centralizado en Lync Server 2013.
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 Lync Server: Haga clic en Inicio, haga clic en Todos los programas, haga clic en Microsoft Lync Server 2013 y, a continuación, haga clic en Shell de administración de Lync 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.