Compartir a través de


Remove-CsProxyConfiguration

 

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

Quita una colección existente de opciones de configuración del servidor proxy.

Sintaxis

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

Descripción detallada

Microsoft Lync Server 2010 permite administrar los servidores proxy a través de las opciones de configuración de servidor proxy. Estas opciones de configuración, que se pueden aplicar en el ámbito global o en el ámbito del servicio (si bien únicamente para los servicios de Servidor perimetral y de registrador) permiten controlar funciones como los protocolos de autenticación que se pueden usar en los extremos de clientes y si se usará compresión en las conexiones de servidor proxy entrantes y salientes. Al instalar Lync Server 2010, se crea una recopilación global de opciones de configuración de servidor proxy automáticamente. Como se ha mencionado, también puede crear colecciones adicionales en el ámbito de servicio.

Para quitar posteriormente cualquier configuración del servidor proxy que haya creado, use el cmdlet Remove-CsProxyConfiguration. También puede ejecutar Remove-CsProxyConfiguration con la configuración global. Sin embargo, en ese caso no se quitará la configuración global, ya que Lync Server no permite quitar configuraciones globales. En su lugar, todas las propiedades de la colección global se restablecerán con los valores predeterminados. Por ejemplo, de forma predeterminada, la configuración del servidor proxy permite a los clientes usar el protocolo Kerberos para la autenticación. Puede cambiar la configuración global para deshabilitar el uso de Kerberos. Sin embargo, si ejecuta Remove-CsProxyConfiguration en la colección global, la propiedad en cuestión (UseKerberosForClientToProxyAuth) se restablecerá con el valor predeterminado, y Kerberos estará de nuevo habilitado para su uso como protocolo de autenticación.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de las opciones de configuración del servidor proxy que se van a quitar, por ejemplo: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Remove-CsProxyConfiguration se puede ejecutar también en la configuración global. Sin embargo, en ese caso no se quitará la configuración. En su lugar, todas las propiedades de la colección global se restablecerán con los valores predeterminados.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no son graves y que pueden surgir 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.SipProxy.ProxySettings. Remove-CsProxyConfiguration acepta instancias transferidas del objeto de configuración de proxy.

Tipos de valores devueltos

Ninguno. En su lugar, Remove-CsProxyConfiguration elimina las instancias existentes del objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.

Ejemplo

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

Remove-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-011.litwareinc.com 

El comando mostrado en el ejemplo 1 elimina las opciones de configuración de proxy cuyo parámetro Identity está establecido en service:EdgeServer:atl-edge-litwareinc.com.

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

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

En el Ejemplo 2 se eliminan todas las opciones de configuración de proxy que se aplican al ámbito de servicio. Para llevar a cabo esta tarea, el comando llama primero a Get-CsProxyConfiguration junto con el parámetro Filter. El valor del filtro "service:*" garantiza que se devolverán solo las configuraciones de proxy cuya Identidad empiece por "service:" . A continuación, la colección filtrada se transfiere a Remove-CsProxyConfiguration, que elimina cada uno de los elementos de la colección.

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

Get-CsProxyConfiguration | Where-Object {$_.TreatAllClientsAsRemote -eq $True} | Remove-CsProxyConfiguration

El comando anterior elimina todas las opciones de configuración de proxy que traten a todos los clientes como clientes remotos. Para hacerlo, se llama primero a Get-CsProxyConfiguration sin ningún parámetro para devolver una colección de todas las opciones de configuración del servidor proxy que se usan actualmente. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona únicamente aquellas opciones en las que la propiedad TreatAllClientsAsRemote es igual a True. Después, este subconjunto de opciones de configuración de proxy se transfiere a Remove-CsProxyConfiguration, que quita todas las opciones de la colección.