Compartir a través de

  • Artículo

Set-CsDiagnosticConfiguration

 

Última modificación del tema: 2012-03-26

Modifica las opciones de configuración de diagnóstico existentes. Las opciones de configuración de diagnóstico se usan para determinar si el tráfico de un dominio o Identificador Uniforme de Recursos (URI) determinado se registra en los archivos de registro de Microsoft Lync Server 2010.

Sintaxis

Set-CsDiagnosticConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsDiagnosticConfiguration [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Si habilita el registro de Lync Server 2010, el tráfico de cualquier dominio o URI se incluirá en los archivos de registro de manera predeterminada. De este modo se garantiza que la información se guarda en los archivos de registro.

Sin embargo, a veces es demasiada información. Por ejemplo, si un dominio específico tiene problemas de conectividad, puede ser recomendable limitar el registro del tráfico entre la red y dicho dominio. De este modo, podrá identificar con facilidad la información registrada relevante para diagnosticar y solucionar el problema.

Las opciones de configuración de diagnóstico permiten especificar los dominios o URI que se registrarán en los archivos de registro. Lync Server permite crear opciones de configuración de diagnóstico en el ámbito del sitio. De este modo, lo habilitará para aplicar filtrados diferentes al sitio Redmond y no al resto de sitios.

Además podrá usar el cmdlet Set-CsDiagnosticConfiguration para agregar o quitar filtros de una recopilación determinada. Los filtros se usan para indicar los dominios en los que se debe registrar el tráfico.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Set-CsDiagnosticConfiguration en forma local: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único para las opciones de configuración de diagnóstico que deben modificarse. Para modificar configuraciones definidas en el ámbito de sitio, use una sintaxis similar a ésta: -Identity "site:Redmond". Para modificar la configuración global, use esta sintaxis: -Identity global.

Si este parámetro no está especificado, Set-CsDiagnosticConfiguration modificará automáticamente las configuraciones globales.

Instance

Opcional

Objeto DiagnosticFilterSettings

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

Filter

Opcional

Modificador de lista PS

Colección de dominios y URI en los que se debe registrar el tráfico. La propiedad Filter se compone de tres elementos separados y se debe crear mediante el cmdlet New-CsDiagnosticsFilter:

Fqdn: recopilación de dominios que se incluirán en el filtro. (técnicamente, es la sección host de una dirección SIP.) Por ejemplo, un nombre de dominio completo (FQDN) se podría ver de la siguiente manera: fabrikam.com. También puede usar caracteres comodín para representar varios dominios: *.fabrikam.com. Puede incluir más de un dominio en un solo filtro.

URI: recopilación de URI que se incluirán en el filtro. (El URI representa la porción user@host de una dirección SIP.) Los identificadores URI pueden especificarse con los siguientes formatos: user@fabrikam.com; user@*; *@fabrikam.com. Puede incluir varios URI en un solo filtro.

Habilitado: indica si el filtro se debe activar o no.

LoggingShare

Opcional

Cadena de caracteres

Carpeta compartida donde se pueden cargar registros de diagnóstico.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings. Set-CsDiagnosticConfiguration acepta instancias canalizadas del objeto de opciones de configuración de diagnóstico.

Tipos de valores devueltos

Set-CsDiagnosticConfiguration no devuelve un valor u objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

$x = New-CsDiagnosticsFilter -Fqdn fabrikam.com -Uri sip:user@fabrikam.com 
Set-CsDiagnosticConfiguration -Identity global -Filter $x

Los comandos que se muestran en el Ejemplo 1 utilizan New-CsDiagnosticsFilter para crear un nuevo filtro de diagnóstico y, a continuación, asignar ese filtro a las opciones de configuración de diagnóstico global. Para realizar esta tarea, el primer comando llama a New-CsDiagnosticsFilter para crear un filtro de diagnóstico que solo existe en la memoria y que usa el FQDN fabrikam.com y el URI user@fabrikam.com. El filtro virtual se almacena en la variable $x.

En el comando 2, Set-CsDiagnosticConfiguration asigna el nuevo filtro a las opciones de configuración de diagnóstico global. En este caso, cualquier valor de la propiedad Filter se reemplazará por el nuevo filtro creado.

-------------------------- Ejemplo 2 ------------------------

$x = (Get-CsDiagnosticConfiguration -Identity global).Filter
$x.Fqdn.Add("fabrikam.com")
Set-CsDiagnosticConfiguration -Identity global -Filter $x

En el Ejemplo 2, se muestra cómo puede agregar un nuevo FQDN a la propiedad Filter de las opciones de configuración de diagnóstico global. Para ello, el primer comando del ejemplo utiliza Get-CsDiagnosticConfiguration para recuperar el valor de la propiedad Filter de la configuración global. Para ello, la llamada se encierra entre paréntesis de Get-CsDiagnosticConfiguration; eso hace que Windows PowerShell ejecute ese comando antes de hacer otra cosa. Después de devolver la configuración global, se extrae el valor de la propiedad Filter y se almacena en una variable denominada $x.

En el segundo comando, se usa el método Add para agregar un nuevo FQDN (fabrikam.com) al filtro. Una vez finalizado, el comando final del ejemplo usa Set-CsDiagnosticConfiguration para escribir la colección de diágnostico modificada. Como resultado final, fabrikam.com se agregará a los FQDN ya incluidos en la propiedad Filter.

-------------------------- Ejemplo 3 ------------------------

$x = (Get-CsDiagnosticConfiguration -Identity global).Filter
$x.Fqdn.Remove("fabrikam.com")
Set-CsDiagnosticConfiguration -Identity global -Filter $x

El comando que se muestra en el Ejemplo 3 quita un FQDN (fabrikam.com) de las opciones de configuración del diagnóstico global de la propiedad Filter. El primer comando del ejemplo usa Get-CsDiagnosticConfiguration para recuperar el valor actual de la propiedad Filter de la configuración global; este valor es almacenado en una variable denominada $x. Después de haber recuperado ese valor, se usa el método Remove para quitar el FQDN fabrikam.com. Después de quitar el FQDN, se usa Set-CsDiagnosticConfiguration para escribir el filtro modificado (almacenado en la variable $x) en la configuración global.

-------------------------- Ejemplo 4 ------------------------

Set-CsDiagnosticConfiguration -Identity global -Filter $Null

En el Ejemplo 4, se quitan todos los elementos de la propiedad Filter de las opciones de configuración del diagnóstico global. Para ello, la propiedad Filter se configura con un valor nulo.