Compartir a través de

  • Artículo

Grant-CsClientVersionPolicy

 

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

Asigna una directiva de versión cliente en el ámbito global, en el ámbito de sitio o de servicio, o bien por usuario. 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

Grant-CsClientVersionPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-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, 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 Office Communicator 2007 R2 a Microsoft Lync 2010) sin enviar ningún mensaje.

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 esta aplicación cliente antigua no admite las mismas características y prestaciones que Lync 2010. Sin embargo, debido a conflictos de hardware o software es posible que tenga seleccionado un grupo de usuarios que no puedan actualizar 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.

El cmdlet Grant-CsClientVersionPolicy permite asignar directivas de versión cliente a usuarios individuales. Cuando se crea una directiva por usuario, dicha directiva no se asigna automáticamente a ningún usuario; la asignación no se lleva a cabo hasta que usted llama a Grant-CsClientVersionPolicy para asignar de forma explícita la directiva a un usuario o a un conjunto de usuarios.

Es importante tener en cuenta que las directivas de versión cliente no se aplican 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 su organización utilizando este cliente. Así será aunque su directiva de versión cliente bloquee el uso del cliente A. Las directivas de versión cliente aplicadas en su organización no invalidarán las directivas de versión cliente empleadas en una 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 Grant-CsClientVersionPolicy de forma local: RTCUniversalUserAdmins. 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 "Grant-CsClientVersionPolicy"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Parámetro de Id. de usuario

Indica la identidad de la cuenta de usuario a la que se debe asignar la directiva. Las identidades de usuario pueden especificarse mediante uno de los cuatro formatos siguientes: 1) la dirección SIP del usuario; 2) el nombre principal del usuario (UPN); 3) el nombre del dominio y el nombre de inicio de sesión del usuario, con formato dominio\nombre (por ejemplo, litwareinc\kenmyer), y 4) el nombre para mostrar de Active Directory del usuario (por ejemplo, Ken Myer). Las identidades de usuario también se pueden consultar utilizando el nombre distintivo Active Directory del usuario.

Asimismo, puede usar el asterisco (*) como comodín al usar el nombre para mostrar como identidad del usuario. Por ejemplo, la identidad "* Smith" devuelve todos los usuarios con un nombre para mostrar que termine con el valor de cadena de caracteres " Smith".

PolicyName

Requerido

Cadena de caracteres

"Nombre" de la directiva que se va a asignar. PolicyName es, simplemente, la identidad de la directiva menos el ámbito de directiva ("tag:") Por ejemplo, una directiva que tiene la identidad tag:Redmond tiene un parámetro PolicyName igual a Redmond; una directiva con la identidad tag:RedmondClientVersionPolicy tiene un parámetro PolicyName igual a RedmondClientVersionPolicy. Para cancelar la asignación de una directiva por usuario asignada previamente a un usuario, establezca el parámetro PolicyName en un valor nulo ($Null).

DomainController

Opcional

Cadena de caracteres

Permite especificar un controlador de dominio al que conectarse cuando se asigna la directiva. Si no se incluye este parámetro, el cmdlet usará el primer controlador de dominio disponible.

PassThru

Opcional

Parámetro modificador

Si está presente, hará que el cmdlet envíe el objeto de usuario (u objetos) a través de la canalización de Windows PowerShell. De forma predeterminada, Grant-CsClientVersionPolicy no envía objetos a través de la canalización.

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

Valor de la cadena o el objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Grant-CsClientVersionPolicy acepta la entrada transferida de valores de cadena que representan la identidad de una cuenta de usuario. El cmdlet también acepta la entrada transferida de objetos de usuario.

Tipos de valores devueltos

De forma predeterminada, Grant-CsClientVersionPolicy no devuelve objetos ni valores. Sin embargo, si se incluye el parámetro PassThru, el cmdlet devolverá las instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

Ejemplo

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

Grant-CsClientVersionPolicy -Identity "Ken Myer" -PolicyName "RedmondClientVersionPolicy"

En el Ejemplo 1, la directiva de versión cliente RedmondClientVersionPolicy se asigna al usuario Ken Myer.

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

Get-CsUser -LdapFilter "l=Redmond" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

El comando mostrado en el Ejemplo 2 asigna la directiva de versión cliente RedmondClientVersionPolicy a todos los usuarios que trabajan en la ciudad de Redmond. Para ello, el comando usa en primer lugar Get-CsUser y el parámetro LdapFilter para recuperar la colección adecuada de cuentas de usuario; el valor de filtro "l=Redmond" (donde "l" es la letra L minúscula, el nombre de atributo LDAP de "localidad") limita la recuperación de datos a los usuarios que trabajan en la ciudad de Redmond. A continuación, dicha colección se transfiere a Grant-CsClientVersionPolicy, que asigna la directiva especificada a todos los usuarios incluidos en la colección.

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

Get-CsUser -OU "ou=Redmond,ou=North America,dc=litwareinc,dc=com" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

En el Ejemplo 3, la directiva de versión cliente RedmondClientVersionPolicy se asigna a todos los usuarios de una unidad organizativa (OU) específica. Para realizar esta tarea, el comando primero llama a Get-CsUser y al parámetro OU; el valor del parámetro representa el nombre distintivo de la OU a cuyos usuarios se debe asignar la directiva de versión cliente (ou=Redmond,ou=North America,dc=litwareinc,dc=com). Una vez recuperadas las cuentas de usuario, la colección se transfiere a Grant-CsClientVersionPolicy, que asigna RedmondClientVersionPolicy a cada uno de los usuarios.

-------------------------- Ejemplo 4 --------------------------

Get-CsUser -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

El comando anterior asigna la directiva de versión cliente RedmondClientVersionPolicy a todos los usuarios a los que anteriormente se haya asignado la directiva de voz RedmondVoicePolicy. Para ello, el comando primero llama a Get-CsUser con el parámetro Filter; el valor de filtro {VoicePolicy -eq "RedmondVoicePolicy"} garantiza que las únicas cuentas de usuario devueltas sean aquellas cuya propiedad VoicePolicy sea igual a "RedmondVoicePolicy". A continuación, las cuentas de usuario resultantes se transfieren a Grant-CsClientVersionPolicy y se les asigna la directiva de versión cliente RedmondClientVersionPolicy.

-------------------------- Ejemplo 5 --------------------------

Get-CsUser | Grant-CsClientVersionPolicy -PolicyName $Null

En el Ejemplo 5, a todos los usuarios de la organización se les quita la asignación de las directivas de versión cliente que tuvieran asignadas, usuario por usuario. Para ello, el primer comando usa Get-CsUser para recuperar una colección de todos los usuarios de la organización que se han habilitado para Lync Server. Esta colección se transfiere a Remove-CsClientVersionPolicy, que quita las asignaciones de directivas de versión cliente por usuario que se hubieran asignado a esos usuarios. Para ello, se establece el valor del parámetro PolicyName en $null.