Configurar escenarios para el servicio de registro centralizado en Skype Empresarial Server 2015

Resumen: Obtenga información sobre cómo crear, modificar y quitar escenarios para el servicio de registro centralizado en Skype Empresarial Server 2015.

Los escenarios definen el ámbito (es decir, global, sitio, grupo o equipo) y qué proveedores usar en el servicio de registro centralizado. Al usar escenarios, puede habilitar o deshabilitar el seguimiento de proveedores (por ejemplo, S4, SIPStack, mensajería instantánea y presencia). 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. Si cree que es necesario modificar un escenario para satisfacer sus necesidades de solución de problemas y registro, las herramientas de depuración de Skype Empresarial Server 2015 proporcionan un módulo de Windows PowerShell denominado ClsScenarioEdit.psm1 que contiene una función denominadaEdit-CsClsScenario. La finalidad del módulo es editar las propiedades del escenario en cuestión. En este tema se muestran ejemplos del funcionamiento de este módulo. Descarga las herramientas de depuración de Skype Empresarial Server 2015 antes de ir más allá.

Importante

Para cualquier ámbito determinado (sitio, global, grupo o equipo), puede ejecutar un máximo de dos escenarios en un momento dado. Para determinar qué escenarios se están ejecutando actualmente, use Windows PowerShell y Get-CsClsScenario. Al usar Windows PowerShell y Set-CsClsScenario, puede cambiar dinámicamente qué escenarios se están ejecutando. Puede modificar los escenarios que se ejecutan durante una sesión de registro para ajustar o refinar los datos que recopila y de qué proveedores.

Para ejecutar las funciones del servicio de registro centralizado mediante el Shell de administración de Skype Empresarial Server, debe ser miembro de los grupos de seguridad de control de acceso basado en roles (RBAC) de CsAdministrator o CsServerAdministrator, o bien un rol RBAC personalizado que contenga cualquiera de estos dos grupos. Para devolver una lista de todos los roles RBAC a los que se ha asignado este cmdlet, incluidos los roles RBAC personalizados que haya creado usted mismo, ejecute el siguiente comando desde el Shell de administración de Skype Empresarial Server o el símbolo del sistema de Windows PowerShell:

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

Por ejemplo:

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. Puede usar el Shell de administración de Skype Empresarial Server para ejecutar comandos de Windows PowerShell. Al usar Windows PowerShell, puede definir nuevos escenarios para su uso en las sesiones de registro.

Como se introdujo en el servicio de registro centralizado en Skype Empresarial 2015, los elementos de un escenario son:

  • Proveedores Si está familiarizado con OCSLogger, los proveedores son los componentes que usted decide decirle a OCSLogger de qué el motor de seguimiento debe recopilar los registros de. Los proveedores son los mismos componentes y en muchos casos tienen los mismos nombres que los componentes de OCSLogger. Si no está familiarizado con OCSLogger, los proveedores son componentes específicos del rol de servidor de los que el servicio de registro centralizado puede recopilar registros. Para obtener más información sobre la configuración de los proveedores, consulte Configurar proveedores para el servicio de registro centralizado en Skype Empresarial Server 2015.

  • Identidad El parámetro -Identity establece el ámbito y el nombre del escenario. Por ejemplo, podría establecer un ámbito de "global" e identificar el escenario con "LyssServiceScenario". Al combinar los dos, define la identidad (por ejemplo, "global/LyssServiceScenario").

    Opcionalmente, puede usar los parámetros -Name y -Parent. Defina el parámetro Name para identificar el escenario de forma única. Si usa Name, también debe usar Parent para agregar el escenario a global o sitio.

    Importante

    Si utiliza los parámetros Name y Parent, no puede usar el parámetro -Identity .

Para crear un escenario con el cmdlet New-CsClsScenario

  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.

  2. Para crear un escenario para una sesión de registro, utilice New-CsClsProvider y defina el nombre del escenario (es decir, un nombre de identificación único). 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). Luego, defina Level y Flags tal como se definen en este tema los niveles de registro y las marcas, respectivamente.

    Para este escenario de ejemplo, utilizaremos LyssProvider como variable de ejemplo del proveedor.

    Para crear un escenario con las opciones especificadas, escriba:

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

    Por ejemplo:

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

    El formato alternativo con -Name y -Parent:

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

Para crear un escenario con varios proveedores por medio del cmdlet New-CsClsScenario

  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.

  2. Por cada ámbito puede haber un máximo de dos escenarios. Sin embargo, no está limitado a un número establecido de proveedores. En este ejemplo, supongamos que hemos creado tres proveedores y desea asignar los tres al escenario que está definiendo. Los nombres de variables de proveedor son LyssProvider, ABServerProvider y SIPStackProvider. Para definir y asignar varios proveedores a un escenario, escriba lo siguiente en un Shell de administración de Skype Empresarial Server o Windows PowerShell símbolo del sistema:

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

    Nota

    Como se conoce en Windows PowerShell, la convención para crear una tabla hash de valores con el uso @{<variable>=<value1>, <value2>, <value>...} se conoce comoplatting. Para obtener más información sobre cómo sobresaltar en Windows PowerShell, consulte https://go.microsoft.com/fwlink/p/?LinkId=267760.

Para modificar un escenario existente con el cmdlet Set-CsClsScenario

  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.

  2. Por cada ámbito puede haber un máximo de dos escenarios. 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. 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. Pero, la información de registro que se capturó con el escenario quitado se mantendrá en los registros capturados. Para definir un nuevo escenario, haga lo siguiente (es decir, suponiendo que se agrega un proveedor ya definido denominado "S4Provider"):

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

    Por ejemplo:

    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:

    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:

    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:

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

Para quitar un escenario existente con el cmdlet Remove-CsClsScenario

  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.

  2. Si desea quitar un escenario que se definió previamente, escriba lo siguiente:

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

    Por ejemplo, para quitar el escenario definido site:Redmond/LyssServiceScenario:

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

El cmdlet Remove-CsClsScenario quita el escenario especificado, pero los datos de seguimiento que se hayan capturado seguirán disponibles en los registros para su consulta.

Para cargar y descargar el cmdlet Edit-CsClsScenario con el módulo ClsScenarioEdit.psm1

  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.

    Importante

    El módulo CClsScenarioEdit.psm1 se proporciona como una descarga web aparte. El módulo forma parte de las herramientas de depuración de Skype Empresarial Server 2015. 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.

  2. En la Windows PowerShell, escriba:

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

    Propina

    La carga correcta del módulo vuelve a la Windows PowerShell símbolo del sistema. Para confirmar que el módulo está cargado y que Edit-CsClsScenario está disponible, escriba Get-Help Edit-CsClsScenario. Tendría que ver una muestra general de la sintaxis de EditCsClsScenario.

  3. Para descargar los módulos, escriba:

    Remove-Module ClsController
    

    Propina

    La descarga correcta del módulo le devuelve al símbolo del sistema Windows PowerShell. Para confirmar que el módulo está descargado, escriba Get-Help Edit-CsClsScenario. Windows PowerShell intentará encontrar la ayuda para el cmdlet y producirá un error.

Para quitar un proveedor existente de un escenario con el módulo Edit-ClsController

  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.

  2. En la Windows PowerShell, escriba:

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

    Propina

    La carga correcta del módulo vuelve a la Windows PowerShell símbolo del sistema. Para confirmar que el módulo está cargado y que Edit-CsClsScenario está disponible, escriba Get-Help Edit-CsClsScenario. Tendría que ver una muestra general de la sintaxis de EditCsClsScenario.

  3. Para quitar un proveedor del escenario AlwaysOn, escriba:

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

    Por ejemplo:

    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í:

    Edit-CsClsScenario AlwaysOn ChatServer -Remove
    

    La colocación posicionacional de los valores de parámetro solo se aplica a -Scenario y -Provider. Es necesario definir explícitamente todos los demás parámetros.

Para agregar un proveedor a un escenario con el módulo Edit-ClsController

  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.

  2. Para agregar un proveedor al escenario AlwaysOn, escriba:

    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:

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

    -Loglevel puede ser del tipo Fatal, Error, Warning, Info, Verbose, Debug o All. -Flags puede ser cualquiera de las marcas que admite el proveedor, como TF_COMPONENT, TF_DIAG. -Flags también puede ser de valor 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:

    Edit-CsClsScenario AlwaysOn ChatServer -Level Info -Flags ALL