Compartir a través de

  • Artículo

Set-CsClientVersionPolicy

 

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

Modifica una directiva de versión cliente existente. Las directivas de versión cliente permiten especificar qué clientes (como Microsoft Office Communicator 2007 R2) podrán iniciar sesión en su sistema Microsoft Lync Server 2010.

Sintaxis

Set-CsClientVersionPolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Rules <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsClientVersionPolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Rules <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Las directivas de versión cliente representan una colección de reglas de versiones cliente; a su vez, las reglas de versiones cliente se usan para determinar qué aplicaciones pueden iniciar sesión en Lync Server 2010. Cuando un usuario intenta iniciar sesión en Lync Server 2010, su aplicación cliente envía un encabezado SIP al servidor; este encabezado incluye información detallada sobre la aplicación en sí, como el número de versión principal, el número de versión secundaria y el número de versión de compilación del software. A continuación, la información de versiones incluida en el encabezado SIP se compara con una recopilación de reglas de versiones cliente para ver si alguna de estas reglas afecta a la aplicación en cuestión. Si existe dicha regla, el servidor de Lync Server 2010 llevará a cabo la acción especificada por la regla, Por ejemplo, la regla podría indicar a Lync Server 2010 que permita el inicio de sesión, que lo bloquee, o bien que permita el inicio de sesión pero que, a continuación, actualice la aplicación cliente con la última versión (por ejemplo, actualizar Communicator 2007 R2 a Microsoft Lync 2010).

Las directivas de versión cliente, que se pueden aplicar en el ámbito global, el ámbito de sitio y de servicio (solo para el servicio de registrador) o en el ámbito por usuario, aportan flexibilidad a la hora de determinar qué aplicaciones cliente se pueden usar para obtener acceso al sistema. Por ejemplo, podría querer impedir que los usuarios inicien sesión en Lync Server 2010 usando Communicator 2007 R2 porque no es compatible con las mismas funciones y características que Lync 2010. Sin embargo, debido a conflictos de hardware o software, es posible que tenga un grupo de usuarios que no puedan actualizar su sistema a Lync 2010. En tal caso, puede crear una regla independiente, así como una directiva de versión cliente independiente, que permita a dichos usuarios iniciar sesión desde Communicator 2007 R2.

Las directivas de versión cliente se pueden modificar en cualquier momento; modificar una directiva de versión cliente normalmente significa agregar nuevas reglas, eliminar las existentes o modificar las propiedades de una regla existente (por ejemplo, cambiar la acción de una regla de Allow a Block). Estos cambios pueden realizarse con el cmdlet Set-CsClientVersionPolicy. Sin embargo, le será más fácil realizar estas modificaciones utilizando el cmdlet CsClientVersionPolicyRule.

Por otro lado, Set-CsClientVersionPolicy permite copiar de forma fácil un conjunto entero de reglas de una directiva de versión cliente a otra. Para obtener más información, vea la sección de ejemplos de este tema de Ayuda.

Es importante reparar en que las directivas de versión cliente no atañen a los usuarios federados. Estos se rigen por las directivas de versión cliente utilizadas en su propia organización. Por ejemplo, supongamos que un usuario federado utiliza el cliente A, un cliente aceptado por la organización federada. Siempre y cuando la organización federada permita el uso del cliente A, este usuario podrá comunicarse con nuestra organización utilizando este cliente. Y así será aunque nuestra directiva de versión cliente bloquee el uso del cliente A. Las directivas de versión de cliente vigentes en nuestra organización no anulan las directivas de versión cliente empleadas en la organización federada.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la directiva que se va a modificar. Para modificar la directiva global, use esta sintaxis: -Identity global. Para modificar una directiva configurada en el ámbito de sitio, use una sintaxis similar a ésta: -Identity "site:Redmond". Para modificar una directiva configurada en el ámbito de servicio, use una sintaxis similar a: -Identity "Registrar:atl-cs-001.litwareinc.com". El servicio de registrador es el único servicio que puede hospedar una directiva de versión cliente.

Las directivas por usuario también pueden modificarse con este cmdlet. Para modificar una directiva de usuario, use la sintaxis siguiente: -Identity "SalesDepartmentPolicy".

Si este parámetro no se incluye, Set-CsClientVersionPolicy modificará la directiva global.

Instance

Opcional

Objeto ClientVersionPolicy

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

Description

Opcional

Cadena de caracteres

Permite proporcionar información explicativa sobre una directiva. Por ejemplo, puede proporcionar información describiendo los usuarios a los que se debe asignar la directiva.

Rules

Opcional

Modificador de lista PS

Recopilación de las reglas de directiva de cliente que se han asignado a la 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.Policy.ClientVersion.ClientVersionPolicy. Remove-CsClientVersionPolicy acepta las instancias transferidas del objeto de directiva de versión de cliente.

Tipos de valores devueltos

Set-CsClientVersionPolicy no devuelve ningún valor ni objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy.

Ejemplo

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

Set-CsClientVersionPolicy -Identity site:Redmond -Rules $Null

$x = Get-CsClientVersionPolicy -Identity site:Dublin | Select-Object -ExpandProperty Rules

Set-CsClientVersionPolicy -Identity site:Redmond -Rules $x

Los comandos mostrados en el Ejemplo 1 copian todas las reglas de versiones cliente de una directiva de versión cliente a otra. Para ello, el primer comando del ejemplo usa Set-CsClientVersionPolicy para quitar todas las reglas de la directiva site:Redmond, definiendo el valor de la propiedad Rules en nulo. Una vez eliminadas las reglas, el segundo comando del ejemplo usa Get-CsClientVersionPolicy para recuperar todas las reglas de directivas de versión cliente configuradas para la directiva site:Dublin. Estas reglas se almacenan en una variable denominada $x.

En el comando final, se vuelve a invocar Set-CsClientVersionPolicy, esta vez estableciendo la propiedad Rules de la directiva Redmond en $x. De este modo, se copian de forma eficaz todas las reglas de la directiva site:Dublin y se agregan a la directiva site:Redmond.