Compartir a través de

  • Artículo

Remove-CsUserServicesConfiguration

 

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

Quita la recopilación existente de las opciones de configuración de Servicios del usuario. El servicio Servicios de usuario se usa para ayudar a mantener información de presencia y administrar conferencias.

Sintaxis

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

Descripción detallada

Microsoft Lync Server 2010 confía en el servicio Servicios de usuario para ayudar a mantener la información de presencia para los usuarios y administrar las reuniones y las conferencias. A su vez, los cmdlets CsUserServicesConfiguration se usan para administrar las opciones de configuración de Servicios del usuario en el ámbito de servicios, del sitio y a nivel global. (Tenga en cuenta que el único servicio que puede hospedar opciones de configuración de Servicios del usuario es el propio servicio de Servicios del usuario.) Esta configuración permite determinar aspectos como el número de contactos que un usuario puede tener; el número de reuniones que un usuario puede haber programado en un momento dado y el tiempo durante el cual una reunión determinada puede permanecer activa.

El cmdlet Remove-CsUserServicesConfiguration le permite eliminar las opciones de configuración de Servicios del usuario que se han aplicado en el ámbito del sitio o del servicio. Este cmdlet además se puede ejecutar con la recopilación global. Sin embargo, en ese caso, no se eliminarán las configuraciones globales; eso ocurre porque no se puede eliminar ese tipo de configuraciones. En su lugar, todas las propiedades de la recopilación global se restablecerán a sus valores predeterminados. Por ejemplo, si ha cambiado el valor MaxContacts de configuraciones globales en 500 y después ejecuta Remove-CsUserServciesConfiguration, MaxContacts se restablecerá al valor predeterminado de 250.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de las opciones de configuración de Servicios del usuario que se quitará. Para eliminar las opciones configuradas en el ámbito del sitio, use una sintaxis similar a la siguiente: -Identity site:Redmond. Para eliminar las configuraciones en el nivel de servicio, use una sintaxis como la siguiente: -Identity service:UserServer:atl-cs-001.litwareinc.com.

Remove-CsUserServicesConfiguration también puede ejecutarse para la recopilación global. Sin embargo, en ese caso, no se eliminará la recopilación global. En su lugar, todas las propiedades de esa recopilación se restablecerán a sus valores predeterminados.

Force

Opcional

Parámetro modificador

Evita que se muestre cualquier mensaje de error no grave que pueda surgir cuando se ejecuta 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.UserServices.UserServicesSettings. Remove-CsUserServicesConfiguration acepta las instancias canalizadas del objeto de la configuración de Servicios del usuario.

Tipos de valores devueltos

Ninguno. En su lugar, Remove-CsUserServicesConfiguration elimina las instancias existentes del objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.

Ejemplo

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

Remove-CsUserServicesConfiguration -Identity site:Redmond

En el comando que se muestra en el Ejemplo 1, se quitan las opciones de configuración de Servicios del usuario del sitio de Redmond (-Identity site:Redmond).

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

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

En el ejemplo 2, se eliminarán todas las opciones de configuración de Servicios del usuario que se han aplicado al ámbito de servicio. Para ello, el comando llama a Get-CsUserServicesConfiguration junto con el parámetro Filter. El valor de filtro "service:*" limita los datos devueltos a las opciones configuradas en el ámbito de servicio (es decir, las configuraciones que tienen una identidad que comienza con los caracteres "service:"). A continuación, la recopilación filtrada se transfiere a Remove-CsUserServicesConfiguration, que elimina cada uno de los elementos de la recopilación.

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

Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 250} | Remove-CsUserServicesConfiguration

El comando anterior quita todas las opciones de configuración de Servicios del usuario que permite a los usuarios tener más de 250 contactos. Para realizar esta tarea, el comando primero llama a Get-CsUserServicesConfiguration sin parámetros, a fin de devolver una recopilación de las opciones de configuración de Servicios del usuario en uso actualmente. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona solo aquellas configuraciones cuyo valor de la propiedad MaxContacts es mayor que (-gt) 250. Esas configuraciones después se canalizan al cmdlet Remove-CsUserServicesConfiguration y se quitan con ese cmdlet.