Configurar escenarios para el servicio de registro centralizado en Skype Empresarial Server 2015Configure scenarios for the Centralized Logging Service in Skype for Business Server 2015

Resumen: Aprenda a crear, modificar y quitar los escenarios para el servicio de registro centralizado en Skype para Business Server 2015.Summary: Learn how to create, modify, and remove scenarios for the Centralized Logging Service in Skype for Business Server 2015.

Escenarios de definen el ámbito (es decir, global, sitio, grupo o equipo) y qué proveedores para usar en el servicio de registro centralizado.Scenarios define the scope (that is, global, site, pool, or computer) and what providers to use in the Centralized Logging Service. Al usar escenarios, puede habilitar o deshabilitar el seguimiento de proveedores (por ejemplo, S4, SIPStack, mensajería instantánea y presencia).By using scenarios, you enable or disable tracing on providers (for example, S4, SIPStack, IM, and Presence). Al configurar un escenario, puede agrupar a todos los proveedores de una colección lógica determinada que aborda una condición para un problema concreto.By configuring a scenario, you can group all of the providers for a given logical collection that address a specific problem condition. Si encuentra que un escenario tiene que modificarse para satisfacer la solución de problemas y necesidades de registro, el Skype para las herramientas de depuración de Business Server 2015 proporciona un módulo de Windows PowerShell denominado ClsScenarioEdit.psm1 que contiene una función 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. La finalidad del módulo es editar las propiedades del escenario en cuestión.The purpose of the module is to edit the properties of the named scenario. En este tema se muestran ejemplos del funcionamiento de este módulo.Examples of how this module works are provided in this topic. Antes de ir más lejos, descargue el Skype para Business Server 2015 Herramientas de depuración .Download the Skype for Business Server 2015 Debugging Tools before going any further.

Importante

Para cualquier ese ámbito: global, sitio, grupo o equipo, puede ejecutar un máximo de dos escenarios en un momento dado.For any given scope—site, global, pool or computer—you can run a maximum of two scenarios at any given time. Para determinar qué escenarios se están ejecutando actualmente, utilice Windows PowerShell y Get-CsClsScenario.To determine which scenarios are currently running, use Windows PowerShell and Get-CsClsScenario. Mediante Windows PowerShell y el Conjunto CsClsScenario, puede cambiar dinámicamente qué escenarios se están ejecutando.By using Windows PowerShell and Set-CsClsScenario, you can dynamically change which scenarios are running. Puede modificar qué escenarios ejecutan durante una sesión de registro para ajustar o restringir los datos que está recopilando y desde qué proveedores.You can modify which scenarios are running during a logging session to adjust or refine the data you are collecting and from which providers.

Para ejecutar las funciones de servicio de registro centralizado mediante el Skype para negocios de Shell de administración de servidor, debe ser miembro de la CsAdministrator o los grupos de seguridad de CsServerAdministrator acceso basado en roles (RBAC) de control o una función personalizada de RBAC que contiene cualquiera de estos dos grupos.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. Para devolver una lista de todos lo RBAC funciones que este cmdlet se ha asignado, incluidos los roles RBAC personalizados que haya creado, ejecutan el siguiente comando desde el Skype para el Shell de administración de servidor de negocios o el símbolo del sistema de 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"}

Por ejemplo:For example:

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

El resto de este tema se centra en cómo definir un escenario, modificarlo, recuperar los escenarios en ejecución, quitar un escenario y especificar qué contiene un escenario a fin de optimizar la solución de problemas.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. Puede utilizar el Skype para el Shell de administración de servidor de empresa para emitir comandos de Windows PowerShell.You can use the Skype for Business Server Management Shell to issue Windows PowerShell commands. Cuando se utiliza Windows PowerShell, puede definir nuevos escenarios para su uso en las sesiones de registro.When you use Windows PowerShell, you can define new scenarios for use in your logging sessions.

Como se introdujo en el Servicio de registro centralizado en Skype para negocios 2015, los elementos de un escenario son:As introduced in Centralized Logging Service in Skype for Business 2015, the elements of a scenario are:

  • Proveedores Si está familiarizado con los OCSLogger, los proveedores son los componentes que elige decir a OCSLogger lo que el motor de seguimiento debe recopilar registros de.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. Los proveedores son los mismos componentes (y, muchas veces, con los mismos nombres) que los de OCSLogger.The providers are the same components, and in many cases have the same name as the components in OCSLogger. Si no está familiarizado con los OCSLogger, los proveedores son componentes específicos del rol de servidor que el servicio de registro centralizado puede recopilar registros de.If you are not familiar with OCSLogger, providers are server role specific components that the Centralized Logging Service can collect logs from. Para obtener más información acerca de la configuración de proveedores, vea Configurar proveedores de servicio de registro centralizado en Skype para Business Server 2015.For details about the configuration of providers, see Configure providers for Centralized Logging Service in Skype for Business Server 2015.

  • Identidad El parámetro-identidad establece el ámbito y el nombre del escenario.Identity The parameter -Identity sets the scope and name of the scenario. Por ejemplo, podría establecer un ámbito de "global" e identificar el escenario con "LyssServiceScenario".For example, you could set a scope of "global" and identify the scenario with "LyssServiceScenario". Al combinar los dos, se define la identidad (por ejemplo, "global/LyssServiceScenario").When you combine the two, you define the Identity (for example, "global/LyssServiceScenario").

    Opcionalmente, puede utilizar los parámetros - nombre y - primario.Optionally, you can use the -Name and -Parent parameters. Definir el parámetro Name para identificar de forma exclusiva el escenario.You define the Name parameter to uniquely identify the scenario. Si utiliza un nombre, debe utilizar también principal para agregar el escenario a uno global o de sitio.If you use Name, you must also use Parent to add the scenario to either global or site.

    Importante

    Si utiliza los parámetros Name y primario, no puede utilizar el -identidad parámetro.If you use the Name and Parent parameters, you cannot use the -Identity parameter.

Para crear un escenario con el cmdlet New-CsClsScenarioTo create a new scenario with the New-CsClsScenario cmdlet

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server.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. Para crear un nuevo escenario para una sesión de registro, utilice CsClsProvider de nuevo y defina el nombre del escenario (es decir, cómo se forma exclusiva identifica).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). Elija un tipo de formato de registro de WPP (es decir, el preprocesador de seguimiento del software de Windows; es el predeterminado), EventLog (el formato de registro de eventos de Windows) o IISLog (el archivo de formato ASCII basado en el formato de archivo de registro de 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). Luego, defina Level y Flags tal como se definen en este tema los niveles de registro y las marcas, respectivamente.Next, define Level (as the defined under Logging Levels in this topic), and Flags (as defined under Flags in this topic).

    Para este escenario de ejemplo, utilizaremos LyssProvider como variable de ejemplo del proveedor.For this example scenario, we use LyssProvider as the example provider variable.

    Para crear un escenario con las opciones especificadas, escriba:To create a scenario using the options defined, type:

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

    Por ejemplo:For example:

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

    El formato alternativo utilizando - nombre y - primaria:The alternate format using -Name and -Parent:

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

Para crear un escenario con varios proveedores por medio del cmdlet New-CsClsScenarioTo create a new scenario with multiple providers with the New-CsClsScenario cmdlet

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server.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. Por cada ámbito puede haber un máximo de dos escenarios.You are limited to two scenarios per scope. Sin embargo, no está limitado a un número de conjunto de proveedores.However, you are not limited to a set number of providers. En este ejemplo, supongamos que hemos creado tres proveedores, y que desea asignar los tres para el escenario que se está definiendo.In this example, assume that we have created three providers, and you want to assign all three to the scenario you are defining. Los nombres de variable de proveedor son LyssProvider, ABServerProvider y SIPStackProvider.The provider variable names are LyssProvider, ABServerProvider, and SIPStackProvider. Para definir y asignar a varios proveedores para un escenario, escriba lo siguiente en un Skype para símbolo del Shell de administración de servidor de negocios o de 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}
    

    Nota

    Como se conoce en Windows PowerShell, la convención para la creación de una tabla hash de valores mediante @{<variable>=<value1>, <value2>, <value>…} se conoce 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. Para obtener más información acerca de splatting en Windows PowerShell, consulte https://go.microsoft.com/fwlink/p/?LinkId=267760.For details about splatting in Windows PowerShell, see https://go.microsoft.com/fwlink/p/?LinkId=267760.

Para modificar un escenario existente con el cmdlet Set-CsClsScenarioTo modify an existing scenario with the Set-CsClsScenario cmdlet

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server.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. Por cada ámbito puede haber un máximo de dos escenarios.You are limited to two scenarios per scope. Puede cambiar los escenarios que estén en ejecución en cualquier momento, incluso si hay una sesión de captura de registros en proceso.You can change which scenarios are running at any time, even when a logging capture session is in process. Si redefine los escenarios que están en ejecución, la sesión de registro actual dejará de usar el escenario que se haya quitado y empezará a usar el escenario nuevo.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. Pero, la información de registro que se capturó con el escenario quitado se mantendrá en los registros capturados.However, the logging information that was captured with the removed scenario remains in the captured logs. Para definir un escenario nuevo, realice lo siguiente (que es, suponiendo que la adición de un proveedor ya definido, denominado "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>}
    

    Por ejemplo:For example:

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

    Si desea reemplazar los proveedores, defina un único proveedor o bien una lista de proveedores separados entre sí por comas para cambiar el conjunto actual. Si solo desea reemplazar uno de los proveedores, agregue los proveedores actuales a los nuevos para crear un conjunto de proveedores distinto que contenga tanto los proveedores existentes como los nuevos. Para reemplazar todos los proveedores con un conjunto nuevo, escriba lo siguiente: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>}
    

    Por ejemplo, para reemplazar el conjunto actual de $LyssProvider, $ABServerProvider y $SIPStackProvider con $LyssServiceProvider:For example, to replace the current set of $LyssProvider, $ABServerProvider, and $SIPStackProvider with $LyssServiceProvider:

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

    Para reemplazar solo el proveedor $LyssProvider del conjunto actual de $LyssProvider, $ABServerProvider y $SIPStackProvider con $LyssServiceProvider, escriba lo siguiente: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}
    

Para quitar un escenario existente con el cmdlet Remove-CsClsScenarioTo remove an existing scenario with the Remove-CsClsScenario cmdlet

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server.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. Si desea quitar un escenario que se definió previamente, escriba lo siguiente:If you want to remove a scenario that has been previously defined, type the following:

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

    Por ejemplo, para quitar el escenario definido site:Redmond/LyssServiceScenario:For example, to remove the defined scenario site:Redmond/LyssServiceScenario:

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

El cmdlet Remove-CsClsScenario quita el escenario especificado, pero los seguimientos que se han capturado todavía están disponibles en los registros para buscar en.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.

Para cargar y descargar el cmdlet Edit-CsClsScenario con el módulo ClsScenarioEdit.psm1To load and unload the Edit-CsClsScenario cmdlet using the ClsScenarioEdit.psm1 module

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server.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.

    Importante

    El módulo CClsScenarioEdit.psm1 se proporciona como una descarga web aparte.The ClsScenarioEdit.psm1 module is provided as a separate Web download. El módulo es parte de la Skype para las herramientas de depuración de Business Server 2015.The module is part of the Skype for Business Server 2015 Debugging tools. De forma predeterminada, las herramientas de depuración se instalan en el directorio C:\Archivos de programa\Skype Empresarial Server 2015\Herramientas de depuración.By default, the debugging tools are installed in the directory C:\Program Files\Skype for Business Server 2015\Debugging Tools.

  2. Desde el Windows PowerShell, escriba:From the Windows PowerShell, type:

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

    Sugerencia

    Carga correcta del módulo vuelve al símbolo del sistema de Windows PowerShell.Successful loading of the module returns you to the Windows PowerShell command prompt. Para confirmar que el módulo se carga y que CsClsScenario de edición está disponible, escriba Get-Help Edit-CsClsScenario.To confirm that the module is loaded and that Edit-CsClsScenario is available, type Get-Help Edit-CsClsScenario. Tendría que ver una muestra general de la sintaxis de EditCsClsScenario.You should see the basic synopsis of the syntax for EditCsClsScenario.

  3. Para descargar los módulos, escriba:To unload the modules, type:

    Remove-Module ClsController
    

    Sugerencia

    Correcta descarga de devoluciones módulo usted a la línea de comandos de Windows PowerShell.Successful unloading of the module returns you to the Windows PowerShell command prompt. Para confirmar que el módulo se descarga, escriba Get-Help Edit-CsClsScenario.To confirm that the module is unloaded, type Get-Help Edit-CsClsScenario. Windows PowerShell intentará buscar la ayuda para el cmdlet y producirá un error.Windows PowerShell will attempt to locate the help for the cmdlet and fail.

Para quitar un proveedor existente de un escenario con el módulo Edit-ClsControllerTo remove an existing provider from a scenario with the Edit-ClsController module

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server.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. Desde el Windows PowerShell, escriba:From the Windows PowerShell, type:

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

    Sugerencia

    Carga correcta del módulo vuelve al símbolo del sistema de Windows PowerShell.Successful loading of the module returns you to the Windows PowerShell command prompt. Para confirmar que el módulo se carga y que CsClsScenario de edición está disponible, escriba Get-Help Edit-CsClsScenario.To confirm that the module is loaded and that Edit-CsClsScenario is available, type Get-Help Edit-CsClsScenario. Tendría que ver una muestra general de la sintaxis de EditCsClsScenario.You should see the basic synopsis of the syntax for EditCsClsScenario.

  3. Para quitar un proveedor del escenario AlwaysOn, escriba: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
    

    Por ejemplo:For Example:

    Edit-CsClsScenario -ScenarioName AlwaysOn -ProviderName ChatServer -Remove
    

    ScenarioName y ProviderName son parámetros de posición (es decir, es necesario que se definan en una posición determinada en la línea de comandos). El nombre de los parámetros no tiene que definirse explícitamente si el nombre del escenario ocupa el segundo lugar y el proveedor ocupa el tercero tomando como referencia el nombre del cmdlet, que aparece en primer lugar. Teniendo en cuenta esta información, el comando anterior quedaría así: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
    

    La colocación posicional de los valores de parámetro sólo aplica a - escenario y - proveedor.The positional placing of the parameter values applies only to -Scenario and -Provider. Es necesario definir explícitamente todos los demás parámetros.All other parameters must be explicitly defined.

Para agregar un proveedor a un escenario con el módulo Edit-ClsControllerTo add a provider to a scenario with the Edit-ClsController module

  1. Inicie el Shell de administración de Skype Empresarial Server: haga clic en Inicio, Todos los programas, Skype Empresarial Server 2015 y, después, en Shell de administración de Skype Empresarial Server.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. Para agregar un proveedor al escenario AlwaysOn, escriba: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>
    

    Por ejemplo:For Example:

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

    Loglevel - pueden ser de tipo Error grave, Error, advertencia, información, Verbose, depuración o todos.-Loglevel can be of the type Fatal, Error, Warning, Info, Verbose, Debug, or All. -Flags pueden ser cualquiera de los indicadores que admite el proveedor, como TF_COMPONENT, TF_DIAG.-Flags can be any of the flags that the provider supports, such as TF_COMPONENT, TF_DIAG. -Flags también pueden ser de valor todos-Flags can also be of value ALL

    El ejemplo anterior también se puede introducir usando la característica de colocación posicional del cmdlet. Por ejemplo, para agregar el proveedor ChatServer al escenario AlwaysOn, escriba: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