Compartir a través de

  • Artículo

Set-CsClientVersionPolicyRule

 

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

Modifica una o más reglas de directiva de versión de cliente configuradas actualmente en su organización.

Sintaxis

Set-CsClientVersionPolicyRule [-Identity <XdsIdentity>] [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <Nullable>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

Set-CsClientVersionPolicyRule [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <Nullable>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Las reglas de versiones de clientes se usan para determinar qué aplicaciones cliente pueden usarse para iniciar sesión en Microsoft 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. La información de versión después se controla con una recopilación de reglas de versión de cliente a fin de observar si alguna regla se aplica a una aplicación en particular. Por ejemplo, supongamos que un usuario intenta iniciar sesión por medio de Microsoft Office Communicator 2007 R2. Antes de que el usuario inicie sesión en Lync Server 2010, el sistema comprobará la existencia de una regla de versión de cliente que se aplique a Office Communicator 2007 R2. Si existe dicha regla, Lync Server 2010 llevará a cabo la acción especificada por la regla. Esa acción deberá ser una de las siguientes:

Allow. Se permitirá que el usuario inicie sesión.

AllowAndUpgrade. El usuario podrá iniciar sesión, y su copia de Communicator 2007 R2 se actualizará automáticamente a la versión más reciente de Lync. Las actualizaciones se llevan a cabo por medio de Microsoft Update o Windows Server Update Services, en función del modo en que se ha configurado el sistema.

AllowWithUrl. El usuario podrá iniciar sesión y aparecerá un mensaje con la dirección URL donde se puede descargar la versión más reciente de Lync para llevar a cabo su instalación. La dirección URL debe dirigirlo a un sitio web creado por usted mismo, dicho sitio no se crea automáticamente cuando instala Lync Server.

Block. El usuario podrá iniciar sesión.

BlockAndUpgrade. El usuario no podrá iniciar sesión, sin embargo, su copia de Communicator 2007 R2 se actualizará automáticamente a la versión más reciente de Lync. A continuación, el usuario puede intentar iniciar sesión mediante la nueva aplicación cliente. Las actualizaciones se llevan a cabo por medio de Microsoft Update o Windows Server Update Services, en función del modo en que se ha configurado el sistema.

BlockWithUrl. El usuario no podrá iniciar sesión, pero se mostrará un mensaje con la dirección URL donde se puede descargar la versión más reciente de Lync para llevar a cabo su instalación. La dirección URL debe dirigirlo a un sitio web creado por usted mismo, dicho sitio no se crea automáticamente cuando instala Lync Server.

Las reglas de versiones cliente se recopilan en directivas de versión cliente, que pueden configurarse en el ámbito global, en el ámbito del sitio y en el ámbito de servicio (servicio de registrador), o bien en el ámbito por usuario. El cmdlet Set-CsClientVersionPolicyRule proporciona un medio para que modifique las propiedades de una regla de versión de cliente existente.

Se debe tener en cuenta que las directivas de versiones de cliente no se aplican a usuarios federados; en cambio, los usuarios federados deben cumplir las directivas de versiones de cliente que se usan en su organización. Por ejemplo, supongamos que un usuario federado usa el cliente A, un cliente permitido por la organización federada. En tanto la organización federada permita el uso del cliente A, este usuario podrá comunicarse con su organización por medio de ese cliente. Esto se cumplirá aunque la directiva de versión de cliente bloquee el uso del cliente A. Las directivas de versiones de cliente implementadas en su organización no invalidan las directivas de versiones de cliente que se usan en una organización federada.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Set-CsClientVersionPolicyRule en 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-CsClientVersionPolicyRule"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único para la regla de directiva de versión de cliente que debe modificarse. La identidad de una regla de versión de cliente consiste en el ámbito en que la regla se ha configurado más un identificador único global (GUID). Eso significa que la regla tendrá una identidad similar a la siguiente: site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83.

Instance

Opcional

Objeto Rule

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

Action

Opcional

Modificador de lista PS

Acción que debe llevarse a cabo cada vez que se active la regla (es decir, cada vez que alguien intente iniciar sesión usando el software especificado). Los valores válidos son:

Allow. Se permitirá que el usuario inicie sesión.

AllowWithUrl. El usuario podrá iniciar sesión y aparecerá un mensaje con la dirección URL donde se puede descargar la versión más reciente de Lync para llevar a cabo su instalación.

AllowAndUpgrade. El usuario podrá iniciar sesión, y su copia de Communicator se actualizará automáticamente a la versión más reciente de Lync.

Block: El usuario podrá iniciar sesión.

BlockWithUrl: El usuario no podrá iniciar sesión, pero se mostrará un mensaje con la dirección URL donde se puede descargar la versión más reciente de Lync para llevar a cabo su instalación.

BlockAndUpgrade: El usuario no podrá iniciar sesión, sin embargo, su copia de Communicator se actualizará automáticamente a la versión más reciente de Lync. A continuación, el usuario puede intentar iniciar sesión mediante la nueva aplicación cliente.

ActionUrl

Opcional

Cadena de caracteres

Dirección URL donde los usuarios pueden descargar la última versión de Lync. Esta propiedad es obligatoria si el valor Action se ha definido como BlockWithUrl o AllowWithUrl.

BuildNumber

Opcional

Integer

Número de versión de compilación del software. Por ejemplo, si su copia de Communicator es la versión 2.0.6362.111, el valor de BuildNumber será 6362. Los números de versión de compilación representan las versiones internas del software durante el proceso de desarrollo y permiten garantizar que esté usando la versión final en lugar de la versión preliminar.

CompareOp

Opcional

Modificador de lista PS

Operador de comparación usado para determinar si el software del cliente que intenta iniciar sesión se lanzó antes, después o al mismo tiempo que la versión especificada en la regla. Los valores válidos son:

EQL (igual a)

NEQ (no es igual a)

GTR (mayor de)

GEQ (mayor de o igual a)

LSS (menor de)

LEQ (menor de o igual a)

Description

Opcional

Cadena de caracteres

Permite que los administradores proporcionen información adicional sobre la regla de versión de cliente. Por ejemplo, la descripción podría incluir información sobre con quién debe comunicarse si cree que la regla debe cambiarse.

Enabled

Opcional

Booleano

Indica si debe usarse o no la regla de versión de cliente. Si la propiedad Enabled está definida en False, la regla se omitirá siempre que un usuario intente iniciar sesión con el software especificado. El valor predeterminado es True.

MajorVersion

Opcional

Integer

Versión principal del software. Por ejemplo, si su copia de Communicator es la versión 2.0.6362.111, entonces MajorVersion será 2. Las versiones principales equivalen a las versiones definitivas del software.

MinorVersion

Opcional

Integer

Versión secundaria del software. Por ejemplo, si su copia de Communicator es la versión 2.0.6362.111, entonces MinorVersion será 0. Las versiones secundarias equivalen a las versiones provisionales del software.

Priority

Opcional

Integer

Prioridad relativa de la regla. Las reglas se procesan en orden de prioridad: la regla con prioridad 0 se procesa primero, la regla con prioridad 1 se procesa en segundo lugar y así sucesivamente. Si asigna una prioridad que ya está en uso, la nueva regla usará esa prioridad y se numerarán nuevamente las otras reglas en consecuencia.

QfeNumber

Opcional

Integer

Número de ingeniería de corrección rápida del software. Por ejemplo, si su copia de Communicator es la versión 2.0.6362.111, el valor de QfeNumber será 111. Los números de QFE representan actualizaciones planeadas de una aplicación que se ponen a disposición de los usuarios tras el lanzamiento oficial del software.

UserAgent

Opcional

Cadena de caracteres

El designador usado para identificar el cliente del software. Por ejemplo, OC es la designación de agente de usuario de Communicator. El cmdlet Get-CsClientVersionConfiguration proporciona nombres descriptivos correspondientes a cada designación de agente de usuario.

UserAgentFullName

Opcional

Cadena de caracteres

Permite a los administradores proporcionar un nombre descriptivo para el agente de usuario. Por ejemplo, en vez de basarse en la UCCP del agente de usuario para identificar al agente, los administradores pueden escribir el nombre completo: Microsoft Unified Communications Client.

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

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule. Set-CsClientVersionPolicyRule acepta instancias canalizadas del objeto de versión de clientes.

Tipos de valores devueltos

Ninguno. En cambio, Set-CsClientVersionPolicyRule modifica instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.

Ejemplo

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

Set-CsClientVersionPolicyRule -Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820 -Enabled $False

El comando que se muestra en el Ejemplo 1 deshabilita la regla de directiva de versión del cliente que tiene el valor Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820. A fin de deshabilitar la regla, el comando incluye el parámetro Enabled y el valor de parámetro $False.

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

Get-CsClientVersionPolicyRule -Filter "site:Redmond*" | Set-CsClientVersionPolicyRule -Description "Client policy rules for Redmond"

El Ejemplo 2 añade una descripción genérica a todas las reglas de directiva de versión del cliente asignadas al sitio Redmond. Para ello, el comando primero llama a Get-CsClientVersionPolicyRule junto con el parámetro Filter. El valor del filtro "site:Redmond*" limita los datos devueltos a las reglas de directiva asignadas al sitio Redmond. A continuación, esta recopilación se canaliza al cmdlet Set-CsClientVersionPolicyRule, que asigna la descripción "Reglas de directiva de cliente para Redmond" a cada elemento en la colección.

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

Get-CsClientVersionPolicyRule | Where-Object {$_.UserAgent -eq "UCCP"} | Set-CsClientVersionPolicyRule -Action "Block"

El comando anterior bloquea el uso de clientes de plataforma de cliente de comunicaciones unificadas (UCCP) para cualquier regla de directiva de versión de cliente que haga referencia a UCCP como el agente del usuario. A fin de realizar esta tarea, el comando primero llama a Get-CsClientVersionPolicyRule para recuperar una colección de un conjunto de todas las reglas de directiva de cliente actualmente en uso. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona únicamente las directivas cuya propiedad UserAgent sea igual a (-eq) UCCP. Luego, esta colección filtrada se transfiere al cmdlet Set-CsClientVersionPolicyRule, que toma cada elemento en la colección y establece la propiedad Action en Block.