Compartir a través de

  • Artículo

New-CsDiagnosticHeaderConfiguration

 

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

Crea una nueva colección de valores de configuración de encabezado de diagnóstico. Los valores de configuración del encabezado de diagnóstico determinan si los mensajes SIP se acompañan con información de encabezado que puede ser útil para solución de problemas y el informe de errores.

Sintaxis

New-CsDiagnosticHeaderConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-SendToExternalNetworks <$true | $false>] [-SendToOutsideUnauthenticatedUsers <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Los administradores tienen la opción de adjuntar un encabezado de diagnóstico MS a cada mensaje SIP enviado en una organización. Este mensaje (que no pueden ver los usuarios finales) contiene información que puede resultar útil para solucionar problemas de conexión y generar informes de errores. Por ejemplo, el encabezado de diagnóstico puede contener códigos de error que permitan a la aplicación cliente (como Microsoft Lync 2010) actuar de una manera predeterminada si se da cierta situación.

Para los mensajes SIP que se envíen dentro de una red interna, hay pocos motivos para no incluir encabezados de diagnóstico: tienen una repercusión mínima en el tamaño del mensaje y pueden constituir una herramienta de valor incalculable para los administradores que intenten solucionar problemas de conectividad. No obstante, los encabezados de diagnóstico también contienen información, como los nombres de dominio completos (FQDN) de los servidores SIP, que es posible que no quiera que sea visible para personas que no pertenezcan a la red interna. Por este motivo, las opciones de configuración de encabezados de diagnóstico permiten decidir si quiere enviar los encabezados de diagnóstico a los usuarios de redes externas (como los usuarios de un dominio federado) y/o a los usuarios externos (que son aquéllos que se han conectado desde fuera de la red interna y todavía no se han autenticado).

De forma predeterminada, los encabezados de diagnóstico no se incluyen en los mensajes enviados a redes externas o a usuarios no autenticados. No obstante, puede modificar la configuración global de los encabezados de diagnóstico para incluir encabezados en los mensajes a redes externas o a usuarios sin autenticar. También puede crear configuraciones personalizadas en el ámbito de sitio o de servicio (para Servidor perimetral o para el servicio de registrador). De este modo, puede incluir encabezados de diagnóstico en los mensajes que se envíen desde un sitio, o a través de un Servidor perimetral, y no permitir encabezados en los mensajes que se envíen desde otros sitios o a través de otros servidores perimetrales.

Los valores de encabezado de diagnóstico predeterminado se crean usando el cmdlet New-CsDiagnosticHeaderConfiguration. Como se ha indicado, los nuevos valores pueden crearse tanto en ámbito de sitio como de servicio (aunque sólo para los servicios de Servidor perimetral y de Registrador). Tenga en cuenta que sólo puede tener una colección de dichos valores por sitio o servicio. Por ejemplo, imagine que intenta crear una nueva colección para el sitio Redmond, y que dicho sitio ya hospeda una colección de valores de encabezado de diagnóstico. En ese caso, el comando dará error. De la misma manera, el comando dará error si intenta crear una nueva colección de ámbito global.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsDiagnosticHeaderConfiguration localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único para los valores de configuración de encabezado de diagnóstico que se van a crear. Para crear una nueva colección de valores en el ámbito de sitio, use la sintaxis del siguiente ejemplo: -Identity "site:Redmond". Para crear una nueva colección de valores en el ámbito de servicio, use la sintaxis del siguiente ejemplo: -Identity "service:EdgeServer:atl-cs-001.litwareinc.com".

No puede crear nuevos valores en el ámbito global. Además, no puede crear nuevos valores en el ámbito de sitio o de servicio si el sitio o servicio especificado (por ejemplo, site:Redmond) ya hospeda una colección de valores.

SendToExternalNetworks

Opcional

Booleano

Si está establecido en True, se adjuntarán encabezados de diagnóstico a los mensajes enviados a usuarios de redes externas (como usuarios de un dominio federado). El valor predeterminado es False.

SendToOutsideUnauthenticatedUsers

Opcional

Booleano

Si está establecido en True, se adjuntarán encabezados de diagnóstico a los mensajes enviados a usuarios externos, que son aquéllos que se han conectado desde fuera de la red interna (a través de un servidor proxy, por ejemplo) y todavía no se han autenticado.

El valor predeterminado es False.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan surgir 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-CsDiagnosticHeaderConfiguration no acepta entradas transferidas.

Tipos de valores devueltos

New-CsDiagnosticHeaderConfiguration crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticHeaderSettings.

Ejemplo

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

New-CsDiagnosticHeaderConfiguration -Identity site:Redmond -SendToOutsideUnauthenticatedUsers $True

En el Ejemplo 1 se crea una nueva configuración de encabezado de diagnóstico para el sitio Redmond (-Identity site:Redmond). Además de especificar la Identidad, el comando usa el parámetro SendToOutsideAuthenticatedUsers y el valor de parámetro $True. Esto permite el envío de información a usuarios autenticados fuera de la red interna.

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

$x = New-CsDiagnosticHeaderConfiguration -Identity site:Redmond
$x.SendToOutsideUnauthenticatedUsers = $True
$x.SendToExternalNetworks = $True
Set-CsDiagnosticHeaderConfiguration -Instance $x

Los comandos del Ejemplo 2 demuestran cómo crear una colección de valores de configuración de encabezados de diagnóstico que, inicialmente, exista sólo en la memoria. Para hacerlo, el primer comando del ejemplo llama a New-CsDiagnosticHeaderConfiguration junto con el parámetro Identity. El objeto resultante se almacena en la variable $x.

Después de que se hayan creado los valores virtuales, los comandos 2 y 3 se usan para modificar los valores de las propiedades SendToOutsideUnauthenticatedUsers y SendToExternalNetworks respectivamente. Para acabar, el comando 4 se usa para transformar los valores de configuración virtual de los encabezado de diagnóstico a colecciones de valores de configuración real aplicadas al sitio Redmond. Tenga en cuenta que este último comando es obligatorio. Si no llama a Set-CsDiagnosticHeaderConfiguration, no se aplicará ninguna configuración al sitio y las opciones virtuales desaparecerán en cuanto termine la sesión de Windows PowerShell o elimine la variable $x.