Compartir a través de

  • Artículo

Get-CsClientVersionPolicyRule

 

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

Devuelve las reglas de directivas de versión cliente configuradas para el uso en la organización.

Sintaxis

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

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

Descripción detallada

Las reglas de versiones cliente 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. A continuación, la información de versiones 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. Por ejemplo, supongamos que un usuario intenta iniciar sesión utilizando Microsoft Office Communicator 2007 R2. Antes de que el usuario pueda iniciar sesión en Lync Server 2010, el sistema comprobará si hay alguna regla de versión cliente que se aplique a Office Communicator 2007 R2. En caso afirmativo, Lync Server 2010 llevará a cabo la acción especificada por la regla, que debe ser una de las siguientes:

Allow: el usuario podrá iniciar sesión.

AllowAndUpgrade: El usuario podrá iniciar sesión y su copia de Communicator 2007 R2 se actualizará automáticamente con la versión más reciente de Lync. Las actualizaciones se llevan a cabo mediante Microsoft Update o Windows Server Update Services, en función de cómo se haya configurado el sistema.

AllowWithUrl: El usuario podrá iniciar sesión y se mostrará un mensaje con la dirección URL desde la que se puede descargar e instalar la versión más reciente de Lync. La dirección URL debe apuntar a un sitio web creado por usted mismo, ya que dicho sitio no se crea al instalar Lync Server.

Block: El usuario no podrá iniciar sesión.

BlockAndUpgrade: El usuario no podrá iniciar sesión, pero su copia de Communicator 2007 R2 se actualizará automáticamente con la versión más reciente de Lync. A continuación, el usuario podrá intentar iniciar sesión mediante la nueva aplicación cliente. Las actualizaciones se llevan a cabo mediante Microsoft Update o Windows Server Update Services, en función de cómo se haya configurado el sistema.

BlockWithUrl: El usuario no podrá iniciar sesión, pero se mostrará un mensaje con la dirección URL desde la que se puede descargar e instalar la versión más reciente de Lync. La dirección URL debe apuntar a un sitio web creado por usted mismo, ya que dicho sitio no se crea al instalar Lync Server.

Las reglas de versiones cliente se recopilan en directivas de versión cliente. Estas directivas 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 Get-CsClientVersionPolicyRule permite a los administradores ver información detallada sobre todas las reglas de directiva configuradas para el uso en la organización.

Es importante tener en cuenta que las directivas de versión de cliente no se aplican a los usuarios federados; estos usuarios utilizan las directivas de versión de cliente de su organización. Por ejemplo, supongamos que un usuario federado utiliza el cliente A, un cliente permitido por la organización federada. Mientras la organización federada permita el uso del cliente A, este usuario podrá comunicarse con su organización utilizando dicho cliente. Esto será así aun cuando su directiva de versión de cliente bloquee el uso del cliente A. Las directivas de versión de cliente aplicadas en su organización no invalidan las directivas de versión de cliente utilizadas en una organización federada.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsClientVersionPolicyRule de manera local: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC), se ha asignado este cmdlet (incluidos los roles RBAC que haya creado usted mismo) para ejecutar el siguiente comando desde el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la regla de directiva de versión cliente que se va a recuperar. La identidad (Identity) de una regla de versión cliente consta del ámbito en que se ha configurado la regla y de un identificador GUID. Por tanto, una regla tendrá un valor Identity similar a: site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83. Los identificadores GUID son difíciles de recordar y resulta complicado trabajar con ellos, por eso, en la sección de ejemplos de este tema de ayuda se muestran sistemas alternativos que permiten identificar las reglas que se devolverán.

Si no se especifica este parámetro, se devolverán todas las reglas de directivas de versión cliente configuradas para su uso.

Filter

Opcional

Cadena de caracteres

Permite usar caracteres comodín para especificar las reglas de directiva de versión de cliente que se van a devolver. Por ejemplo, para devolver todas las reglas configuradas para el sitio de Redmond, use esta sintaxis: -Filter "site:Redmond/*".

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

LocalStore

Opcional

Parámetro modificador

Recupera los datos de la regla de directiva de versión de cliente de la Almacén de administración central, en lugar de recuperarlos de la Almacén de administración central en sí.

Tipos de entrada

Ninguno. Get-CsClientVersionPolicyRule no acepta entradas transferidas.

Tipos de valores devueltos

Get-CsClientVersionPolicyRule devuelve instancias del objetoMicrosoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.

Ejemplo

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

Get-CsClientVersionPolicyRule

En el ejemplo 1 se devuelve información sobre todas las reglas de directiva de versión de cliente que están en uso en la organización.

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

Get-CsClientVersionPolicyRule -Identity "Global/2336c611-a243-4c5d-994b-eea8a524d0e4"

En el Ejemplo 2, se devuelve información sobre una única regla de directiva de versión cliente: la regla cuyo valor de Identity es Global/2336c611-a243-4c5d-994b-eea8a524d0e4.

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

Get-CsClientVersionPolicyRule -Filter "Global/*"

El comando anterior devuelve todas las reglas de directiva de versión cliente que se hayan configurado en el ámbito global. Para ello, el comando usa el parámetro Filter y el valor de filtro "Global/*". Este valor de filtro solo devuelve las reglas con un valor de Identity que empiece por el valor de cadena de caracteres "Global/".

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

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

El comando mostrado en el Ejemplo 4, devuelve todas las reglas de directiva de versión cliente que están deshabilitadas. Para ello, el comando primero llama a Get-CsClientVersionPolicy para devolver una recopilación de todas las reglas de directiva de cliente disponibles. Esta colección después se canaliza al cmdlet Where-Object, que elige todas las reglas donde la propiedad Enabled es igual a False.

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

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

El comando anterior devuelve todas las reglas de directiva de versión cliente que impiden que una aplicación cliente inicie sesión. Para ello, el comando primero llama a Get-CsClientVersionPolicy sin parámetros, lo que devuelve una recopilación de todas las reglas que están en uso. Esta recopilación se transfiere al cmdlet Where-Object, que selecciona solo las reglas en las que la propiedad Action es igual a Block.