Compartir a través de

  • Artículo

New-CsClientVersionPolicy

 

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

Crea una nueva directiva de versión de cliente. Las directivas de versión de cliente permiten especificar qué versiones de clientes (como Microsoft Office Communicator 2007 R2) podrán iniciar sesión en su sistema Microsoft Lync Server 2010.

Sintaxis

New-CsClientVersionPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Rules <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Las directivas de versión de cliente representan una recopilación de reglas de versiones de clientes; a su vez, las reglas de versiones de clientes 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. La información de versión incluida en el encabezado SIP 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. 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 la aplicación cliente sin enviar ningún mensaje con la última versión de (por ejemplo, actualizar Communicator 2007 R2 a Microsoft 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, como norma general, es posible que convenga impedir que los usuarios inicien sesión en Lync Server 2010 usando Communicator 2007 R2; esto es conveniente porque la aplicación cliente anterior no admite las mismas características y capacidades 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.

Sin embargo, tenga en cuenta que los usuarios anónimos solo se ven afectados por las directivas globales. Esto se debe a que los usuarios anónimos no están asociados a un sitio o servicio, y a que no se les puede asignar una directiva por usuario.

Las nuevas directivas de versión de cliente se crean mediante el cmdlet New-CsClientVersionPolicy. Esas nuevas directivas se pueden crear en el ámbito del sitio, el ámbito de servicios (solo servicio de registrador) o en el ámbito por usuario.

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 forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet New-CsClientVersionPolicy 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 "New-CsClientVersionPolicy\b"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identificador único para la directiva que se debe crear. Para crear una directiva en el ámbito del sitio, use una sintaxis similar a la siguiente: -Identity "site:Redmond". Para crear una directiva en el ámbito del servicio, use una sintaxis similar a la siguiente: -Identity "Registrar:atl-cs-001.litwareinc.com". El servicio de registrador es el único servicio que puede hospedar una directiva de versión de cliente.

Las directivas también pueden crearse en un ámbito por usuario. Para crear una directiva por usuario, use una sintaxis similar a ésta: -Identity "SalesDepartmentPolicy".

Description

Opcional

Cadena de caracteres

Permite proporcionar texto explicativo sobre la directiva. Por ejemplo, podría incluir información sobre los usuarios a los que se debe asignar la directiva.

Rules

Opcional

Modificador de lista PS

Colección de reglas de directivas de versión de clientes. Es posible agregar o quitar reglas de una directiva con los cmdlets New-CsClientVersionPolicyRule y Remove-CsClientVersionPolicyRule. Para agregar una regla en el momento de crear la nueva directiva, debe crear la regla y almacenar el valor en una variable (por ejemplo, $x). A continuación, podrá usar una sintaxis similar a la siguiente al crear la nueva directiva:

New-CsClientVersionPolicy –Identity "RedmondClientVersionPolicy" –Rules @{Add=$x}

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.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

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

Ninguno. Get-CsClientVersionPolicy no acepta entradas canalizadas.

Tipos de valores devueltos

New-CsClientVersionPolicy crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy.

Ejemplo

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

New-CsClientVersionPolicy -Identity site:Redmond

En el Ejemplo 1 se crea una nueva directiva de versión de clientes para el sitio Redmond. Debido a que no se especifican parámetros (además del parámetro de identidad y obligatorio), la nueva directiva contendrá los valores predeterminados de una directiva de versión de cliente.

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

Get-CsSite | Select-Object Identity | ForEach-Object {New-CsClientVersionPolicy -Identity ("site:" + $_.Identity)}

En el comando que se muestra en el Ejemplo 2 se crea una nueva directiva de versión de clientes de cada sitio de la organización. Para cumplir esta tarea, el comando primero llama a Get-CsSite sin ningún parámetro adicional, lo que devuelve una recopilación de todos los sitios de la topología. Esta recopilación de sitios después se canaliza al cmdlet Select-Object, que extrae la propiedad Identity de cada sitio. Luego, esas identidades se canalizan a ForEach-Object, que toma cada sitio de la recopilación y crea una nueva directiva de versión de cliente para el sitio.