Compartir a través de

  • Artículo

Remove-CsClientVersionPolicyRule

 

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

Quita una o más reglas de directivas de versión de clientes configuradas para usar en su organización.

Sintaxis

Remove-CsClientVersionPolicyRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 del uso de Microsoft Office Communicator 2007 R2. Antes de poder iniciar sesión, el sistema comprobará si existe 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 con la versión más reciente de Lync. Las actualizaciones se realizan con Microsoft Update o Windows Server Update Services, según la manera en que haya configurado el sistema.

AllowWithUrl. El usuario podrá iniciar sesión y se mostrará un mensaje con la dirección URL donde el usuario puede descargar e instalar la versión más reciente de Lync. La dirección URL debe dirigir a un sitio web que usted ha creado; no se crea dicho sitio para usted 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 realizan con Microsoft Update o Windows Server Update Services, según la manera en que haya 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 e instalar la versión más reciente de Lync. La dirección URL debe dirigir a un sitio web que usted ha creado; no se crea dicho sitio para usted al instalar Lync Server.

Las reglas de versiones de clientes se recopilan en directivas de versión de 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 Remove-CsClientVersionPolicyRule le permite eliminar una o más reglas de directivas de clientes configuradas para usar en su organización. Estas reglas se pueden eliminar de cualquier directiva de versión de clientes, incluida la directiva global.

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 siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsClientVersionPolicyRule localmente: 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 "Remove-CsClientVersionPolicyRule"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de la directiva de versión de clientes que se quitará. 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.

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. Remove-CsClientVersionPolicyRule acepta entradas canalizadas del objeto de regla de versión de cliente.

Tipos de valores devueltos

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

Ejemplo

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

Remove-CsClientVersionPolicyRule -Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820

En el comando que se muestra en el Ejemplo 1 se elimina la regla de directivas de versión de clientes con Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820. Dado que las identidades deben ser únicas, este comando eliminará, como mucho, una única regla.

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

Get-CsClientVersionPolicyRule -Filter "site:Redmond/*" | Remove-CsClientVersionPolicyRule

En el comando anterior se eliminan todas las reglas de directivas de versiones de clientes que se han configurado para el 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 directivas cuya identidad comienza con el valor de cadena "site:Redmond/". Esta recopilación filtrada después se canaliza a Remove-CsClientVersionPolicyRule, que elimina cada uno de los elementos de esa recopilación.

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

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

En el Ejemplo 3 se eliminan todas las reglas de directivas de versiones de clientes deshabilitadas en la actualidad. Para ello, el comando primero llama a Get-CsClientVersionPolicyRule sin parámetros a fin de devolver una recopilación de todas las reglas de directivas actualmente en uso de la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que elige todas las reglas donde la propiedad Enabled es igual a False. La recopilación filtrada después se canaliza a Remove-CsClientVersionPolicyRule, que elimina cada uno de los elementos de esa recopilación.