在 Lync Server 2013 中管理计算机、站点和全局集中日志记录服务配置

 

主题上次修改时间: 2014-02-04

集中式日志记录服务可以在包括单台计算机、计算机池、站点范围 ((即包含部署) 中的计算机和池集合的站点 Redmond)或全局范围 ((即部署) 中的所有计算机和池)范围内运行。

若要使用 Lync Server Management Shell 配置集中日志记录服务范围,必须是 CsAdministrator 或 CsServerAdministrator 基于角色的访问控制 (RBAC) 安全组的成员,或包含这两个组之一的自定义 RBAC 角色的成员。 若要返回已将此 cmdlet 分配给 (的所有 RBAC 角色的列表,包括) 自己创建的任何自定义 RBAC 角色,请从 Lync Server Management Shell 或Windows PowerShell提示符运行以下命令:

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "<Lync Server 2013 cmdlet>"}

例如:

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

注意

Windows PowerShell提供了使用CLSController.exe不可用的更多选项和其他配置选项。 CLSController 提供了一种快速、简洁的方法来运行命令,但仅限于 CLSController 可用的命令集。 Windows PowerShell不仅限于 CLSController 的命令处理器可用的命令,并提供更广泛的命令集和更丰富的选项集。 例如,CLSController.exe为你提供了计算机和池的范围选项。 使用Windows PowerShell,可以指示大多数命令中的计算机或池,在定义新方案时, (CLSController 具有有限数量的不可修改的方案) 可以定义网站或全局范围。 这种强大的Windows PowerShell功能使你能够定义网站或全局范围的方案,但将实际日志记录限制为计算机或池。
可以在 Windows PowerShell 或 CLSController 中运行的命令行命令之间存在根本差异。 Windows PowerShell提供了一种丰富的方法来配置和定义方案,并以有意义的方式重用这些方案来解决故障排除方案。 尽管 CLSController 提供了快速有效的发出命令和获得结果的方法,但 CLSController 的命令集受到您从命令行获得的有限数量的命令的限制。 与Windows PowerShell cmdlet 不同,CLSController 无法定义新方案、在站点或全局级别管理范围,以及无法动态配置的有限命令集的许多其他限制。 虽然 CLSController 为快速执行提供了一种手段,但Windows PowerShell提供了将集中日志记录服务功能扩展到 CLSController 的可能范围之外的方法。

可以使用 –Computers 参数在 Search-CsClsLoggingShow-CsClsLoggingStart-CsClsLoggingStop-CsClsLoggingSync-CsClsLoggingUpdate-CsClsLogging 命令执行期间定义单个计算机的作用域。 –Computers 参数接受目标计算机的以逗号分隔的完全限定域名 (FQDN) 的列表。

提示

还可以定义–Pools 和您要对其运行日志记录命令的以逗号分隔的池的列表。

网站和全局范围在 新建删除集中式 日志记录服务 cmdlet 中定义。 以下示例演示了如何设置站点和全局作用域。

重要

显示的命令可能包含其他章节中涵盖的参数和概念。 示例命令旨在演示如何使用 –Identity 参数定义作用域,还包含了其他参数来保证完整性和指定作用域。 有关 Set-CsClsConfiguration cmdlet 的详细信息,请参阅操作文档中的 Set-CsClsConfiguration

检索当前集中式日志记录服务配置

  1. 启动 Lync Server Management Shell:单击 “开始”,单击 “所有程序”,单击 Microsoft Lync Server 2013,然后单击 Lync Server Management Shell

  2. 在命令行提示符处键入以下内容:

    Get-CsClsConfiguration
    

使用 New-CsClsConfigurationSet-CsClsConfiguration cmdlet 创建新配置或更新现有配置。

当运行 Get-CsClsConfiguration 时,它将显示类似于下面的屏幕快照的信息,其中,部署当前具有默认的全局配置,但未定义站点配置:

Get-CsClsConfiguration 的示例输出。

从计算机本地存储中检索当前集中日志记录服务配置

  1. 启动 Lync Server Management Shell:单击 “开始”,单击 “所有程序”,单击 Microsoft Lync Server 2013,然后单击 Lync Server Management Shell

  2. 在命令行提示符处键入以下内容:

    Get-CsClsConfiguration -LocalStore
    

使用 Get-CsClsConfiguration 未指定任何参数的第一个示例时,该命令会引用数据的中央管理存储。 如果指定参数 –LocalStore,则该命令将引用计算机 LocalStore 而不是中央管理存储。

检索当前定义的方案的列表

  1. 启动 Lync Server Management Shell:单击 “开始”,单击 “所有程序”,单击 Microsoft Lync Server 2013,然后单击 Lync Server Management Shell

  2. 在命令行提示符处键入以下内容:

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

    例如,检索在全局作用域定义的方案:

    Get-CsClsConfiguration -Identity "global" | Select-Object -ExpandProperty Scenarios
    

cmdlet Get-CsClsConfiguration 始终显示作为给定作用域的配置的一部分的方案。 在大多数情况下,不会显示所有方案,而会截断它们。 此处使用的命令列出所有方案和有关所使用的提供程序、设置和标记的部分信息。

使用Windows PowerShell更新集中日志记录服务的全局范围

  1. 启动 Lync Server Management Shell:单击 “开始”,单击 “所有程序”,单击 Microsoft Lync Server 2013,然后单击 Lync Server Management Shell

  2. 在命令行提示符处键入以下内容:

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

    例如:

    Set-CsClsConfiguration -Identity "global" -EtlFileRolloverSizeMB 40
    

该命令指示部署中的每个计算机和池中的 CLSAgent 将跟踪文件上的滚动值的大小设置为 40 MB。 所有站点中的计算机和池都受该命令的影响,并且会将其已配置的跟踪日志滚动值设置为 40 MB。

使用Windows PowerShell更新集中日志记录服务的站点范围

  1. 启动 Lync Server Management Shell:单击 “开始”,单击 “所有程序”,单击 Microsoft Lync Server 2013,然后单击 Lync Server Management Shell

  2. 在命令行提示符处键入以下内容:

    Set-CsClsConfiguration -Identity <scope/site name> -EtlFileRolloverSizeMB <size for logging file in megabytes> -EtlFileFolder <default location %TEMP%\Tracing>
    

    例如:

    Set-CsClsConfiguration -Identity "site/Redmond" -EtlFileRolloverSizeMB 40 -EtlFileFolder "C:\LogFiles\Tracing" 
    

    注意

    如示例中所示,日志文件的默认位置是 %TEMP%\Tracing。 但是,由于实际上是 CLSAgent 写入该文件,而且 CLSAgent 以 Network Service 的身份运行,因此 %TEMP% 变量将展开到 %WINDIR%\ServiceProfiles\NetworkService\AppData\Local。

该命令指示 Redmond 站点中的每个计算机和池中的 CLSAgent 将跟踪文件上的滚动值的大小设置为 40 MB。 其他站点中的计算机和池不会受该命令的影响,并将继续使用当前配置的跟踪日志滚动值(默认定义的 (20 MB) 或在日志记录会话开始时定义的)。

创建新的集中式日志记录服务配置

  1. 启动 Lync Server Management Shell:单击 “开始”,单击 “所有程序”,单击 Microsoft Lync Server 2013,然后单击 Lync Server Management Shell

  2. 在命令行提示符处键入以下内容:

    New-CsClsConfiguration -Identity <scope and name> [CsClsConfiguration options for this site]
    

    注意

    利用 New-CsClsConfiguration,可以访问大量可选配置设置。 有关配置选项的详细信息,请参阅 Lync Server 2013 中的 Get-CsClsConfiguration了解集中日志记录服务配置设置

    例如,要创建用于定义缓存文件的网络文件夹、日志文件的滚动时间段和日志文件的滚动大小的新配置,您将键入:

    New-CsClsConfiguration -Identity "site:Redmond" -CacheFileNetworkFolder "\\fs01.contoso.net\filestore\logfiles" -EtlFileRolloverMinutes 120 -EtlFileRolloverSizeMB 40
    

应仔细规划新配置的创建,以及如何为集中日志记录服务定义新属性。 您在进行更改时应格外小心,并应确保了解对您正确记录问题方案的能力的影响。 您应更改配置,提高管理日志大小和滚动周期(允许在问题发生时予以解决)的能力。

删除现有的集中式日志记录服务配置

  1. 启动 Lync Server Management Shell:单击 “开始”,单击 “所有程序”,单击 Microsoft Lync Server 2013,然后单击 Lync Server Management Shell

  2. 在命令行提示符处键入以下内容:

    Remove-CsClsConfiguration -Identity <scope and name>
    

    例如,若要删除为增加日志文件滚动更新时间而创建的集中日志记录服务配置,请增加滚动更新日志文件大小,并将日志文件缓存位置设置为网络共享,如下所示:

    Remove-CsClsConfiguration -Identity "site:Redmond"
    

    注意

    这是在“创建新的集中日志记录服务配置”过程中创建的新配置。

如果选择删除站点级配置,站点将使用全局设置。