Compartir a través de

  • Artículo

Remove-CsDiagnosticConfiguration

 

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

Quita uno o más de las colecciones de opciones de configuración de diagnóstico actualmente en uso en su organización. Las opciones de configuración de diagnóstico se usan para determinar si el tráfico de un dominio o URI determinado se registra en los archivos de registro de Microsoft Lync Server 2010.

Sintaxis

Remove-CsDiagnosticConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 ese dominio específico. De este modo, podrá identificar con facilidad la información registrada relevante para diagnosticar y solucionar el problema.

Gracias a opciones de configuración de diagnóstico se puede especificar los dominios o URI que se registrarán en los archivos de registro. Si hay habilitado un filtro de diagnóstico, solamente se registrará el tráfico de esos dominios concretos. Lync Server permite crear opciones de configuración de diagnóstico, y aplicar filtros de diagnóstico, en el ámbito de sitio. De este modo, podrá, por ejemplo, aplicar filtrado al sitio Redmond y no al resto de sitios.

Puede usar el cmdlet Remove-CsDiagnosticConfiguration para eliminar cualquier opción de configuración de diagnóstico que ha creado en el ámbito del sitio o de servicio. El cmdlet Remove-CsDiagnosticConfiguration también puede ejecutarse frente a la configuración de diagnóstico global. En ese caso, sin embargo, no se eliminará la colección; esto se debe a que Lync Server no le permite eliminar colecciones globales. En su lugar, eliminar una colección global hace que las propiedades en esa colección se restablezcan a sus valores predeterminados. Lo que significa que se quitarán todos los filtros agregados a esa colección.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Remove-CsDiagnosticConfiguration de forma local: localmente: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de las opciones de configuración de diagnóstico que se quitarán. Para quitar la configuración definida en el ámbito de sitio, use una sintaxis similar a ésta: -Identity "site:Redmond".

Remove-CsDiagnosticConfiguration también puede ejecutarse en oposición a las configuraciones globales; en ese caso, usa la sintaxis: –Identity global. Sin embargo, las configuraciones globales no se quitarán realmente. En su lugar, las propiedades que se encuentran en las configuraciones globales se restablecerán a sus valores predeterminados.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir 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. Remove-CsDiagnosticConfiguration acepta las instancias transferidas del objeto de configuración de filtro de diagnóstico.

Tipos de valores devueltos

Ninguno. En lugar de eso, Remove-CsDiagnosticConfiguration elimina instancias existentes del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Ejemplo

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

Remove-CsDiagnosticConfiguration -Identity site:Redmond

El comando anterior elimina las configuraciones de diagnóstico que tengan el valor Identity site:Redmond.

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

Get-CsDiagnosticConfiguration -Filter site:* | Remove-CsDiagnosticConfiguration

En el comando que se muestra en el Ejemplo 2 se eliminan todas las configuraciones de diagnóstico que se han configurado en el ámbito del sitio. Para ello, el comando llama a Get-CsDiagnosticConfiguration junto con el parámetro Filter; el valor de filtro "site:*" limita los datos devueltos a las configuraciones cuya Identidad comienza con los caracteres "site:". La colección filtrada luego se transfiere a Remove-CsDiagnosticConfiguration, que elimina cada elemento en esa colección filtrada.

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

Get-CsDiagnosticConfiguration | Remove-CsDiagnosticConfiguration

En el Ejemplo 3, el comando elimina todas las configuraciones de diagnóstico actualmente en uso en la organización. A fin de realizar esta tarea, primero se llama a Get-CsDiagnosticConfiguration, sin ningún parámetro, para devolver una colección de todas las configuraciones de diagnóstico actualmente en uso en la organización. Estos elementos se transfieren a Remove-CsDiagnosticConfiguration, que elimina todos los elementos de la colección.