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

Skype for Business Server 2015
 

Última modificación del tema:2016-12-20

Resumen: información sobre cómo crear, modificar y eliminar escenarios del Servicio de registro centralizado en Skype Empresarial Server 2015.

Los escenarios definen el ámbito (que puede ser global o de un sitio, un grupo o un equipo) y los proveedores que se utilizarán 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 de inicio de sesión, las herramientas de depuración de Skype Empresarial Server 2015 le proporcionan un módulo de Windows PowerShell llamado ClsScenarioEdit.psm1 que contiene la función Edit-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. Descargue el Skype Empresarial Server 2015Herramientas de depuración antes de ir más lejos.

importantImportante:
Para cualquiera de los ámbitos —global, de sitio, de grupo o de equipo—, puede ejecutar un máximo de dos escenarios al mismo tiempo. Para determinar qué escenarios están actualmente en ejecución, utilice Windows PowerShell y Get-CsClsScenario. Con Windows PowerShell y Set-CsClsScenario, puede cambiar de forma dinámica los escenarios que están en ejecución: puede modificar los escenarios que se ejecutan durante una sesión de registro; o bien, ajustar o restringir los datos que se recopilan y sus proveedores.

Para ejecutar las funciones del Servicio de registro centralizado con el Shell de administración de Skype Empresarial Server, es necesario que sea miembro de los grupos de seguridad de control de acceso basado en roles (RBAC) CsServerAdministrator o CsAdministrator, o bien de un rol RBAC personalizado que contenga alguno de estos dos grupos. Para obtener una lista de todos los roles RBAC a los que este cmdlet se asignó, incluidos los roles RBAC personalizados creados por usted, ejecute el siguiente comando desde el Shell de administración de Skype Empresarial Server o desde 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 emitir comandos de Windows PowerShell. Cuando usa Windows PowerShell, puede definir nuevos escenarios para usarlos en las sesiones de registro.

Como se comentó en Servicio de registro centralizado en Skype Empresarial 2015, un escenario consta de los elementos siguientes:

  • Proveedores Si está familiarizado con OCSLogger, los proveedores son los componentes que elige para notificarle a OCSLogger de dónde tiene que recopilar registros el motor de seguimiento. 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 desde los que el Servicio de registro centralizado puede recopilar registros. Para 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 define el ámbito y el nombre del escenario. Por ejemplo, puede establecer un ámbito "global" e identificar el escenario como "LyssServiceScenario". Cuando se combinan ambos, se define la identidad, que en este caso sería "global/LyssServiceScenario".

    Si lo desea, puede usar los parámetros –Name y –Parent. Si utiliza el parámetro Name, que únicamente sirve para identificar el escenario, también tendrá que usar el parámetro Parent para agregar el escenario de forma global o en el sitio.

    importantImportante:
    Si usa los parámetros Name y Parent, no puede usar el parámetro –Identity .

  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
    

    Formato alternativo en el que se usan –Name y –Parent:

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

  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, aunque la cantidad de proveedores no está limitada. Para este ejemplo, supongamos que ha creado tres proveedores y que desea asignarlos al escenario que está definiendo. Los nombres de la variable "provider" son LyssProvider, ABServerProvider y SIPStackProvider. Para definir y asignar varios proveedores a un escenario, escriba lo siguiente en el Shell de administración de Skype Empresarial Server o en un símbolo del sistema de Windows PowerShell:

    New-CsClsScenario -Identity "site:Redmond/CollectDataScenario" -Provider @{Add=$LyssProvider, $ABServerProvider,  $SIPStackProvider}
    
    noteNota:
    Al igual que en Windows PowerShell, la convención de crear una tabla hash de valores con @{ <variable> = <value1> , <value2> , <value> ...} se conoce como expansión . Para obtener más información acerca de splatting en Windows PowerShell, consulte https://go.microsoft.com/fwlink/p/?LinkId=267760.

  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 escenario nuevo, haga lo siguiente (suponiendo que se agregó un proveedor ya definido con el nombre "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}
    

  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.

  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 .

    importantImportante:
    El módulo CClsScenarioEdit.psm1 se proporciona como una descarga web aparte. Este módulo es 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 Windows PowerShell, escriba:

    Import-Module "CDBurn\OCO\amd64\Support"
    
    tipSugerencia:
    Si el módulo se carga correctamente, regresará de nuevo al símbolo del sistema de Windows PowerShell. Para confirmar que el módulo se cargó 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
    
    tipSugerencia:
    Si el módulo se descarga correctamente, regresará de nuevo al símbolo del sistema de Windows PowerShell. Para confirmar que el módulo se descargó, escriba Get-Help Edit-CsClsScenario. Windows PowerShell tratará de localizar la ayuda sobre el cmdlet y generará un error.

  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 Windows PowerShell, escriba:

    Import-Module "CDBurn\OCO\amd64\Support"
    
    tipSugerencia:
    Si el módulo se carga correctamente, regresará de nuevo al símbolo del sistema de Windows PowerShell. Para confirmar que el módulo se cargó 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 posicional de los valores de parámetro solo se aplica a –Scenario y –Provider. Es necesario definir explícitamente todos los demás parámetros.

  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 pueden ser cualquiera de las marcas que el proveedor admita, como TF_COMPONENT, TF_DIAG, o bien pueden contener el 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
    
 
Mostrar: