Compartir a través de

  • Artículo

Remove-CsDiagnosticHeaderConfiguration

 

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

Quita una o más de las recopilaciones de configuraciones de encabezados de diagnóstico que estén actualmente en uso en la organización. La configuración de encabezados de diagnóstico determina si los mensajes SIP contienen información de encabezado que puede resultar útil para la solución de problemas y la generación de informes de errores.

Sintaxis

Remove-CsDiagnosticHeaderConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Los administradores tienen la opción de adjuntar un encabezado ms-diagnostic a cada mensaje SIP enviado en la organización. Este mensaje (que no pueden ver los usuarios finales) contiene información que puede resultar útil para la solución de problemas de conexión y la generación de informes de errores. Por ejemplo, el encabezado de diagnóstico puede contener códigos de error que permitan a la aplicación cliente llevar a cabo una acción predeterminada en caso de que surja una situación específica.

Para los mensajes SIP enviados dentro de la red interna, no existe ninguna razón por la que no incluir estos 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 desee 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).

También puede crear configuraciones personalizadas en el ámbito de sitio o de servicio (para Servidor perimetral o para el servicio de registrador). De esta forma, puede seleccionar si desea incluir encabezados de diagnóstico en los mensajes enviados desde un sitio o a través de un Servidor perimetral determinado, al tiempo que prohíbe los encabezados en los mensajes enviados desde otros sitios o a través de otros servidores perimetrales.

Cualquier colección que cree (en el ámbito de sitio o de servicio) se puede quitar más tarde mediante el cmdlet Remove-CsDiagnosticHeaderConfiguration. También puede ejecutar este cmdlet en la recopilación global. No obstante, en este caso, no se quitará la recopilación global porque no puede hacerlo. En su lugar, se restablecerán los valores predeterminados de las dos propiedades de la colección global, SendToExternalNetworks y SendToOutsideUnauthenticatedUsers. (En ambos casos el valor predeterminado es False).

Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Remove-CsDiagnosticHeaderConfiguration: 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 "Remove-CsDiagnosticHeaderConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de la configuración de encabezado de diagnóstico que se va a quitar. Para quitar la configuración definida en el ámbito de sitio, use una sintaxis similar a ésta: -Identity "site:Redmond". Para quitar la configuración definida en el ámbito de servicio, use una sintaxis similar a ésta: -Identity "service:EdgeServer:atl-edge-001.litwareinc.com".

Remove-CsDiagnosticHeaderConfiguration también puede ejecutarse en oposición a las configuraciones globales; en ese caso, usa la sintaxis: –Identity global. No obstante, debe tener en cuenta que la configuración global no se quitará, sino que se restablecerán los valores predeterminados de sus propiedades.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir al ejecutar el comando.

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

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticHeaderSettings. Remove-CsDiagnosticHeaderConfiguration acepta las instancias transferidas del objeto de configuración de encabezado de diagnóstico.

Tipos de valores devueltos

Ninguno. En lugar de eso, Remove-CsDiagnosticHeaderConfiguration elimina instancias existentes del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticHeaderSettings.

Ejemplo

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

Remove-CsDiagnosticHeaderConfiguration -Identity site:Redmond

En el Ejemplo 1, se quitan las configuraciones de encabezado de diagnóstico que tienen el valor de Identity site:Redmond.

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

Get-CsDiagnosticHeaderConfiguration -Filter service:* | Remove-CsDiagnosticHeaderConfiguration

El comando mostrado en el Ejemplo 2 elimina todas las configuraciones de encabezados de diagnóstico que se hayan aplicado al ámbito de servicio. Para ello, el comando primero llama a Get-CsDiagnosticHeaderConfiguration y al parámetro Filter. El valor de filtro "service:*" restringe los datos devueltos a las configuraciones cuya identidad comience por los caracteres "service:". A continuación, la recopilación filtrada se transfiere a Remove-CsDiagnosticHeaderConfiguration, que elimina cada uno de los elementos de la recopilación.

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

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

El comando anterior elimina todas las configuraciones de encabezados de diagnóstico que permiten enviar encabezados de diagnóstico a redes externas. Para ello, el comando primero usa Get-CsDiagnosticHeaderConfiguration para devolver una recopilación de todas las configuraciones de encabezados de diagnóstico que estén actualmente en uso. Esta colección se transfiere al cmdlet Where-Object, que selecciona únicamente las configuraciones en las que la propiedad SendToExternalNetworks sea igual a True. A continuación, las configuraciones se transfieren a Remove-CsDiagnosticHeaderConfiguration, que elimina todas las que permitan el envío a redes externas.