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

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

Сценарии определить область (то есть, глобальная, на уровне сайта, пул или компьютер) и какие поставщиков для использования в службы централизованного ведения журналов.Scenarios define the scope (that is, global, site, pool, or computer) and what providers to use in the Centralized Logging Service. С помощью сценариев, включение или отключение трассировки на поставщиков (например, S4, SIPStack, обмен мгновенными Сообщениями и присутствия).By using scenarios, you enable or disable tracing on providers (for example, S4, SIPStack, IM, and Presence). Настроив сценарий, можно сгруппировать всех поставщиков для данного семейства сайтов логической этот адрес условие определенные проблемы.By configuring a scenario, you can group all of the providers for a given logical collection that address a specific problem condition. Если сценарий необходимо изменить в соответствии с диагностики и ведение журналов потребности, Скайп для средств отладки 2015 Business Server предоставляет модулем Windows PowerShell с именем ClsScenarioEdit.psm1, содержащий функции namedEdit-CsClsScenario.If you find that a scenario needs to be modified to meet your troubleshooting and logging needs, the Skype for Business Server 2015 Debug Tools provides you a Windows PowerShell module named ClsScenarioEdit.psm1 that contains a function namedEdit-CsClsScenario. Модуль предназначен для изменения свойств именованные сценария.The purpose of the module is to edit the properties of the named scenario. В этом разделе приведены примеры того, как работает этот модуль.Examples of how this module works are provided in this topic. Загрузите Скайп Business Server 2015 Средства отладки , прежде чем перейти к следующему шагу.Download the Skype for Business Server 2015 Debugging Tools before going any further.

Важно!

Для любой области действия (глобальной, области узла, пула и компьютера) одновременно можно использовать не больше двух сценариев.For any given scope—site, global, pool or computer—you can run a maximum of two scenarios at any given time. Чтобы определить, какие сценарии выполняются в настоящее время, используйте Windows PowerShell и Get-CsClsScenario.To determine which scenarios are currently running, use Windows PowerShell and Get-CsClsScenario. С помощью Windows PowerShell и Set-CsClsScenario, можно динамически изменять, какие сценарии выполняются.By using Windows PowerShell and Set-CsClsScenario, you can dynamically change which scenarios are running. Это можно сделать во время сеанса ведения журнала, чтобы скорректировать собираемые данные и поставщиков, от которых они собираются.You can modify which scenarios are running during a logging session to adjust or refine the data you are collecting and from which providers.

Для запуска функции централизованной службы ведения журналов с помощью Скайп для консоли Business Server, должна быть членом CsAdministrator или групп безопасности CsServerAdministrator доступом на основе ролей (RBAC) элемента управления или настраиваемые роли RBAC, содержит любой из этих двух групп.To run the Centralized Logging Service functions 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 Server 2015 cmdlet"}

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

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

В оставшейся части этого раздела рассказывается о определить сценарий, изменить сценарий, получать выполнение сценариев, удалить сценарий и указать, содержащий сценарий для оптимизации диагностики.The remainder of this topic focuses on how to define a scenario, modify a scenario, retrieve what scenarios are running, remove a scenario, and specify what a scenario contains to optimize your troubleshooting. Скайп для консоли Business Server можно использовать для выполнения команд Windows PowerShell.You can use the Skype for Business Server Management Shell to issue Windows PowerShell commands. При использовании Windows PowerShell можно определить новые сценарии для использования в вашей сеансы ведения журналов.When you use Windows PowerShell, you can define new scenarios for use in your logging sessions.

Как было описано в Централизованной службы ведения журналов в Скайп для бизнеса 2015, являются элементы сценария:As introduced in Centralized Logging Service in Skype for Business 2015, the elements of a scenario are:

  • Поставщики Если вы знакомы с OCSLogger, поставщики — это компоненты, чтобы сообщить OCSLogger обработчик трассировки следует собирать данные для выбора.Providers If you are familiar with OCSLogger, providers are the components that you choose to tell OCSLogger what the tracing engine should collect logs from. Поставщики — это те же компоненты, а во многих случаях их имя совпадает с компонентами в OCSLogger.The providers are the same components, and in many cases have the same name as the components in OCSLogger. Если вы не знакомы с OCSLogger, поставщиков, определенным компонентам ролей сервера, что службы централизованного ведения журналов можно собирать входит в систему.If you are not familiar with OCSLogger, providers are server role specific components that the Centralized Logging Service can collect logs from. Для получения дополнительных сведений о конфигурации поставщиков видеть Настройка поставщиков для централизованной службы ведения журналов в Скайп для Business Server 2015.For details about the configuration of providers, see Configure providers for Centralized Logging Service in Skype for Business Server 2015.

  • Удостоверение Параметр-Identity задает имя сценария и область применения.Identity The parameter -Identity sets the scope and name of the scenario. Например может задать область «глобальные» и определите сценария с «LyssServiceScenario».For example, you could set a scope of "global" and identify the scenario with "LyssServiceScenario". При объединении двух можно определить идентификатор (например, «глобальные/LyssServiceScenario»).When you combine the two, you define the Identity (for example, "global/LyssServiceScenario").

    Кроме того, можно использовать параметры - Name и - Parent.Optionally, you can use the -Name and -Parent parameters. Параметр Name задается для уникальной идентификации сценария.You define the Name parameter to uniquely identify the scenario. Если используется параметр Name, необходимо также использовать параметр Parent, чтобы добавить сценарий в глобальную область или область узла.If you use Name, you must also use Parent to add the scenario to either global or site.

    Важно!

    Если вы используете параметры Name и Parent, нельзя использовать -Identity параметр.If you use the Name and Parent parameters, you cannot use the -Identity parameter.

Создание сценария с помощью командлета New-CsClsScenarioTo create a new scenario with the New-CsClsScenario cmdlet

  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. Чтобы создать новый сценарий для сеанса ведения журнала, используйте New-CsClsProvider и определите имя сценария (то есть, как оно будет уникальным образом идентифицироваться).To create a new scenario for a logging session, use New-CsClsProvider and define the name of the scenario (that is, how it will be uniquely identified). Выберите тип формата ведения журнала из WPP (то есть, трассировка препроцессору программного обеспечения Windows и используется по умолчанию), журнал событий (то есть, формат журнала событий Windows) или IISLog (то есть, файл в формате ASCII на основе формат файла журнала IIS).Choose a type of logging format from WPP (that is, Windows software tracing preprocessor and is the default), EventLog (that is, Windows event log format), or IISLog (that is, ASCII format file based on the IIS log file format). Затем определите уровень (как определено в разделе уровни ведения журнала в данном разделе) и флаги (как определено в разделе флаги в данном разделе).Next, define Level (as the defined under Logging Levels in this topic), and Flags (as defined under Flags in this topic).

    Для этого примера сценария мы используем LyssProvider как пример переменной поставщика.For this example scenario, we use LyssProvider as the example provider variable.

    Чтобы создать сценарий с помощью заданных параметров, введите следующую команду:To create a scenario using the options defined, type:

    New-CsClsScenario -Identity <scope>/<unique scenario name> -Provider <provider variable>
    

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

    New-CsClsScenario -Identity "site:Redmond/LyssServiceScenario" -Provider $LyssProvider
    

    Альтернативный формат с помощью - Name и - Parent:The alternate format using -Name and -Parent:

    New-CsClsScenario -Name "LyssServiceScenario" -Parent "site:Redmond" -Provider $LyssProvider
    

Создание сценария с несколькими поставщиками с помощью командлета New-CsClsScenarioTo create a new scenario with multiple providers with the New-CsClsScenario cmdlet

  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. Можно использовать не больше двух сценариев для области действия.You are limited to two scenarios per scope. Тем не менее вы не ограничиваются заданное количество поставщиков.However, you are not limited to a set number of providers. В этом примере предполагается, что мы создали три поставщика и необходимо назначить все три для сценария, который вы определяете.In this example, assume that we have created three providers, and you want to assign all three to the scenario you are defining. Имена переменных поставщика, LyssProvider, ABServerProvider и SIPStackProvider.The provider variable names are LyssProvider, ABServerProvider, and SIPStackProvider. Для определения и назначения нескольких поставщиков в сценарий, введите в Скайп для консоли Business Server и Windows PowerShell командной строке следующую команду:To define and assign multiple providers to a scenario, type the following at a Skype for Business Server Management Shell or Windows PowerShell command prompt:

    New-CsClsScenario -Identity "site:Redmond/CollectDataScenario" -Provider @{Add=$LyssProvider, $ABServerProvider,  $SIPStackProvider}
    

    Примечание

    Как записано в Windows PowerShell, соглашение о создании хэш-таблицы с помощью значений @{<variable>=<value1>, <value2>, <value>…} известно assplatting.As it is known in Windows PowerShell, the convention for creating a hash table of values using @{<variable>=<value1>, <value2>, <value>…} is known assplatting. Сведения о сплаттинг в Windows PowerShell, в разделе https://go.microsoft.com/fwlink/p/?LinkId=267760.For details about splatting in Windows PowerShell, see https://go.microsoft.com/fwlink/p/?LinkId=267760.

Изменение существующего сценария с помощью командлета Set-CsClsScenarioTo modify an existing scenario with the Set-CsClsScenario cmdlet

  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. Можно использовать не больше двух сценариев для области действия.You are limited to two scenarios per scope. Вы можете изменить выполняемые сценарии в любое время даже во время сеанса ведения журналов.You can change which scenarios are running at any time, even when a logging capture session is in process. Если переопределить выполняемые сценарии, текущий сеанс перестанет использовать удаленный сценарий и начнет применять новый сценарий.If you redefine the running scenarios, the current logging session will stop using the scenario that was removed and then begin using the new scenario. Однако данные ведения журналов, полученные с помощью удаленного сценария, останутся в полученных журналах.However, the logging information that was captured with the removed scenario remains in the captured logs. Чтобы определить новый сценарий, выполните следующие действия (который Если также уже определенного поставщика, с именем «S4Provider»):To define a new scenario, do the following (that is, assuming the addition of an already defined provider named "S4Provider"):

    Set-CsClsScenario -Identity <name of scope and scenario defined by New-CsClsScenario> -Provider @{Add=<new provider to add>}
    

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

    Set-CsClsScenario -Identity "site:Redmond/LyssServiceScenario" -Provider @{Add=$S4Provider}
    

    Если вы хотите заменить поставщики, определить один поставщика или разделенный запятыми список поставщиков, чтобы заменить текущий набор. Если вы хотите только заменить один из нескольких поставщиков, добавьте текущие поставщики с новыми поставщиками, чтобы создать новый набор поставщиков, который содержит новые и существующие поставщики. Чтобы заменить все поставщики новым набором, введите следующую команду:If you want to replace providers, define a single provider or a comma separated list of providers to replace the current set. If you only want to replace one of many providers, add the current providers with the new providers to create a new set of providers that contains both new providers and existing providers. To replace all providers with a new set, type the following:

    Set-CsClsScenario -Identity <name of scope and scenario defined by New-CsClsScenario> -Provider @{Replace=<providers to replace existing provider set>}
    

    Например, чтобы заменить текущий набор из $LyssProvider, $ABServerProvider и $SIPStackProvider на $LyssServiceProvider, выполните следующую команду:For example, to replace the current set of $LyssProvider, $ABServerProvider, and $SIPStackProvider with $LyssServiceProvider:

    Set-CsClsScenario -Identity "site:Redmond/LyssServiceScenario" -Provider @{Replace=$LyssServiceProvider}
    

    Чтобы заменить только поставщик $LyssProvider из текущего набора $LyssProvider, $ABServerProvider и $SIPStackProvider на $LyssServiceProvider, введите следующую команду:To replace just the $LyssProvider provider from the current set of $LyssProvider, $ABServerProvider, and $SIPStackProvider with $LyssServiceProvider, type the following:

    Set-CsClsScenario -Identity "site:Redmond/LyssServiceScenario" -Provider @{Replace=$LyssServiceProvider, $ABServerProvider, $SIPStackProvider}
    

Удаление существующего сценария с помощью командлета Remove-CsClsScenarioTo remove an existing scenario with the Remove-CsClsScenario cmdlet

  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. Если вы хотите удалить сценарий, определенный ранее, введите следующую команду:If you want to remove a scenario that has been previously defined, type the following:

    Remove-CsClsScenario -Identity <name of scope and scenario>
    

    Например, чтобы удалить заданный сценарий site:Redmond/LyssServiceScenario:For example, to remove the defined scenario site:Redmond/LyssServiceScenario:

    Remove-CsClsScenario -Identity "site:Redmond/LyssServiceScenario"
    

Командлет Remove-CsClsScenario Удаляет указанный сценарий, но трассировки, которые были записаны, по-прежнему доступны в журналах для поиска по.The Remove-CsClsScenario cmdlet removes the specified scenario, but the traces that have been captured are still available in the logs for you to search on.

Загрузка и выгрузка командлета Edit-CsClsScenario с помощью модуля ClsScenarioEdit.psm1To load and unload the Edit-CsClsScenario cmdlet using the ClsScenarioEdit.psm1 module

  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.

    Важно!

    Модуль ClsScenarioEdit.psm1 предоставляется как отдельная веб-загрузка.The ClsScenarioEdit.psm1 module is provided as a separate Web download. Модуль является частью Скайп для средства отладки 2015 Business Server.The module is part of the Skype for Business Server 2015 Debugging tools. По умолчанию средства отладки устанавливаются в каталог C:\Program Files\Skype for Business Server 2015\Debugging Tools.By default, the debugging tools are installed in the directory C:\Program Files\Skype for Business Server 2015\Debugging Tools.

  2. В Windows PowerShell введите команду:From the Windows PowerShell, type:

    Import-Module "CDBurn\OCO\amd64\Support"
    

    Совет

    Успешные загрузки модуля, вы вернетесь в командной строке Windows PowerShell.Successful loading of the module returns you to the Windows PowerShell command prompt. Чтобы убедиться, что модуль загружен и доступен Edit-CsClsScenario, введите Get-Help Edit-CsClsScenario.To confirm that the module is loaded and that Edit-CsClsScenario is available, type Get-Help Edit-CsClsScenario. Вы должны увидеть базовые сведения о синтаксисе использования EditCsClsScenario.You should see the basic synopsis of the syntax for EditCsClsScenario.

  3. Чтобы выгрузить модули, введите:To unload the modules, type:

    Remove-Module ClsController
    

    Совет

    Успешные выгрузку возвращает модуль вы в командной строке Windows PowerShell.Successful unloading of the module returns you to the Windows PowerShell command prompt. Чтобы убедиться в том, что модуль выгрузки, введите Get-Help Edit-CsClsScenario.To confirm that the module is unloaded, type Get-Help Edit-CsClsScenario. Windows PowerShell попытается найти справку по командлету и с ошибкой.Windows PowerShell will attempt to locate the help for the cmdlet and fail.

Удаление существующего поставщика из сценария с помощью командлета Edit-ClsControllerTo remove an existing provider from a scenario with the Edit-ClsController module

  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. В Windows PowerShell введите команду:From the Windows PowerShell, type:

    Import-Module "CDBurn\OCO\amd64\Support"
    

    Совет

    Успешные загрузки модуля, вы вернетесь в командной строке Windows PowerShell.Successful loading of the module returns you to the Windows PowerShell command prompt. Чтобы убедиться, что модуль загружен и доступен Edit-CsClsScenario, введите Get-Help Edit-CsClsScenario.To confirm that the module is loaded and that Edit-CsClsScenario is available, type Get-Help Edit-CsClsScenario. Вы должны увидеть базовые сведения о синтаксисе использования EditCsClsScenario.You should see the basic synopsis of the syntax for EditCsClsScenario.

  3. Чтобы удалить поставщика из сценария AlwaysOn, введите:To remove a provider from the AlwaysOn scenario, type:

    Edit-CsClsScenario -ScenarioName <string of the scenario to edit> -ProviderName <string of the provider to remove> -Remove
    

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

    Edit-CsClsScenario -ScenarioName AlwaysOn -ProviderName ChatServer -Remove
    

    Параметры ScenarioName и ProviderName являются позиционными (т. е. их необходимо задать в ожидаемой позиции в командной строке). Имя параметра необязательно явно определять, если имя сценария находится во второй позиции, а поставщик — в третьей позиции относительно первой позиции имени командлета. Используя эту информацию, предыдущая команда вводится следующим образом:The parameters ScenarioName and ProviderName are positional (that is, they must be defined in the expected position in the command line) parameters. The parameter name does not have to be explicitly defined if the scenario name is in position two and the provider is in position three, relative to the name of the cmdlet as position one. Using this information, the previous command would be typed as:

    Edit-CsClsScenario AlwaysOn ChatServer -Remove
    

    Позиционные размещение значений параметров применяется только к - сценарий и - поставщиком.The positional placing of the parameter values applies only to -Scenario and -Provider. Все другие параметры нужно определить явно.All other parameters must be explicitly defined.

Добавление поставщика в сценарий с помощью командлета Edit-ClsControllerTo add a provider to a scenario with the Edit-ClsController module

  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. Чтобы добавить поставщик в сценарий AlwaysOn, введите:To add a provider to the AlwaysOn scenario, type:

    Edit-CsClsScenario -ScenarioName <string of the scenario to edit> -ProviderName <string of the provider to add> -Level <string of type level> -Flags <string of type flags>
    

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

    Edit-CsClsScenario -ScenarioName AlwaysOn -ProviderName ChatServer -Level Info -Flags TF_COMPONENT
    

    Значением -Loglevel может быть Fatal, Error, Warning, Info, Verbose, Debug или All.-Loglevel can be of the type Fatal, Error, Warning, Info, Verbose, Debug, or All. -Флаги может быть любой из флаги, поставщик поддерживает, такие как TF_COMPONENT, TF_DIAG.-Flags can be any of the flags that the provider supports, such as TF_COMPONENT, TF_DIAG. -Флаги может быть также все значения-Flags can also be of value ALL

    Предыдущий пример также можно ввести, используя позиционность командлета. Например, чтобы добавить поставщик ChatServer в сценарий AlwaysOn, введите:The previous example can also be typed using the positional feature of the cmdlet. For example, to add the provider ChatServer to the AlwaysOn scenario, type:

    Edit-CsClsScenario AlwaysOn ChatServer -Level Info -Flags ALL