Compartir a través de


Remove-CsClientVersionConfiguration

 

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

Quita la colección especificada de las opciones de configuración de la versión de cliente. Las opciones de configuración de la versión de cliente determinan si Microsoft Lync Server 2010 comprueba o no el número de versión de cada aplicación cliente que se inicia en el sistema; si el filtrado de versión de cliente está habilitado, la capacidad de la aplicación cliente de obtener acceso al sistema se basará en la configuración definida en la directiva de versión de cliente adecuada.

Sintaxis

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

Descripción detallada

Lync Server 2010 otorga a los administradores una libertad de acción considerable para especificar el software cliente (y, lo que es igual de importante, el número de versión de dicho software) que pueden utilizar los usuarios para iniciar la sesión en el sistema. Por ejemplo, no hay ningún motivo técnico que requiera que los usuarios inicien sesión en Lync Server 2010 usando Microsoft Lync 2010; desde un punto de vista técnico, no hay ninguna razón que impida que los usuarios inicien sesión usando Microsoft Office Communicator 2007 R2.

Con todo, puede haber otros motivos (no técnicos) por los que prefiera que los usuarios no inicien sesión mediante Office Communicator 2007 R2. Por ejemplo, Office Communicator 2007 R2 no admite todas las características y funciones de Lync 2010 y, como consecuencia, los usuarios que inicien sesión con Office Communicator 2007 R2 tendrán una experiencia diferente que los que lo hagan con Lync 2010. Esto puede crearles dificultades; asimismo, también puede presentar problemas para el personal del servicio de asistencia técnica, que debe prestar soporte a varias aplicaciones cliente diferentes.

Si esto supone un problema para la organización, puede poner en práctica el filtrado de versión de cliente para especificar qué aplicaciones cliente se pueden usar para iniciar sesión en Lync Server 2010. Al instalar Lync Server 2010, se instala y habilita un conjunto de opciones de configuración de versión de cliente. Además de la configuración global, la configuración de versión de cliente también se puede aplicar en el ámbito de sitio.

Cualquier configuración de sitio que cree se podrá eliminar más tarde con el cmdlet Remove-CsClientVersionConfiguration. Tenga en cuenta que también puede ejecutar Remove-CsClientVersionConfiguration con la configuración global. En este caso no se quita la configuración global, sino que se restablecen las propiedades globales a 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-CsClientVersionConfiguration 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-CsClientVersionConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único para la colección de opciones de configuración de versión de cliente que se va a quitar. Para quitar la colección global, use la siguiente sintaxis: -Identity global. (Tenga en cuenta que la configuración global no se quita realmente; en lugar de ello, se restablecen las propiedades globales a los valores predeterminados). Para quitar una recopilación de sitios, use una sintaxis similar a ésta: -Identity site:Redmond. Tenga en cuenta que no puede usar caracteres comodín para especificar el valor de Identity.

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.Policy.ClientVersion.ClientVersionConfiguration. Remove-CsClientVersionConfiguration acepta instancias transferidas del objeto de configuración de versión de cliente.

Tipos de valores devueltos

Ninguno. En su lugar, el cmdlet elimina instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration.

Ejemplo

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

Remove-CsClientVersionConfiguration -Identity site:Redmond

El comando que aparece en el ejemplo 1 elimina las opciones de configuración de versión de cliente que tienen Identity establecido en "site:Redmond".

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

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

En el Ejemplo 2, se eliminan todas las opciones de configuración de versión de cliente que se han aplicado en el ámbito del sitio. Para realizar esta tarea, el comando llama primero a Get-CsClientVersionConfiguration y al parámetro Filter; el valor de filtro "site:*" hace que solo se devuelvan las opciones de configuración de versión de cliente cuyo valor de Identity comience con la cadena "site:". A continuación, la colección filtrada se transfiere a Remove-CsClientVersionConfiguration, que elimina cada uno de los elementos de la colección.

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

Get-CsClientVersionConfiguration | Where-Object {$_.Enabled -eq $False} | Remove-CsClientVersionConfiguration

En el comando anterior, se eliminan todas las opciones de configuración de versión de cliente que se encuentran deshabilitadas actualmente. Para ello, el comando usa primero Get-CsClientVersionConfiguration para devolver una colección de todas las opciones de configuración de versión de cliente que actualmente se usan en la organización. Una vez obtenidos estos datos, la colección se transfiere al cmdlet Where-Object, que selecciona únicamente aquellas configuraciones en las que la propiedad Enabled es igual a False. Desde este punto, la colección filtrada se transfiere a Remove-CsClientVersionConfiguration, que elimina todos los elementos de la colección.