Compartir a través de

  • Artículo

Remove-CsWebServiceConfiguration

 

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

Quita una o varias recopilaciones de opciones de configuración de Servicios web.

Sintaxis

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

Descripción detallada

Muchos componentes de Microsoft Lync Server 2010 están basados en web: usan servicios web o páginas web para llevar a cabo sus tareas. Por ejemplo, los usuarios usan un servicio web cuando buscan contactos nuevos en la libreta de direcciones o cuando usan la expansión de grupos para ver los miembros individuales de un grupo de distribución. Del mismo modo, los componentes, desde las conferencias de acceso telefónico hasta Panel de control de Microsoft Lync Server 2010, utilizan páginas web como interfaz entre Lync Server 2010 y los usuarios.

Los cmdlets CsWebServiceConfiguration permiten a los administradores controlar las opciones de configuración de los Servicios web en toda la organización. Esto incluye la administración de la expansión de grupos, la configuración de certificados y los métodos de autenticación permitidos. Al poder configurar diferentes opciones en los ámbitos global, de sitio y de servicio (aunque solamente con el servicio Web Services), puede personalizar las capacidades deServicios web para diferentes usuarios y ubicaciones.

Si se crean configuraciones personalizadas de Servicios web en el ámbito del sitio o del servicio, éstas podrán eliminarse con el cmdlet Remove-CsWebServiceConfiguration. Tenga en cuenta que también puede ejecutar Remove-CsWebServiceConfiguration para la recopilación global de configuraciones de Servicios web. Sin embargo, en ese caso la recopilación global no se quitará; ello se debe a que Lync Server no permite quitar configuraciones globales. Lo que ocurrirá es que todas las propiedades de la recopilación global se revertirán a los valores predeterminados. Por ejemplo, suponiendo que cambie el valor de MaxGroupSizeToExpand a 500. Dado que el valor predeterminado para esta propiedad es 100, "quitar" la recopilación global restablecerá el valor de la propiedad MaxGroupSizeToExpand a 100.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Remove-CsWebServiceConfiguration en forma local: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsWebServiceConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de las opciones de configuración de Servicios web que se van a quitar. Para quitar opciones configuradas en el ámbito del sitio, use una sintaxis similar a: -Identity "site:Redmond". Para quitar opciones configuradas en el ámbito del servicio, use una sintaxis similar a: -Identity "service:WebServer:atl-cs-001.litwareinc.com".

Remove-CsWebServiceConfiguration también puede ejecutarse para la recopilación global. Aunque en este caso no se quitará la recopilación, sino que todas las propiedades se restablecerán a los valores predeterminados. Para restablecer la recopilación global, use esta sintaxis: -Identity global.

Force

Opcional

Parámetro modificador

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

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings. Remove-CsWebServiceConfiguration acepta entradas canalizadas del objeto de configuraciones de Servicios web,

Tipos de valores devueltos

Ninguno. En cambio, Remove-CsWebServiceConfiguration elimina las instancias existentes del objeto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings.

Ejemplo

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

Remove-CsWebServiceConfiguration -Identity site:Redmond

El comando anterior quita la configuración de Servicios web del sitio Redmond.

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

Get-CsWebServiceConfiguration -Filter "site:*" | Remove-CsWebServiceConfiguration

En el Ejemplo 2 se quitan todas las opciones de Servicios web configuradas en el ámbito del sitio. Para llevar a cabo esta tarea, primero el comando llama a Get-CsWebServiceConfiguration y el parámetro Filter; el valor de filtro "site:*" se asegura de que sólo de recuperen aquellas opciones cuyo parámetro Identity comienza con los caracteres "site:" los caracteres "site:". A continuación, la recopilación filtrada se transfiere a Remove-CsWebServiceConfiguration, que elimina cada uno de los elementos de la recopilación.

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

Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $False} | Remove-CsWebServiceConfiguration

El comando que se muestra en el Ejemplo 3 elimina todas las opciones de configuración de Servicios web en las que se ha deshabilitado la expansión de grupos. Para ello, el comando primero llama a Get-CsWebServiceConfiguration sin ningún parámetro, a fin de devolver una recopilación de todas las configuraciones de Servicios web que se encuentran actualmente en uso en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, el cual selecciona únicamente aquellas configuraciones donde la propiedad EnableGroupExpansion es igual a False. A continuación, la recopilación filtrada se canaliza a Remove-CsWebServiceConfiguration, que elimina cada uno de los elementos de la recopilación.