Управление конфигурацией компьютера, сайта и глобальной централизованной службы ведения журнала в Lync Server 2013

  • Статья

 

Последнее изменение раздела: 2014-02-04

Централизованную службу ведения журнала можно запустить в области, которая включает один компьютер, пул компьютеров, на уровне сайта (то есть на определенном сайте, например на сайте Redmond, который содержит коллекцию компьютеров и пулов в развертывании) или в глобальной области (т. е. на всех компьютерах и пулах в развертывании).

Чтобы настроить область централизованной службы ведения журналов с помощью командной консоли Lync Server, необходимо быть членом групп безопасности CsAdministrator или CsServerAdministrator на основе ролей (RBAC) или настраиваемой роли RBAC, которая содержит эти две группы. Чтобы получить список всех ролей RBAC, которым был назначен этот командлет (включая все пользовательские роли RBAC, созданные вами самостоятельно), выполните следующую команду из командной консоли Lync Server или 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 предоставляет параметры области для –computers и –pools. С Windows PowerShell можно указать компьютеры или пулы в большинстве команд, а при выборе новых сценариев (CLSController имеет конечное число сценариев, которые не являются изменяемыми пользователем) можно определить сайт или глобальную область. Эта мощная функция Windows PowerShell позволяет определить сценарий сайта или глобальной области, но ограничить фактическое ведение журнала компьютером или пулом.
Существуют фундаментальные различия между командами командной строки, которые можно выполнять в Windows PowerShell или CLSController. Windows PowerShell предоставляет расширенный метод для настройки и определения сценариев, а также для более понятного использования этих сценариев в сценариях устранения неполадок. 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. В отличие от Windows PowerShell командлетов, CLSController не может определять новые сценарии, управлять областью на уровне сайта или на глобальном уровне и многими другими ограничениями конечного набора команд, который нельзя настроить динамически. Хотя CLSController предоставляет средства для быстрого выполнения, Windows PowerShell предоставляет средства для расширения функций централизованной службы ведения журнала за пределами возможностей CLSController.

Область одного компьютера можно определить при выполнении команд Search-CsClsLogging, Show-CsClsLogging, Start-CsClsLogging, Stop-CsClsLogging, Sync-CsClsLogging и Update-CsClsLogging с помощью параметра –Computers. Параметр –Computers принимает разделенный запятой список полных доменных имен для целевого компьютера.

Совет

С помощью параметра –Pools можно задать разделенный запятой список пулов, в которых должны выполняться команды ведения журнала.

Области сайта и глобальные области определяются в командлетах централизированной службы ведения журналов New-, Set иRemove . The following examples demonstrate how to set a site and a global scope.

Важно

Показанные команды могут содержать параметры и концепции, описанные в других разделах. Команды в примерах предназначены для демонстрации использования параметра –Identity для определения области, а другие параметры включены для полноты и для указания области. Дополнительные сведения о командлетах Set-CsClsConfiguration см. в описании командлета Set-CsClsConfiguration в документации по применению.

Получение текущей конфигурации централизованной службы ведения журнала

  1. Запустите консоль управления Lync Server: нажмите кнопку "Пуск ", выберите пункт "Все программы ",щелкните Microsoft Lync Server 2013, а затем щелкните Lync Server Management Shell.

  2. Введите следующую команду в командной строке:

    Get-CsClsConfiguration

Используйте командлеты New-CsClsConfiguration и Set-CsClsConfiguration для создания новой конфигурации или для обновления существующей.

При выполнении командлета Get-CsClsConfiguration отображаются сведения, подобные показанным на следующем снимке экрана. В этом примере в развертывании имеется глобальная конфигурация по умолчанию, а конфигурации сайтов не определены:

Пример выходных данных get-CsClsConfiguration.

Получение текущей конфигурации централизованной службы ведения журнала из локального хранилища компьютера

  1. Запустите консоль управления Lync Server: нажмите кнопку "Пуск ", выберите пункт "Все программы ",щелкните Microsoft Lync Server 2013, а затем щелкните Lync Server Management Shell.

  2. Введите следующую команду в командной строке:

    Get-CsClsConfiguration -LocalStore

При использовании первого примера, в котором Get-CsClsConfiguration не указывает никаких параметров, команда ссылается на центральное хранилище управления для данных. Если указан параметр –LocalStore, команда ссылается на компьютер LocalStore, а не на центральное хранилище управления.

Получение списка сценариев, определенных в текущий момент

  1. Запустите консоль управления Lync Server: нажмите кнопку "Пуск ", выберите пункт "Все программы ",щелкните 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

Командлет Get-CsClsConfiguration всегда отображает сценарии, которые являются частью конфигурации заданной области. В большинстве случаев отображаются не все сценарии, кроме того, отображаемые сценарии сокращаются. Используемая здесь команда отображает список всех сценариев и частичные сведения об используемых поставщиках, настройках и флагах.

Обновление глобальной области для централизованной службы ведения журнала с помощью Windows PowerShell

  1. Запустите консоль управления Lync Server: нажмите кнопку "Пуск ", выберите пункт "Все программы ",щелкните 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 МБ. Эта команда влияет на компьютеры и пулы на всех сайтах и задает в качестве размера переключения на новый журнал трассировки значение 40 МБ.

Обновление области сайта для централизованной службы ведения журнала с помощью Windows PowerShell

  1. Запустите консоль управления Lync Server: нажмите кнопку "Пуск ", выберите пункт "Все программы ",щелкните 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, который выполняется как сетевая служба, переменная %TEMP% расширяется до %WINDIR%\ServiceProfiles\NetworkService\AppData\Local.

При выполнении этой команды CLSAgent на каждом компьютере и в каждом пуле сайта Redmond задает для размера переключения на новый файл трассировки значение 40 МБ. Эта команда не повлияет на компьютеры и пулы на других сайтах, которые продолжат использовать текущее значение размера переключения на новый журнал трассировки, определенное либо по умолчанию (20 МБ), либо во время запуска сеанса ведения журнала.

Создание новой конфигурации централизованной службы ведения журнала

  1. Запустите консоль управления Lync Server: нажмите кнопку "Пуск ", выберите пункт "Все программы ",щелкните Microsoft Lync Server 2013, а затем щелкните Lync Server Management Shell.

  2. Введите следующую команду в командной строке:

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

    Примечание.

    Командлет New-CsClsConfiguration предоставляет доступ к большому количеству необязательных параметров конфигурации. Дополнительные сведения о параметрах конфигурации см. в разделах Get-CsClsConfiguration и Understanding Centralized Logging Service configuration settings in Lync Server 2013.

    Например для создания новой конфигурации, которая определяет сетевую папку для файлов кэша, а также период и размер переключения для файлов журнала, введите следующую команду:

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

Следует тщательно спланировать создание новых конфигураций и определение новых свойств для централизованной службы ведения журнала. You should be cautious about making changes and make sure you understand the impact on your ability to properly log problem scenarios. 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.

Удаление существующей конфигурации централизованной службы ведения журнала

  1. Запустите консоль управления Lync Server: нажмите кнопку "Пуск ", выберите пункт "Все программы ",щелкните Microsoft Lync Server 2013, а затем щелкните Lync Server Management Shell.

  2. Введите следующую команду в командной строке:

    Remove-CsClsConfiguration -Identity <scope and name>

    Например, чтобы удалить конфигурацию централизованной службы ведения журналов, созданную для увеличения времени смены файла журнала, увеличьте размер файла журнала смены и задайте расположение кэша файлов журнала в сетевую папку следующим образом:

    Remove-CsClsConfiguration -Identity "site:Redmond"

    Примечание.

    Это новая конфигурация, созданная в процедуре "Создание новой конфигурации централизованной службы ведения журнала".

Если удалить конфигурацию уровня сайта, сайт будет использовать глобальные параметры.