Compartir a través de

  • Artículo

Get-CsDiagnosticHeaderConfiguration

 

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

Devuelve información sobre las configuraciones de encabezados de diagnóstico que están en uso en su organización. Las configuraciones de encabezados de diagnóstico determinan si los mensajes SIP van acompañados de información de encabezado. Esta información puede resultar útil a la hora de resolver problemas y en los informes de errores.

Sintaxis

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

Get-CsDiagnosticHeaderConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

Al enviar mensajes SIP (Protocolo de inicio de sesión), tiene la opción de adjuntar un encabezado de ms-diagnostics a cada mensaje. El mensaje (que no es visible para los usuarios finales) contiene información que puede resultar útil para solucionar problemas de conexión o notificar 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 un impacto mínimo en el tamaño del mensaje, y pueden ser una valiosa herramienta para que los administradores 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 le 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 usuarios externos. (Los usuarios externos son usuarios que se han conectado desde fuera de la red interna y que todavía no han sido autenticados.)

De forma predeterminada, los encabezados no se incluyen en los mensajes que se envían a redes externas ni a usuarios sin autenticar. 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 optar por crear configuraciones personalizadas en el ámbito de sitio o de servicio (para el servicio registrador o Servidor perimetral). 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.

El cmdlet Get-CsDiagnosticHeaderConfiguration proporciona una vía para recuperar información acerca de las configuraciones de encabezado de diagnóstico que están en uso en su organización.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsDiagnosticHeaderConfiguration de forma local: RTCUniversalUserAdmins, 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 "Get-CsDiagnosticHeaderConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único para las configuraciones de encabezado de diagnóstico que se deben devolver. Para devolver la configuración definida en el ámbito de sitio, use la sintaxis siguiente: -Identity "site:Redmond". Para devolver la configuración definida en el ámbito de servicio, use la sintaxis siguiente: -Identity "service:EdgeServer:atl-edge-001.litwareinc.com". Para devolver la configuración global, use la siguiente sintaxis: -Identity global.

Si no se especifica este parámetro, se devolverán todas las configuraciones de encabezado de diagnóstico que estén en uso 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 configuraciones definidas en el ámbito de sitio: -Filter "site:*". Esta sintaxis devuelve todas las opciones configuradas en el ámbito del servicio: -Filter "service:*".

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 encabezados de diagnóstico de la réplica local de Almacén de administración central en lugar de recuperarlos de Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsDiagnosticHeaderConfiguration no acepta la entrada transferida.

Tipos de valores devueltos

Get-CsDiagnosticHeaderConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticHeaderSettings.

Ejemplo

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

Get-CsDiagnosticHeaderConfiguration

El comando anterior devuelve información sobre las configuraciones de encabezados de diagnóstico que están en uso en la organización. Para ello, se llama a Get-CsDiagnosticHeaderConfiguration sin parámetros.

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

Get-CsDiagnosticHeaderConfiguration -Identity site:Redmond

En el Ejemplo 2 se devuelve una única colección de configuraciones de encabezado de diagnóstico: tiene el valor Identity site:Redmond.

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

Get-CsDiagnosticHeaderConfiguration -Filter "service:*"

El comando del Ejemplo 3 devuelve todas las configuraciones de encabezados de diagnóstico realizadas en el ámbito de servicio. Para ello, se llama a Get-CsDiagnosticHeaderConfiguration con el parámetro Filter; el valor de filtro "service:*" garantiza que únicamente se devolverán las configuraciones con una identidad que empiece por los caracteres "service:".

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

Get-CsDiagnosticHeaderConfiguration | Where-Object {$_.SendToExternalNetworks -eq $True}

En el Ejemplo 4 se devuelven todas las configuraciones de encabezados de diagnóstico que permiten realizar envíos a redes externas. Para llevar a cabo esta tarea, en primer lugar el comando llama a Get-CsDiagnosticHeaderConfiguration sin parámetros; el resultado es una colección de todas las configuraciones de encabezados de diagnóstico en uso. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona únicamente las configuraciones en las que la propiedad SendToExternalNetworks sea igual a True.

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

Get-CsDiagnosticHeaderConfiguration | Where-Object {$_.SendToExternalNetworks -eq $True -or $_.SendToOutsideUnauthenticatedUsers -eq $True}

El comando del Ejemplo 5 devuelve información acerca de las configuraciones de encabezados de diagnóstico que cumplen al menos uno de los criterios siguientes: 1) La propiedad SendToExternalNetworks es igual a True; y 2) la propiedad SendToOutsideUnauthenticatedUsers es igual a True. Para ello, en primer lugar el comando usa Get-CsDiagnosticHeaderConfiguration para devolver una colección de todas las configuraciones de encabezados de diagnóstico actualmente en uso. Esta colección se transfiere a Where-Object, que selecciona las configuraciones en las que las propiedades SendToExternalNetworks y/o SendToOutsideUnauthenticatedUsers son igual a True.

El operador -or especifica que, para ser devueltas, las configuraciones solo tienen que cumplir uno de los criterios especificados. Para exigir que las configuraciones cumplan los dos criterios especificados, utilice el operador -and en su lugar:

Where-Object {$_.SendToExternalNetworks -eq $True -and $_.SendToOutsideUnauthenticatedUsers -eq $True}