Управление параметрами конфигурации централизованной службы ведения журналов в Skype для бизнеса Server 2015Manage Centralized Logging Service configuration settings in Skype for Business Server 2015

Сводка: Узнайте, как для получения, обновления и создать параметры конфигурации для службы централизованного ведения журналов в Скайп для Business Server 2015.Summary: Learn how to retrieve, update, and create configuration settings for the Centralized Logging Service in Skype for Business Server 2015.

Управляемые и настроен с использованием параметров и параметров, которые создаются и используются контроллером централизованного ведения журналов службы (CLSController) для отправки команд в отдельных компьютера службы агента централизованного ведения журналов (службы централизованного ведения журналов CLSAgent).The Centralized Logging Service is controlled and configured by settings and parameters that are created and used by the Centralized Logging Service Controller (CLSController) to send commands to the individual computer's Centralized Logging Service Agent (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, перечисленных для службы централизованного ведения журналов предназначены для использования с Скайп для развертываний локальной Business Server 2015.Not all Windows PowerShell cmdlets listed for the Centralized Logging Service are intended for use with Skype for Business Server 2015 on-premises deployments. Несмотря на то, что они могут отображаться для работы, следующие командлеты не предназначены для работы с Скайп для развертываний локальной Business Server 2015:Although they may appear to work, the following cmdlets are not designed to function with Skype for Business Server 2015 on-premises deployments:

Параметров, определенных в эти командлеты не мешать или стать причиной любое неблагоприятным поведение, но они предназначены для использования с помощью Microsoft Office 365 и будет дает ожидаемых результатов в локальных развертываниях.The settings defined in these cmdlets will not hinder or cause any adverse behavior, but they are designed for use with Microsoft Office 365 and will not yield the expected results in on-premises deployments. Это не означает полную бесполезность таких командлетов в локальных развертываниях, но вопрос об их использовании выходит за рамки данной документации.This is not to say that there is no use for these cmdlets in on-premises deployments, but their use is a more advanced topic that is not covered in this documentation.

Службы централизованного ведения журналов может выполняться на уровне, который включает в себя отдельный компьютер или пул компьютеров, на уровне сайта (то есть, определенного сайта например сайта Redmond, содержащее набор компьютера и пулы в развертывании) или в глобальной области (например все компьютеры и пулы в развертывании).The Centralized Logging Service can be run at a scope that includes a single computer or a pool of computers, at a site scope (that is, a defined site such as the site Redmond that contains a collection of computer and pools in your deployment), or at a global scope (that is, all computers and pools in your deployment).

Настройка области действия службы централизованного ведения журналов с помощью Скайп для консоли Business Server, должна быть членом CsAdministrator или групп безопасности CsServerAdministrator доступом на основе ролей (RBAC) элемента управления или настраиваемые роли RBAC, содержит любой из этих двух групп.To configure the Centralized Logging Service scope by using the Skype for Business Server Management Shell, you must be a member of either the CsAdministrator or the CsServerAdministrator role-based access control (RBAC) security groups, or a custom RBAC role that contains either of these two groups. Чтобы получить список всех ролей RBAC, назначенных этот командлет (включая любые пользовательские роли RBAC, созданные самостоятельно), выполните следующую команду из Скайп для консоли Business Server или в командной строке Windows PowerShell:To return a list of all the RBAC roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Skype for Business Server Management Shell or the Windows PowerShell prompt:

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

Например:For example:

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

Примечание

Существуют основные различия между командной строки, которые могут работать в Windows PowerShell или CLSController.There are fundamental differences between the command-line commands that you can run in Windows PowerShell or CLSController. Windows PowerShell предоставляет метод расширенными возможностями для настройки и определить сценарии и повторно использовать эти сценарии осмысленно для устранения неполадок сценариев.Windows PowerShell provides a rich method to configure and define scenarios, and to reuse those scenarios in a meaningful way for your troubleshooting scenarios. Во время CLSController обеспечивают быстрое и эффективный способ выполнения команд и получения результатов, команды, установленное для CLSController ограничивается конечный команды, у вас есть доступны из командной строки.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 не может определить новые сценарии, управление область действия на сайте или глобальном уровне и многие другие ограничения набор конечное команд, не может быть настроено динамически.Unlike the Windows PowerShell cmdlets, CLSController cannot define new scenarios, manage scope at a site or global level, and many other limitations of a finite command set that cannot be dynamically configured. Хотя CLSController предоставляет средства для быстрого выполнения, Windows PowerShell служит для расширения функциональности Centralized Logging Service за рамки возможностей с CLSController.While CLSController provides a means for fast execution, Windows PowerShell provides a means to extend the Centralized Logging Service functionality beyond what is possible with CLSController.

Область отдельный компьютер может быть определен во время выполнения Search-CsClsLogging, Show-CsClsLogging, Start-CsClsLogging, Stop-CsClsLogging, Sync-CsClsLogging и Update-CsClsLogging команды с помощью параметра - компьютеров.A single computer scope can be defined during the execution of a Search-CsClsLogging, Show-CsClsLogging, Start-CsClsLogging, Stop-CsClsLogging, Sync-CsClsLogging and Update-CsClsLogging command using the -Computers parameter. -Компьютеров параметр может принимать список разделенных запятыми полные доменные имена (FQDN) конечного компьютера.The -Computers parameter accepts a comma separated list of fully qualified domain names (FQDNs) for the target computer.

Совет

Можно также назначить - пулов и пулов, которые необходимо выполнять команды ведения журнала на список разделенных запятыми.You can also define -Pools and a comma separated list of pools that you want to run the logging commands on.

Сайта и глобальной области определены в командлетах New- Set -и Remove - централизованной службы ведения журналов.Site and Global scopes are defined in the New-, Set-, and Remove- Centralized Logging Service cmdlets. В приведенных ниже примерах демонстрируется настройка сайта и глобальной области.The following examples demonstrate how to set a site and a global scope.

Важно!

Показанные команды могут содержать параметры и концепции, описанные в других разделах.The commands shown may contain parameters and concepts that are covered in other sections. Примеры команд предназначены для демонстрации использования -Identity параметр для определения области, а другие параметры включены для полноты и для определения области действия.The example commands are intended to demonstrate the use of the -Identity parameter to define scope, and the other parameters are included for completeness and to specify the scope. Для получения дополнительных сведений о командлеты Set-CsClsConfiguration видеть Set-CsClsConfiguration в документации по операциям.For details about the Set-CsClsConfiguration cmdlets, see Set-CsClsConfiguration in the Operations documentation.

Чтобы получить текущую конфигурацию централизованной службы ведения журналовTo retrieve the current Centralized Logging Service configuration

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Введите следующую команду в командной строке:Type the following at the command-line prompt:

    Get-CsClsConfiguration
    

Используйте командлеты New-CsClsConfiguration и Set-CsClsConfiguration для создания новой конфигурации или для обновления существующей конфигурации. При выполнении Get-CsClsConfiguration, отображает сведения, похожие на следующем рисунке, где развертывания в настоящее время имеет глобальную конфигурацию по умолчанию, но не определен конфигурации сайта:Use the New-CsClsConfiguration and Set-CsClsConfiguration cmdlets to create a new configuration or to update an existing configuration.When you run Get-CsClsConfiguration, it displays information similar to the following screen shot, where the deployment currently has the default Global configuration, but no site configurations defined:

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

Чтобы получить текущую конфигурацию централизованной службы ведения журналов из локального хранилища компьютераTo retrieve the current Centralized Logging Service configuration from the computer local store

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Введите следующую команду в командной строке:Type the following at the command-line prompt:

    Get-CsClsConfiguration -LocalStore
    

При использовании первом примере где Get-CsClsConfiguration никакие параметры не указаны, команда ссылки хранилища для данных.When you use the first example where Get-CsClsConfiguration does not specify any parameters, the command references the Central Management store for the data. Если указан параметр - LocalStore, команда ссылается на компьютере LocalStore вместо центрального хранилища управления.If you specify the parameter -LocalStore, the command references the computer LocalStore instead of the Central Management store.

Получение списка сценариев, определенных в текущий моментTo retrieve a listing of scenarios currently defined

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Введите следующую команду в командной строке:Type the following at the command-line prompt:

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

    Например для получения сценариев, определенных в глобальной области, выполните следующую команду.For example, to retrieve the scenarios that is defined at the global scope:

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

Командлет Get-CsClsConfiguration всегда отображается сценариев, которые являются частью конфигурации заданной области действия.The cmdlet Get-CsClsConfiguration always displays the scenarios that are a part of a given scope's configuration. В большинстве случаев отображаются не все сценарии, кроме того, отображаемые сценарии сокращаются.In most cases, all scenarios are not displayed, and are truncated. Используемая здесь команда отображает список всех сценариев и частичные сведения об используемых поставщиках, настройках и флагах.The command used here lists all of the scenarios and partial information about what providers, settings, and flags are used.

Обновление глобальной области для службы централизованного ведения журналов с помощью Windows PowerShellTo update a global scope for the Centralized Logging Service by using Windows PowerShell

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Введите следующую команду в командной строке:Type the following at the command-line prompt:

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

    Например:For example:

    Set-CsClsConfiguration -Identity "global" -EtlFileRolloverSizeMB 40
    

При выполнении этой команды CLSAgent на каждом компьютере и в каждом пуле развертывания задает для размера переключения на новый файл трассировки значение 40 МБ. Эта команда влияет на компьютеры и пулы на всех сайтах и задает в качестве размера переключения на новый журнал трассировки значение 40 МБ.The command tells the CLSAgent on each computer and pool in the deployment to set the size of the rollover value on the tracing file to 40 megabytes. Computers and pools in all sites are affected by the command, and will set their configured trace log rollover value to 40 megabytes.

Обновление области сайта для службы централизованного ведения журналов с помощью Windows PowerShellTo update a site scope for the Centralized Logging Service by using Windows PowerShell

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Введите следующую команду в командной строке:Type the following at the command-line prompt:

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

    Например:For example:

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

Примечание

Как отмечено в примере, расположением файлов журнала по умолчанию является каталог %TEMP%\Tracing. Однако так как фактически файл записывает CLSAgent, который выполняется как сетевая служба, переменная %TEMP% расширяется до %WINDIR%\ServiceProfiles\NetworkService\AppData\Local.As noted in the example, the default location of the log files is %TEMP%\Tracing. However, because it is actually CLSAgent that is writing the file and CSLAgent runs as Network Service, the %TEMP% variable expands to %WINDIR%\ServiceProfiles\NetworkService\AppData\Local.

При выполнении этой команды CLSAgent на каждом компьютере и в каждом пуле сайта Redmond задает для размера переключения на новый файл трассировки значение 40 МБ. Эта команда не повлияет на компьютеры и пулы на других сайтах, которые продолжат использовать текущее значение размера переключения на новый журнал трассировки, определенное либо по умолчанию (20 МБ), либо во время запуска сеанса ведения журнала.The command tells the CLSAgent on each computer and pool in the site Redmond to set the size of the rollover value on the tracing file to 40 megabytes. Computers and pools in other sites will not be affected by the command, and will continue to use the currently configured trace log rollover value defined either by default (20 megabytes) or during the start of the logging session.

Чтобы создать новую конфигурацию централизованной службы ведения журналовTo create a new Centralized Logging Service configuration

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Введите следующую команду в командной строке:Type the following at the command-line prompt:

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

    Примечание

    Командлет New-CsClsConfiguration предоставляет доступ к большому количеству необязательных параметров конфигурации.New-CsClsConfiguration provides access to a large number of optional configuration settings. Для получения дополнительных сведений о параметрах конфигурации видеть Get-CsClsConfiguration и Общие сведения о централизованного ведения журналов параметры конфигурации службы.For details about the configuration options, see Get-CsClsConfiguration and Understanding Centralized Logging Service Configuration Settings.

Например для создания новой конфигурации, которая определяет сетевую папку для файлов кэша, а также период и размер переключения для файлов журнала, введите следующую команду:For example, to create a new configuration that defines a network folder for cache files, rollover time period for the log files and rollover size for the log files, you would type:

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

Необходимо тщательно спланировать создания новой конфигурации и определение новых свойств для службы централизованного ведения журналов.You should carefully plan the creation of new configurations and how you define new properties for the Centralized Logging Service. Следует соблюдать осторожность о внесении изменений и убедитесь, что понять воздействие на возможность должным образом войдите в сценарии проблемы.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.

Для удаления существующей конфигурации службы централизованного ведения журналовTo remove an existing Centralized Logging Service configuration

  1. Запустите командную консоль Skype для бизнеса: нажмите кнопку Пуск, последовательно выберите пункты Все программы и Skype для бизнеса 2015 и щелкните элемент Командная консоль Skype для бизнеса.Start the Skype for Business Server Management Shell: Click Start, click All Programs, click Skype for Business 2015, and then click Skype for Business Server Management Shell.

  2. Введите следующую команду в командной строке:Type the following at the command-line prompt:

    Remove-CsClsConfiguration -Identity <scope and name>
    

К примеру Чтобы удалить конфигурацию централизованной службы ведения журналов, созданный для увеличения времени откат файлов журнала, увеличение размера файла журнала откат и задайте расположение кэша файла журнала в сетевом ресурсе, как показано ниже:For example, to remove a Centralized Logging Service configuration that you created to increase the log file rollover time, increase the rollover log file size, and set the log file cache location to a network share as follows:

Remove-CsClsConfiguration -Identity "site:Redmond"

Примечание

Это новую конфигурацию, которая была создана в процедуре «Создание новой конфигурации централизованная служба ведения журнала».This is the new configuration that was created in the procedure "To create a new Centralized Logging Service configuration."

Если удалить конфигурацию уровня сайта, сайт будет использовать глобальные параметры.If you choose to remove a site-level configuration, the site will use the global settings.

См. такжеSee also

Настройка поставщиков для службы централизованного ведения журналов в Скайп для Business Server 2015Configure providers for Centralized Logging Service in Skype for Business Server 2015

Настройка сценариев для централизованной службы ведения журналов в Скайп для Business Server 2015Configure scenarios for the Centralized Logging Service in Skype for Business Server 2015

Службы централизованного ведения журналов в Скайп для бизнеса 2015Centralized Logging Service in Skype for Business 2015

SET-CsClsConfigurationSet-CsClsConfiguration

Get-CsClsConfigurationGet-CsClsConfiguration

New-CsClsConfigurationNew-CsClsConfiguration

Remove-CsClsConfigurationRemove-CsClsConfiguration