Compartir a través de

  • Artículo

New-CsDiagnosticConfiguration

 

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

Crea opciones de configuración de diagnóstico. 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

New-CsDiagnosticConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-InMemory <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 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 identificadores URI cuyos datos se guardarán en los archivos de registro; por ejemplo, puede registrar el tráfico de dominios especificados solamente. Lync Server permite crear opciones de configuración de diagnóstico en el ámbito de sitio o de servicio. De este modo, podrá, por ejemplo, aplicar opciones al sitio Redmond que sean diferentes de las que aplica al resto de sitios.

Observe que no puede crear opciones de configuración de diagnóstico en el ámbito global; eso se debe a que el ámbito global ya hospeda esas opciones de configuración. Del mismo modo, tampoco es posible crear una recopilación de opciones de configuración en el ámbito del sitio si el sitio especificado ya contiene opciones de configuración de diagnóstico. Por ejemplo, si intenta crear una nueva recopilación para el sitio Redmond y ese sitio ya hospeda opciones de configuración de diagnóstico, se producirá un error en el comando.

Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet New-CsDiagnosticConfiguration de 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 "New-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 crearán. Debido a que las nuevas configuraciones solo se pueden crear en el ámbito del sitio, debe usar una sintaxis similar a la siguiente -Identity "site:Redmond".

Filter

Opcional

Modificador de lista PS

Colección de dominios y URI cuyo tráfico se registrará si está habilitado el filtrado de diagnóstico. La propiedad Filter consta de tres elementos separados:

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 tendría un aspecto similar a éste: 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 es la secció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 en la que se puede cargar los 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.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

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

Ninguno. New-CsDiagnosticConfiguration no acepta entradas canalizadas.

Tipos de valores devueltos

New-CsDiagnosticConfiguration crea nuevas instancias de Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings.

Ejemplo

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

New-CsDiagnosticConfiguration -Identity site:Redmond

El comando anterior crea una nueva recopilación de opciones de configuración de diagnóstico para el sitio Redmond.

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

$x = New-CsDiagnosticsFilter -Fqdn fabrikam.com -Uri "sip:user@fabrikam.com" -Enabled $False 

New-CsDiagnosticConfiguration -Identity site:Redmond -Filter $x

El comando que se muestra en el Ejemplo 2 crea un nuevo filtro de diagnóstico y, luego, asigna ese filtro a la nueva recopilación de configuraciones de diagnóstico. Para realizar esta tarea, el primer comando llama a New-CsDiagnosticsFilter para crear un filtro de diagnóstico que solo existe en la memoria; este comando agrega el FQDN fabrikam.com y el URI sip:user@fabrikam.com al filtro. El comando además configura la propiedad Enabled en True ($True) a fin de activar el filtro. El filtro virtual resultante se almacena en la variable $x.

En el comando 2, New-CsDiagnosticConfiguration se usa para crear una nueva recopilación de opciones de configuración de diagnóstico para el sitio Redmond. Estas nuevas configuraciones usarán el filtro de diagnóstico almacenado en la variable $x.

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

$x = New-CsDiagnosticConfiguration -Identity site:Redmond -InMemory
$x.LoggingShare = "\\atl-fs-001\logs"
Set-CsDiagnosticConfiguration -Instance $x

Los comandos que se muestran en el Ejemplo 3 demuestran la manera en que puede crear opciones de configuración de diagnóstico que, inicialmente, existen solo en la memoria. Para ello, el primer comando llama a New-CsDiagnosticConfiguration junto con dos parámetros: Identidad (que especifica la Identidad de la configuración) e InMemory, que indica que la nueva configuración debe crearse sólo en la memoria. El objeto resultante se almacena en la variable $x.

Después de crear estas configuraciones virtuales, el segundo comando se usa para configurar la propiedad LoggingShare en la ruta de acceso de UNC \\atl-fs-001\logs. Luego, el comando final se usa para transformar las opciones de configuración de diagnóstico virtuales en una recopilación real de configuraciones aplicadas al sitio Redmond. Tenga en cuenta que este último comando es obligatorio. Si no llama a Set-CsDiagnosticConfiguration entonces no se aplicarán las configuraciones al sitio Redmond, y las configuraciones virtuales desaparecerán tan pronto como finalice su sesión en Windows PowerShell o elimine la variable $x.