Compartir a través de

  • Artículo

Get-CsDiagnosticConfiguration

 

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

Devuelve información sobre las opciones de la configuración de diagnóstico que actualmente se usa en la organización. Las configuraciones 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

Get-CsDiagnosticConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsDiagnosticConfiguration [-Filter <String>] [-LocalStore <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 los 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, podrá aplicar al sitio Redmond distintas configuraciones de las que aplica al resto de sitios.

El cmdlet Get-CsDiagnosticConfiguration permite devolver información sobre las opciones de configuración del filtro de diagnóstico que usa actualmente su organización.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsDiagnosticConfiguration de manera local: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

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

Si no se especifica este parámetro, se devolverán todas las opciones de configuración de diagnóstico que se usan actualmente.

Filter

Opcional

Cadena de caracteres

Permite usar caracteres comodín al especificar la colección (o colecciones) de configuraciones que se devolverán. Por ejemplo, esta sintaxis devuelve todas las opciones configuradas en el ámbito del sitio: -Filter "site:*".

Tenga en cuenta que no se pueden utilizar ambos parámetros, Filter e Identity, en el mismo comando.

LocalStore

Opcional

Parámetro modificador

Recupera los datos de configuración de diagnóstico de la réplica local de la Almacén de administración central, en lugar de recuperarlos de la Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsDiagnosticConfiguration no acepta entradas transferidas.

Tipos de valores devueltos

Get-CsDiagnosticConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Ejemplo

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

Get-CsDiagnosticConfiguration

En el ejemplo 1, se devuelve información de todas las opciones de configuración de diagnóstico que se usan actualmente en la organización. Para ello, se llama a Get-CsDiagnosticConfiguration sin parámetros.

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

Get-CsDiagnosticConfiguration -Identity site:Redmond

El comando anterior devuelve información para las opciones de configuración de diagnóstico que se aplican al sitio Redmond (-Identity site:Redmond).

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

Get-CsDiagnosticConfiguration -Identity site:Redmond | Select-Object -ExpandProperty Filter

El comando del ejemplo 3 muestra la información de cada filtro incluido dentro de las opciones de configuración de diagnóstico del sitio Redmond. Para hacerlo, el comando usa primero Get-CsDiagnosticConfiguration para devolver las configuraciones de filtro del sitio Redmond. A continuación, esta información se transfiere al cmdlet Select-Object, que usa el parámetro ExpandProperty para "ampliar" el valor de la propiedad Filter. Ampliar la propiedad Filter permite obtener acceso a las propiedades y a los valores de propiedades de cada filtro que se mantiene en las opciones de configuración de diagnóstico.

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

Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -contains "sip:diagnostics@litwareinc.com"}

El comando que se muestra en el ejemplo 4 devuelve un subconjunto de los filtros encontrados en las opciones de configuración de diagnóstico global; concretamente, devuelve los filtros cuya propiedad Uri contiene la dirección SIP sip:diagnostics@litwareinc.com. Para hacerlo, el comando usa primero Get-CsDiagnosticConfiguration para devolver toda la información de filtro de la instancia global de las opciones de configuración de diagnóstico. A continuación, esta información se transfiere al cmdlet Select-Object, que amplía la propiedad Filter. Después se transfiere cada objeto de filtro a Select-Object, que extrae solo los filtros cuya propiedad Uri contiene la dirección SIP sip:diagnostics@litwareinc.com.

-------------------------- Ejemplo 5 ------------------------

Get-CsDiagnosticConfiguration -Identity global | Select-Object -ExpandProperty Filter | Where-Object {$_.Uri -notcontains "sip:diagnostics@litwareinc.com"}

El ejemplo 5 es una variación del comando mostrado en el ejemplo 4; en el ejemplo 5, no obstante, solo se devuelven los filtros si la propiedad Uri no contiene la dirección SIP sip:diagnostics@litwareinc.com. Para llevar a cabo esta tarea, el comando llama a Get-CsDiagnosticConfiguration para devolver toda la información de configuración de diagnóstico para la instancia global de las opciones de configuración. A continuación, esta información se transfiere al cmdlet Select-Object, que amplía la propiedad Filter. Después se transfieren estos objetos de filtro a Select-Object, que selecciona solo los filtros cuya propiedad Uri no contiene la dirección SIP sip:diagnostics@litwareinc.com.