Gerenciando o computador, o site e a configuração global do Serviço de Log Centralizado no Lync Server 2013
Tópico última modificação: 04/02/2014
O Serviço de Log Centralizado pode ser executado em um escopo que inclui um único computador, um pool de computadores, em um escopo de site (ou seja, um site definido, como o site Redmond que contém uma coleção de computadores e pools em sua implantação) ou em um escopo global (ou seja, todos os computadores e pools em sua implantação).
Para configurar o escopo do Serviço de Log Centralizado usando o Shell de Gerenciamento do Lync Server, você deve ser membro dos grupos de segurança CsAdministrator ou RBAC (controle de acesso baseado em função) CsServerAdministrator ou uma função RBAC personalizada que contenha um desses dois grupos. Para retornar uma lista de todas as funções RBAC às qual este cmdlet foi atribuído (incluindo quaisquer funções RBAC personalizadas que você mesmo criou), execute o seguinte comando no Shell de Gerenciamento do Lync Server ou no prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "<Lync Server 2013 cmdlet>"}
Por exemplo:
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}
Nota
Windows PowerShell fornece mais opções e opções de configuração adicionais que não estão disponíveis usando CLSController.exe. O CLSController oferece um método rápido e conciso para executar comandos, mas é limitado ao conjunto de comandos disponíveis para o CLSController. Windows PowerShell não se limita apenas ao comando disponível para o processador de comandos do CLSController e fornece um conjunto mais amplo de comandos e um conjunto mais avançado de opções. Por exemplo, CLSController.exe fornece opções de escopo para –computadores e pools. Com Windows PowerShell, você pode indicar computadores ou pools na maioria dos comandos e, ao definir novos cenários (o CLSController tem um número finito de cenários que não são modificáveis pelo usuário), você pode definir um escopo de site ou global. Esse recurso avançado de Windows PowerShell permite definir um cenário um escopo de site ou global, mas limitar o log real a um computador ou pool.
Há diferenças fundamentais entre os comandos de linha de comando que você pode executar no Windows PowerShell ou CLSController. Windows PowerShell fornece um método avançado para configurar e definir cenários e reutilizar esses cenários de maneira significativa para seus cenários de solução de problemas. Embora o CLSController forneça uma maneira rápida e eficiente para emitir comandos e obter resultados, o conjunto de comandos do CLSController está limitado aos comandos finitos que você tem disponível na linha de comando. Ao contrário dos cmdlets do Windows PowerShell, o CLSController não pode definir novos cenários, gerenciar o escopo em um site ou nível global e muitas outras limitações de um conjunto de comandos finito que não pode ser configurado dinamicamente. Embora o CLSController forneça um meio para execução rápida, o Windows PowerShell fornece um meio de estender a funcionalidade do Serviço de Log Centralizado além do que é possível com o CLSController.
Um escopo de computador exclusivo pode ser definido durante a execução de um comando Search-CsClsLogging, Show-CsClsLogging, Start-CsClsLogging, Stop-CsClsLogging, Sync-CsClsLogging e Update-CsClsLogging usando o parâmetro –Computers. Esse parâmetro aceita uma lista separada por vírgulas de FQDNs (nomes de domínio totalmente qualificados) para o computador de destino.
Ponta
Você pode também definir –Pools e uma lista de pools separada por vírgula na qual você deseja executar os comandos de log.
Os escopos site e global são definidos nos cmdlets New-, Set-, and Remove- Centralized Logging Service. Os exemplos a seguir demonstram como definir o escopo global ou de um site.
Importante
Os comandos mostrados podem conter parâmetros e conceitos que são abordados em outras seções. O exemplo de comandos tem a finalidade de demonstrar o uso do parâmetro –Identity para definir escopo e os outros parâmetros são incluídos para a integridade e para especificar o escopo. Para obter detalhes sobre os cmdlets do Set-CsClsConfiguration, consulte Set-CsClsConfiguration na documentação Operações.
Para recuperar a configuração atual do Serviço de Log Centralizado
Inicie o Shell de Gerenciamento do Lync Server: clique em Iniciar, clique em Todos os Programas, clique em Microsoft Lync Server 2013 e, em seguida, clique no Shell de Gerenciamento do Lync Server.
Digite o seguinte no prompt de linha de comando:
Get-CsClsConfiguration
Use os cmdlets New-CsClsConfiguration e Set-CsClsConfiguration para criar uma nova configuração ou para atualizar uma configuração existente.
Quando o Get-CsClsConfiguration é executado, ele exibe informações semelhantes à seguinte captura de tela, onde a implantação atualmente tem a configuração global, mas nenhuma configuração de site definida:
Para recuperar a configuração atual do Serviço de Log Centralizado do repositório local do computador
Inicie o Shell de Gerenciamento do Lync Server: clique em Iniciar, clique em Todos os Programas, clique em Microsoft Lync Server 2013 e, em seguida, clique no Shell de Gerenciamento do Lync Server.
Digite o seguinte no prompt de linha de comando:
Get-CsClsConfiguration -LocalStore
Quando você usa o primeiro exemplo em que Get-CsClsConfiguration não especifica nenhum parâmetro, o comando faz referência ao repositório de Gerenciamento Central para os dados. Se você especificar o parâmetro –LocalStore, o comando referencia o localStore do computador em vez do repositório de Gerenciamento Central.
Para recuperar uma lista de cenários definidos no momento
Inicie o Shell de Gerenciamento do Lync Server: clique em Iniciar, clique em Todos os Programas, clique em Microsoft Lync Server 2013 e, em seguida, clique no Shell de Gerenciamento do Lync Server.
Digite o seguinte no prompt de linha de comando:
Get-CsClsConfiguration -Identity <scope and name> | Select-Object -ExpandProperty Scenarios
Por exemplo, para recuperar os cenários definidos no escopo global:
Get-CsClsConfiguration -Identity "global" | Select-Object -ExpandProperty Scenarios
O cmdlet Get-CsClsConfiguration sempre exibe os cenários que fazem parte de uma dada configuração de escopo. Na maioria dos casos, nem todos os cenários são exibidos e estão truncados. O comando usado aqui lista todos os cenários e as informações parciais sobre quais provedores, configurações e sinalizadores são usados.
Para atualizar um escopo global para o Serviço de Log Centralizado usando o Windows PowerShell
Inicie o Shell de Gerenciamento do Lync Server: clique em Iniciar, clique em Todos os Programas, clique em Microsoft Lync Server 2013 e, em seguida, clique no Shell de Gerenciamento do Lync Server.
Digite o seguinte no prompt de linha de comando:
Set-CsClsConfiguration -Identity <scope> -EtlFileRolloverSizeMB <size for logging file in megabytes>
Por exemplo:
Set-CsClsConfiguration -Identity "global" -EtlFileRolloverSizeMB 40
O comando diz ao CLSAgent em cada computador e pool na implantação para definir o tamanho do valor de sobreposição no arquivo de rastreamento para 40 megabytes. Os computadores e pools em todos os sites são afetados pelo comando, e definirão seu valor configurado de sobreposição de log de rastreamento para 40 megabytes.
Para atualizar um escopo de site para o Serviço de Log Centralizado usando o Windows PowerShell
Inicie o Shell de Gerenciamento do Lync Server: clique em Iniciar, clique em Todos os Programas, clique em Microsoft Lync Server 2013 e, em seguida, clique no Shell de Gerenciamento do Lync Server.
Digite o seguinte no prompt de linha de comando:
Set-CsClsConfiguration -Identity <scope/site name> -EtlFileRolloverSizeMB <size for logging file in megabytes> -EtlFileFolder <default location %TEMP%\Tracing>
Por exemplo:
Set-CsClsConfiguration -Identity "site/Redmond" -EtlFileRolloverSizeMB 40 -EtlFileFolder "C:\LogFiles\Tracing"
Nota
Como observado no exemplo, o local padrão dos arquivos de log é %TEMP%\Tracing. No entanto, como é o CLSAgent que está gravando o arquivo, e o CSLAgent é executado no Serviço de Rede, a variável %TEMP% expande para %WINDIR%\ServiceProfiles\NetworkService\AppData\Local.
O comando diz ao CLSAgent em cada computador e pool no site da Redmond para definir o tamanho do valor de sobreposição no arquivo de rastreamento para 40 megabytes. Os computadores e pools em outros sites não serão afetados pelo comando, e continuarão a usar o valor atualmente configurado de sobreposição de log de rastreamento definido pelo padrão (20 megabytes) ou durante o início da sessão de log.
Para criar uma nova configuração do Serviço de Log Centralizado
Inicie o Shell de Gerenciamento do Lync Server: clique em Iniciar, clique em Todos os Programas, clique em Microsoft Lync Server 2013 e, em seguida, clique no Shell de Gerenciamento do Lync Server.
Digite o seguinte no prompt de linha de comando:
New-CsClsConfiguration -Identity <scope and name> [CsClsConfiguration options for this site]
Nota
New-CsClsConfiguration fornece acesso a um grande número de definições de configuração adicionais. Para obter detalhes sobre as opções de configuração, consulte Get-CsClsConfiguration e Noções básicas sobre as definições de configuração do Serviço de Log Centralizado no Lync Server 2013.
Por exemplo, para criar uma nova configuração que defina uma pasta de rede para arquivos de cache, o período de tempo de sobreposição dos arquivos de log e tamanho de sobreposição dos arquivos de log, você deverá digitar:
New-CsClsConfiguration -Identity "site:Redmond" -CacheFileNetworkFolder "\\fs01.contoso.net\filestore\logfiles" -EtlFileRolloverMinutes 120 -EtlFileRolloverSizeMB 40
Você deve planejar cuidadosamente a criação de novas configurações e como definir novas propriedades para o Serviço de Log Centralizado. Você deve ter cuidado ao fazer alterações e ter certeza que compreende o impacto da sua capacidade de registrar cenários de problema corretamente. Você deve fazer alterações na configuração que melhorarão sua capacidade de gerenciar logs para um tamanho e período de sobreposição que permita resolver problemas, quando surgirem.
Para remover uma configuração existente do Serviço de Log Centralizado
Inicie o Shell de Gerenciamento do Lync Server: clique em Iniciar, clique em Todos os Programas, clique em Microsoft Lync Server 2013 e, em seguida, clique no Shell de Gerenciamento do Lync Server.
Digite o seguinte no prompt de linha de comando:
Remove-CsClsConfiguration -Identity <scope and name>
Por exemplo, para remover uma configuração do Serviço de Log Centralizado que você criou para aumentar o tempo de substituição do arquivo de log, aumente o tamanho do arquivo de log de substituição e defina o local do cache do arquivo de log como um compartilhamento de rede da seguinte maneira:
Remove-CsClsConfiguration -Identity "site:Redmond"
Nota
Essa é a nova configuração que foi criada no procedimento "Para criar uma nova configuração do Serviço de Log Centralizado".
Se decidir remover a configuração no nível do site, o site usará as configurações globais.