Compartir a través de

  • Artículo

Remove-CsTrunkConfiguration

 

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

Quita una configuración del tronco existente que describe la configuración de una entidad del mismo nivel de tronco, como una puerta de enlace de red telefónica conmutada (RTC), una central de conmutación (PBX) de IP pública o un controlador de borde de sesión (SBC) del proveedor de servicios.

Sintaxis

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

Descripción detallada

Use este cmdlet para quitar una configuración del tronco aplicable a entidades de puerta de enlace RTC. Cada configuración consta de opciones específicas para una entidad del mismo nivel de tronco, como una puerta de enlace RTC, IP-PBX o SBC del proveedor de servicios. Esta configuración establece aspectos, por ejemplo, si la omisión de medios está habilitada en este tronco, si los paquetes del protocolo de transporte en tiempo real (RTCP) se envían bajo determinadas condiciones y si el cifrado del protocolo de transporte seguro en tiempo real (SRTP) es obligatorio.

Tenga en cuenta que si llama a Remove-CsTrunkConfiguration en la configuración global, dicha configuración del tronco no se quitará. En lugar de ello, la configuración se "restablecerá" y todas las configuraciones personalizadas se reemplazarán por los valores predeterminados.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsTrunkConfiguration 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 "Remove-CsTrunkConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de la configuración del tronco que se quiere quitar.

Force

Opcional

Parámetro modificador

Suprime las preguntas de confirmación que aparecerían antes de realizar cambios.

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.TrunkConfiguration.TrunkConfiguration. Acepta la entrada transferida de objetos de configuración de tronco.

Tipos de valores devueltos

Este cmdlet no devuelve un valor. Quita un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.

Ejemplo

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

Remove-CsTrunkConfiguration -Identity site:Redmond

En este ejemplo se quita la configuración del tronco con el valor de Identity site:Redmond.

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

Get-CsTrunkConfiguration -Filter site:* | Remove-CsTrunkConfiguration

En el Ejemplo 2 se quitan todas las configuraciones del tronco en el nivel de sitio. La primera parte del comando es una llamada al cmdlet Get-CsTrunkConfiguration que usa el parámetro Filter para recuperar todas las configuraciones del tronco cuya Identidad comienza por site:, es decir, todas las configuraciones del tronco definidas en el nivel de sitio. A continuación, esta colección de opciones de configuración se transfiere al cmdlet Remove-CsTrunkConfiguration, que quita todos los objetos de la colección.