Управление параметрами конфигурации централизованной службы ведения журналов в Skype для бизнеса Server 2015

  • Статья

Сводка: Узнайте, как получить, обновить и создать параметры конфигурации для централизованной службы ведения журнала в Skype для бизнеса Server 2015 г.

Централизованная служба ведения журнала управляется и настраивается параметрами и параметрами, которые создаются и используются контроллером централизованной службы ведения журнала (CLSController) для отправки команд на отдельные компьютеры Централизованный агент службы ведения журнала (CLSAgent). 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.

Важно!

Не все командлеты Windows PowerShell, перечисленные для централизованной службы ведения журнала, предназначены для использования с локальными развертываниями Skype для бизнеса Server 2015. Хотя они могут работать, следующие командлеты не предназначены для работы с локальными развертываниями Skype для бизнеса Server 2015:

Параметры, определенные в этих командлетах, не препятствуют и не вызывают негативного поведения, но предназначены для использования с Microsoft 365 или Office 365 и не дают ожидаемых результатов в локальных развертываниях. Это не значит, что эти командлеты не используются в локальных развертываниях, но их использование является более сложной статьей, которая не рассматривается в этой документации.

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

Чтобы настроить централизованную службу ведения журнала область с помощью командной консоли Skype для бизнеса Server, необходимо быть членом групп безопасности CsAdministrator или CsServerAdministrator на основе ролей управления доступом (RBAC) или пользовательской роли RBAC, содержащей любой из этих двух групп. Чтобы вернуть список всех ролей RBAC, которым назначен этот командлет (включая все пользовательские роли RBAC, которые вы создаете самостоятельно), выполните следующую команду из командной консоли Skype для бизнеса Server или Windows PowerShell командной строки:

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

Например:

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

Примечание.

Существуют фундаментальные различия между командами командной строки, которые можно выполнять в 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 принимает разделенный запятыми список полных доменных имен (FQDN) для целевого компьютера.

Совет

Вы также можете определить -Pools и разделенный запятыми список пулов, для которого требуется выполнить команды ведения журнала.

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

Важно!

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

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

  1. Запустите командную консоль Skype для бизнеса Server: нажмите кнопку Пуск, выберите Все программы, выберите Skype для бизнеса 2015, а затем щелкните командную консоль Skype для бизнеса Server.

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

    Get-CsClsConfiguration

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

Выход выборки из Get-CsClsConfiguration.

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

  1. Запустите командную консоль Skype для бизнеса Server: нажмите кнопку Пуск, щелкните Все программы, щелкните Skype для бизнеса 2015, а затем Skype для бизнеса Server командная консоль.

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

    Get-CsClsConfiguration -LocalStore

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

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

  1. Запустите командную консоль Skype для бизнеса Server: нажмите кнопку Пуск, щелкните Все программы, щелкните Skype для бизнеса 2015, а затем Skype для бизнеса Server командная консоль.

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

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

    Например, чтобы получить сценарии, определенные на глобальном область:

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

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

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

  1. Запустите командную консоль Skype для бизнеса Server: нажмите кнопку Пуск, щелкните Все программы, щелкните Skype для бизнеса 2015, а затем Skype для бизнеса Server командная консоль.

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

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

    Например:

    Set-CsClsConfiguration -Identity "global" -EtlFileRolloverSizeMB 40

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

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

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.

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

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

    Например:

    Set-CsClsConfiguration -Identity "site/Redmond" -EtlFileRolloverSizeMB 40

Примечание.

Как отмечено в примере, расположением файлов журнала по умолчанию является каталог %TEMP%\Tracing. Однако так как фактически файл записывает CLSAgent, который выполняется как сетевая служба, переменная %TEMP% расширяется до %WINDIR%\ServiceProfiles\NetworkService\AppData\Local.

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

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

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.

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

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

    Примечание.

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

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

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. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.

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

    Remove-CsClsConfiguration -Identity <scope and name>

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

Remove-CsClsConfiguration -Identity "site:Redmond"

Примечание.

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

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

См. также

Настройка поставщиков для централизованной службы ведения журналов в Skype для бизнеса Server 2015

Настройка сценариев для централизованной службы ведения журналов в Skype для бизнеса Server 2015

Centralized Logging Service in Skype for Business 2015

Set-CsClsConfiguration

Get-CsClsConfiguration

New-CsClsConfiguration

Remove-CsClsConfiguration