Compartir a través de

  • Artículo

Remove-CsAVEdgeConfiguration

 

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

Permite quitar una colección existente de opciones de configuración aplicada a los equipos que ejecutan el Servicio perimetral de acceso (estos equipos se conocen también como servidores perimetrales A/V). Un servidor perimetral A/V permite a los usuarios internos compartir datos de audio y vídeo con usuarios externos (es decir, usuarios que no estén conectados a la misma red interna).

Sintaxis

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

Descripción detallada

Un servidor perimetral A/V permite intercambiar tráfico de audio y vídeo a través del firewall de la organización. Entre otras cosas, esto permite a los usuarios utilizar Microsoft Lync Server 2010 en todo Internet y, entonces, intercambiar datos de audio y vídeo con los usuarios que hayan iniciado sesión en el sistema desde dentro del firewall. Las opciones de configuración de Servidor perimetral se pueden asignar en el ámbito global, del sitio y del servicio. Las opciones de configuración perimetral A/V permiten a los administradores determinar durante cuánto tiempo es válida la autenticación de usuarios antes de que deba renovarse, así como limitar la cantidad de ancho de banda que un único usuario o puerto puede utilizar.

El cmdlet Remove-CsAVEdgeConfiguration permite eliminar configuraciones de servidor perimetral A/V aplicadas al sitio o al ámbito de servicio. El cmdlet también se puede ejecutar en la configuración global; sin embargo, la configuración global no se elimina. En su lugar, todas las propiedades contenidas en la colección global se restablecerán con los valores predeterminados.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único para la colección de configuraciones de servidor perimetral A/V que se debe quitar. Para "quitar" la colección global, use la siguiente sintaxis: -Identity global. (Como se ha descrito con anterioridad, la configuración global no se puede quitar; únicamente se pueden restablecer las propiedades con los valores predeterminados). Para quitar una colección de sitios, use una sintaxis similar a ésta: -Identity site:Redmond. Para hacer referencia a las opciones configuradas en el ámbito de servicio, use la sintaxis siguiente:

-Identity service:EdgeServer:atl-cs-001.litwareinc.com

No puede usar caracteres comodín para especificar una identidad de directiva.

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.Edge.MediaRelaySettings. Remove-CsAVEdgeConfiguration acepta la entrada transmitida de objetos de configuración de transmisión de medios. Estos objetos se recuperan mediante el cmdlet Get-CsAVEdgeConfiguration.

Tipos de valores devueltos

Remove-CsAVEdgeConfiguration no devuelve ningún valor ni objeto. En su lugar, el cmdlet elimina las instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Edge.MediaRelaySettings.

Ejemplo

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

Remove-CsAVEdgeConfiguration -Identity site:Redmond

El comando anterior quita las configuraciones de servidor perimetral A/V con la identidad site:Redmond. Después de eliminar la configuración, los servidores perimetrales A/V del sitio Redmond se gobernarán con la configuración global.

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

Get-CsAVEdgeConfiguration -Filter "service:*" | Remove-CsAVEdgeConfiguration

En el Ejemplo 2 se eliminan todas las configuraciones de servidor perimetral A/V aplicadas en el ámbito de servicio. Para ello, en primer lugar el comando llama a Get-CsAVEdgeConfiguration junto con el parámetro Filter; el valor de filtro "service:*" garantiza que únicamente se devolverán configuraciones en el ámbito de servicio. A continuación, la colección filtrada se transfiere a Remove-CsAVEdgeConfiguration, que elimina cada uno de los elementos de la colección.

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

Get-CsAVEdgeConfiguration | Where-Object {$_.MaxBandwidthPerUserKB -lt 5000} | Remove-CsAVEdgeConfiguration

El comando del Ejemplo 3 elimina todas las configuraciones de servidor perimetral A/V cuando el valor de la propiedad MaxBandwidthPerUserKB es inferior a 5.000 kilobits por segundo. Para llevar a cabo esta tarea, en primer lugar el comando usa Get-CsAVEdgeConfiguration sin parámetros adicionales para devolver una colección de todas las configuraciones de servidor perimetral A/V que estén en uso actualmente en la organización. Esta colección se transmite al cmdlet Where-Object, que selecciona únicamente las configuraciones en las que la propiedad MaxBandwidthPerUserKB sea inferior a 5000. La colección filtrada se transmite entonces a Remove-CsAVEdgeConfiguration y se eliminan todos los elementos de esa colección.