Compartir a través de

  • Artículo

Get-CsClientVersionPolicy

 

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

Devuelve información sobre qué clientes (por ejemplo, Microsoft Office Communicator 2007 R2) se admiten en el entorno de Microsoft Lync Server 2010. Las directivas de versión de cliente permiten especificar qué clientes (como Office Communicator 2007 R2) podrán iniciar sesión en su sistema Lync Server 2010.

Sintaxis

Get-CsClientVersionPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsClientVersionPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Descripción detallada

Las directivas de versión de cliente representan una colección de reglas de versión de cliente; a su vez, las reglas de versión de 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 de forma desatendida la aplicación cliente con la última versión (por ejemplo, actualizar Communicator 2007 R2 a Lync 2010).

Las directivas de versión de 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, es posible que desee impedir que los usuarios inicien sesión en Lync Server 2010 a través de 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 de cliente independiente, que permita a dichos usuarios iniciar sesión desde Communicator 2007 R2.

El cmdlet Get-CsClientVersionPolicy permite recuperar todas las directivas de versión de cliente que estén en uso en la organización, así como visualizar las reglas individuales que componen cada una de las directivas.

Es importante reparar en que las directivas de versión de cliente no atañen a los usuarios federados. Estos se rigen por las directivas de versión de 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 ese cliente. Y así será aunque nuestra directiva de versión de 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 de cliente empleadas en la organización federada.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la directiva que se va a devolver. Para devolver la directiva global, use esta sintaxis: -Identity global. Para devolver una directiva configurada en el ámbito de sitio, use la sintaxis siguiente: -Identity "site:Redmond". Para devolver una directiva configurada en el ámbito de servicio, use la sintaxis siguiente: -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 también pueden configurarse en un ámbito por usuario. Para devolver una de estas directivas, use una sintaxis similar a: -Identity "SalesDepartmentPolicy".

Si este parámetro no se incluye, se devolverán todas las directivas de versión de cliente configuradas para su uso en la organización.

Filter

Opcional

Cadena de caracteres

Permite usar caracteres comodín para especificar la directiva o las directivas que se van a recuperar. Por ejemplo, esta sintaxis devuelve todas las directivas que se han configurado en el ámbito del sitio: -Filter "site:*". Esta sintaxis devuelve todas las directivas que se han configurado en el ámbito por usuario: -Filter "tag:*".

No se pueden usar los parámetros Identity y Filter en el mismo comando.

LocalStore

Opcional

Parámetro modificador

Recupera los datos de directivas de versión cliente de la réplica local del Almacén de administración central en lugar de recuperarlos del propio Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsClientVersionPolicy no acepta la entrada transferida.

Tipos de valores devueltos

Get-CsClientVersionPolicy devuelve instancias del objeto de directiva Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersion.

Ejemplo

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

Get-CsClientVersionPolicy

En este primer ejemplo, se llama a Get-CsClientVersionPolicy sin especificar ningún parámetro adicional. Esto hace que Get-CsClientVersionPolicy devuelva una colección de todas las directivas de versión de cliente configuradas para su uso en la organización.

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

Get-CsClientVersionPolicy -Identity site:Redmond

En el ejemplo anterior, Get-CsClientVersionPolicy devuelve todas las directivas de versión de cliente que tienen la identidad site:Redmond. Dado que las identidades deben ser únicas, este comando nunca devolverá más de un elemento.

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

Get-CsClientVersionPolicy -Filter site:*

El Ejemplo 3 devuelve todas las directivas de versión de cliente que se han configurado en el ámbito del sitio. Para ello, se incluyen el parámetro Filter y el valor de filtro "site:*"; dicho valor indica a Get-CsClientVersionPolicy que únicamente devuelva las directivas que tengan una identidad que comience por el valor de cadena "site:".

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

Get-CsClientVersionPolicy | Select-Object -ExpandProperty Rules

El comando que se usa en el Ejemplo 4 muestra información detallada sobre las reglas individuales configuradas para cada directiva de versión de cliente. Para ello, primero se usa Get-CsClientVersionPolicy para recuperar una colección de todas las directivas de versión de cliente configuradas para su uso en la organización. A continuación, la colección se transfiere al cmdlet Select-Object, que usa el filtro ExpandProperty para expandir los valores de la propiedad Rules. Cuando se expande esta propiedad, se muestra información detallada sobre cada regla (incluidos valores de propiedad tales como el número de versión, la versión principal y la secundaria).