Compartir a través de

  • Artículo

Set-CsClientVersionConfiguration

 

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

Modifica la recopilación especificada de opciones de configuración de la versión del cliente. Las opciones de configuración de versión de cliente determinan si Microsoft Lync Server 2010 comprueba el número de versión de cada aplicación cliente que se conecta al sistema. Si este filtrado de versión de cliente está activado, la capacidad de cada aplicación cliente de tener acceso al sistema dependerá de las opciones configuradas en la directiva de versión de cliente correspondiente.

Sintaxis

Set-CsClientVersionConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsClientVersionConfiguration [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Lync Server 2010 le brinda a los administradores flexibilidad considerable cuando se trata de especificar el software del cliente (también es igual de importante el número de versión del software) que los usuarios pueden usar para iniciar sesión en el 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; desde un punto de vista técnico, no hay ninguna razón que impida que los usuarios se conecten usando Microsoft Office Communicator 2007 R2.

Sin embargo, puede haber otros motivos, no técnicos, por los que prefiera que los usuarios no se conecten usando Office Communicator 2007 R2. Por ejemplo, Office Communicator 2007 R2 no admite todas las funciones y herramientas 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. Eso podría ocasionar dificultades a sus usuarios; además, podría ocasionar dificultades para el personal del departamento de soporte técnico, que deberá brindar soporte para diversas aplicaciones de clientes diferentes.

Si supone un problema para su organización, puede poner en práctica 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. Estas configuraciones se usan para determinar si está habilitado (o no) el filtrado de versión de clientes. 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 Set-CsClientVersionConfiguration le permite modificar una recopilación existente de opciones de configuración de versiones de clientes.

Tenga en cuenta que la configuración de versión de cliente no es una característica 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énes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Set-CsClientVersionConfiguration de forma local: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Representa el identificador único de las opciones de configuración de versión del cliente que se modificarán. Para modificar las configuraciones globales, use una sintaxis como la siguiente: -Identity global. Para modificar las configuraciones asignadas al ámbito del sitio, use una sintaxis similar a la siguiente: "site:Redmond".

Si este parámetro no está incluido, Set-CsClientVersionConfiguration se configurarán automáticamente las opciones globales.

Instance

Opcional

Objetos ClientVersionPolicy

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

DefaultAction

Opcional

Cadena de caracteres

Indica la acción que se llevará a cabo si un usuario intenta iniciar sesión desde una aplicación cliente con un número de versión que no se encuentre en la directiva de versión de cliente correspondiente. Se debe configurar DefaultAction con uno de los siguientes valores:

Allow. Se permitirá el inicio de sesión a la aplicación de clientes.

AllowWithUrl: la aplicación cliente podrá iniciar sesión. Además, aparecerá un cuadro de mensaje que mostrará al usuario la dirección URL de una página web en la que el usuario puede descargar la aplicación cliente aprobada. La dirección URL de esta página web debe especificarse como el valor de la propiedad DefaultUrl.

Block. Se evitará el inicio de sesión a la aplicación de clientes.

BlockWithUrl. Se evitará el inicio de sesión a la aplicación de clientes. Sin embargo, el mensaje de acceso denegado mostrará al usuario la dirección URL de una página web en la que el usuario puede descargar la aplicación cliente aprobada. La dirección URL de esta página web debe especificarse como el valor de la propiedad DefaultUrl.

Se ignorará la propiedad si la propiedad Enabled se ha configurado en False. Si la propiedad Enabled está definida en False, no se realizará ningún tipo de filtrado de versión de cliente.

DefaultUrl

Opcional

Cadena de caracteres

Especifica la dirección URL de la página web en la que los usuarios pueden descargar una aplicación cliente aprobada. Si se ha especificado y si DefaultAction se ha configurado en BlockWithURL, esta URL aparecerá en el cuadro de mensaje "Acceso denegado" que se muestra cada vez que un usuario intenta iniciar sesión desde una aplicación de clientes no compatible.

Enabled

Opcional

Booleano

indica si el filtrado de versión de clientes está habilitado o deshabilitado. Si la propiedad Enabled es True, el servidor comprobará el número de versión de cada aplicación de cliente que intente iniciar sesión; a continuación, el servidor permitirá o denegará el acceso según la directiva de versión de clientes apropiada. Si la propiedad Enabled está definida en False, se permitirá iniciar sesión a cualquier aplicación cliente compatible.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Booleano

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration. Set-CsClientVersionConfiguration acepta las instancias canalizadas del objeto de la configuración de versión de cliente.

Tipos de valores devueltos

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

Ejemplo

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

Set-CsClientVersionConfiguration -Identity site:Redmond -Enabled $False

En el Ejemplo 1, se usa Set-CsClientVersionConfiguration para modificar la recopilación de configuraciones con la identidad "site:Redmond". En este caso, el parámetro Enabled se configura en False a fin de deshabilitar las opciones de configuración de la versión de cliente.

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

Get-CsClientVersionConfiguration | Set-CsClientVersionConfiguration -DefaultURL "https://litwareinc.com/csclients"

En el ejemplo anterior, la propiedad DefaultUrl se modifica para todas las opciones de configuración de versión de cliente que se usan actualmente en la organización. Para ello, el comando primero llama a Get-CsClientVersionConfiguration sin ningún otro parámetro adicional para devolver todas las opciones de configuración de la versión de cliente. Esa información se canaliza a Set-CsClientVersionConfiguration, que configura el valor de DefaultUrl para cada recopilación de configuración en https://litwareinc.com/csclients.

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

Get-CsClientVersionConfiguration | Where-Object {$_.DefaultAction -eq "Block"} | Set-CsClientVersionConfiguration -DefaultAction "BlockWithUrl" -DefaultURL "https://litwareinc.com/csclients"

En el ejemplo 3, las modificaciones se realizan para todas las opciones de configuración de versión de cliente donde DefaultAction está configurado actualmente en Block. Para ello, el comando primero usa Get-CsClientVersionConfiguration para devolver todas las opciones de configuración de la versión de cliente en uso. Luego, esta información se canaliza al cmdlet Where-Object, que únicamente selecciona los elementos en los que la propiedad DefaultAction es igual a "Block". A su vez, esa recopilación filtrada después se canaliza a Set-CsClientVersionConfiguration, que hace dos cosas con cada elemento de la recopilación: 1) configura DefaultAction en BlockWithUrl; y, 2) configura DefaultUrl en https://litwareinc.com/csclients.