Compartir a través de


Get-CsClientVersionConfiguration

 

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

Recupera información sobre la recopilación especificada de configuraciones de versión de cliente en uso en la organización. Las opciones de configuración de versión de cliente definen si Microsoft Lync Server 2010 comprueba o no el número de versión de cada aplicación cliente que inicia sesión en el sistema. Si está habilitado el filtrado de versión de cliente, la capacidad de la aplicación cliente para tener acceso al sistema dependerá de las opciones configuradas en la directiva de versión de cliente correspondiente.

Sintaxis

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

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

Descripción detallada

Lync Server 2010 ofrece a los administradores bastante libertad para especificar el software cliente, y el número de versión de dicho software, que pueden usar los usuarios para conectarse al sistema. Por ejemplo, no hay ningún motivo técnico que requiera que los usuarios se conecten a Lync Server 2010 usando Microsoft Lync 2010; no hay ninguna limitación técnica que impida que los usuarios inicien sesión usando Microsoft Office Communicator 2007 R2.

Sin embargo es posible que, por motivos no técnicos, prefiera que los usuarios no inicien sesión mediante Office Communicator 2007 R2. Por ejemplo, Office Communicator 2007 R2 no admite todas las funciones y funcionalidades 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 se conecten usando Lync 2010. Esto puede provocar problemas para los usuarios, y también para el personal de asistencia técnica, que debe ofrecer asistencia para diferentes aplicaciones cliente.

Si esto supone un problema para su organización, puede utilizar el filtrado de versión de cliente para especificar qué aplicaciones cliente pueden usarse 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. Esta configuración se usa para determinar si se habilita el filtrado de versión de cliente. Además de la configuración global, también se pueden aplicar opciones de configuración de versión de cliente en el ámbito de sitio; en estos casos, la configuración del sitio tendrá prioridad sobre la configuración global.

El cmdlet Get-CsClientVersionConfiguration permite recuperar información sobre las opciones de configuración de versión de cliente que utiliza actualmente la organización. Tenga en cuenta que este cmdlet no devuelve información sobre qué aplicaciones cliente están permitidas y cuáles no lo están. Para recuperar esta información, utilice Get-CsClientVersionPolicy.

La configuración de versión de cliente no es una función de seguridad. La tecnología se basa en la información que suministran las aplicaciones cliente y no intenta verificar si una aplicación es realmente la aplicación especificada, ni si el número de versión suministrado es el real.

Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Get-CsClientVersionConfiguration localmente los miembros de los siguientes grupos: 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 (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsClientVersionConfiguration"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Indica el identificador único de la recopilación de opciones de configuración de versión de cliente que quiere que se devuelva. Para hacer referencia a la configuración global, use esta sintaxis: -Identity global. Para hacer referencia a una recopilación configurada en el ámbito de sitio, use una sintaxis similar a ésta: -Identity site:Redmond. No puede usar caracteres comodín para especificar una identidad. Si necesita usar caracteres comodín, incluya el parámetro Filter.

Si no se especifica este parámetro, Get-CsClientVersionConfiguration devolverá una recopilación de todas las opciones de configuración de versión de cliente que utiliza la organización.

Filter

Opcional

Cadena de caracteres

Permite usar caracteres comodín para devolver una o varias recopilaciones de opciones de configuración de versión de cliente. Para devolver una recopilación de todas las opciones de configuración del sitio, use esta sintaxis: -Filter site:*. Para devolver una recopilación de todas las configuraciones que tengan el valor de cadena de caracteres "EUROPA" en cualquier parte de Identity (la única propiedad que se puede filtrar), use esta sintaxis: -Filter *EUROPA*.

LocalStore

Opcional

Parámetro modificador

Recupera los datos de configuración de versión de cliente a partir de la réplica local del Almacén de administración central, en lugar del propio Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsClientVersionConfiguration no acepta la entrada por canalización.

Tipos de valores devueltos

Get-CsClientVersionConfiguration devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration.

Ejemplo

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

Get-CsClientVersionConfiguration

En el primer ejemplo, se llama a Get-CsClientVersionConfiguration sin especificar ningún parámetro adicional. Get-CsClientVersionConfiguration devuelve una recopilación de todas las opciones de configuración de versión de cliente que utiliza la organización.

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

Get-CsClientVersionConfiguration -Identity site:Redmond

En el ejemplo anterior, Get-CsClientVersionConfiguration devuelve todas las opciones de configuración de versión de cliente que tengan el valor de Identity site:Redmond. Como las identidades deben ser únicas, este comando nunca devolverá más de un elemento.

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

Get-CsClientVersionConfiguration -Filter "site:*"

El Ejemplo 3 devuelve todas las opciones de configuración de versión de cliente aplicadas en el ámbito de sitio. Para ello, se incluyen el parámetro Filter y el valor de filtro "site:*". El valor del filtro le ordena a Get-CsClientVersionConfiguration que devuelva sólo las configuraciones cuya identidad comience con el valor alfanumérico "site:".

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

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

El ejemplo anterior devuelve todas las opciones de configuración de versión de cliente que están deshabilitadas. Para ello, el comando usa primero Get-CsClientVersionConfiguration para devolver una recopilación de todas las opciones de versión de cliente configuradas para su uso en la organización. Esta recopilación se transfiere al cmdlet Where-Object, que aplica un filtro para limitar la colección e incluir sólo las configuraciones cuya propiedad Enabled es igual a False.