New-CsDiagnosticsFilter
Última modificación del tema: 2012-03-23
Crea un nuevo filtro de diagnóstico para utilizar con las 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 su Microsoft Lync Server 2010.
Sintaxis
New-CsDiagnosticsFilter [-Enabled <$true | $false>] [-ExcludeConferenceMessages <$true | $false>] [-ExcludePresenceNotifications <$true | $false>] [-ExcludeRegisterMessages <$true | $false>] [-ExcludeSubscribeMessages <$true | $false>] [-Fqdn <PSListModifier>] [-Uri <PSListModifier>]
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.
Aunque es posible que se registre 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 guardarán en los archivos de registro; por ejemplo, es posible que desee registrar sólo el tráfico entrante o saliente de ciertos dominios. Además de la configuración global, Lync Server permite crear configuraciones de diagnóstico en el ámbito de sitio o de servicio (tanto para el Servidor perimetral como para el servicio registrador). A su vez, esto le permite aplicar al sitio Redmond distintas configuraciones de las que se aplican a sus otros sitios.
New-CsDiagnosticsFilter permite agregar un filtro a una recopilación de configuraciones de diagnóstico. Esta recopilación contiene los dominios e identificadores URI cuyos datos de tráfico se guardarán en los archivos de registro. Cuando se agregue un filtro, sólo se registrará información de los dominios e identificadores URI del filtro; por cuestiones de registro, el tráfico de otros dominios e identificadores URI se omitirá.
Debe tener en cuenta que el cmdlet New-CsDiagnosticsFilter sólo crea instancias de un filtro de diagnóstico en memoria. Una vez creado uno de estos filtros virtuales, deberá usar New-CsDiagnosticConfiguration o Set-CsDiagnosticConfiguration para agregar el filtro a una recopilación.
Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet New-CsDiagnosticsFilter localmente los miembros de los siguientes grupos: 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 (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsDiagnosticsFilter"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Enabled |
Requerido |
Booleano |
Indica si debe usarse el filtro. El valor predeterminado es True ($True). |
ExcludeConferenceMessages |
Opcional |
Booleano |
Si el valor es True, la información sobre mensajes de conferencia (es decir, cualquier mensaje con un URI de conferencia en su encabezado Para o De) no se grabará en los archivos de registro. El valor predeterminado es False. |
ExcludePresenceNotifications |
Opcional |
Booleano |
Si el valor es True, la información sobre notificaciones de presencia (es decir, cualquier mensaje que utilice el método NOTIFY o BENOTIFY) no se guardará en los archivos de registro. El valor predeterminado es False. |
ExcludeRegisterMessages |
Opcional |
Booleano |
Si el valor es True, la información sobre registros de clientes (es decir, cualquier mensaje que utilice el método REGISTER) no se guardará en los archivos de registro. El valor predeterminado es False. |
ExcludeSubscribeMessages |
Opcional |
Booleano |
Si el valor es True, la información sobre suscripciones de clientes (es decir, cualquier mensaje que utilice el método SUBSCRIBE) no se guardará en los archivos de registro. El valor predeterminado es False. |
Fqdn |
Opcional |
Modificador de lista PS |
Recopilación de dominios que se incluirán en el filtro. (Técnicamente, estos dominios representan la parte de host de una dirección SIP.) Para la propiedad FQDN, puede utilizar un nombre de dominio completo (FQDN) como este: fabrikam.com. También puede usar caracteres comodín para representar varios dominios: *.fabrikam.com. Pueden especificarse varios dominios en un único filtro. |
Uri |
Opcional |
Modificador de lista PS |
Recopilación de identificadores URI que se incluirán en el filtro. (El URI es la parte de usuario@host de una dirección SIP.) Los identificadores URI pueden especificarse con los siguientes formatos: user@fabrikam.com user@* *@fabrikam.com Puede incluir varios identificadores URI en un único filtro. |
Tipos de entrada
Ninguno. New-CsDiagnosticsFilter no acepta la entrada por canalización.
Tipos de valores devueltos
New-CsDiagnosticsFilter crea instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.Filter.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x
Los comandos del Ejemplo 1 muestran cómo usar New-CsDiagnosticsFilter para crear un filtro de diagnóstico y asignarlo a las opciones de configuración de diagnóstico globales. Para ello, el primer comando llama a New-CsDiagnosticsFilter para crear un filtro de diagnóstico en memoria. Este filtro agrega el nombre de dominio completo fabrikam.com y el URI 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 segundo comando, se usa Set-CsDiagnosticConfiguration para asignar el nuevo filtro a las opciones de configuración de diagnóstico globales. En este caso, cualquier valor de la propiedad Filter se reemplazará por el nuevo filtro almacenado en la variable $x.
-------------------------- Ejemplo 2 ------------------------
$x = New-CsDiagnosticsFilter -Fqdn "fabrikam.com","contoso.com" -Enabled $False
Set-CsDiagnosticConfiguration -Identity global -Filter $x
Los comandos del Ejemplo 2 son una variación de los del Ejemplo 1 con una diferencia: en el Ejemplo 2 se agregan dos nombres de dominio completos (fabrikam.com y contoso.com) a la propiedad Fqdn del filtro. Para ello, se usan ambos nombres separados por una coma como valores del parámetro Fqdn.