New-CsClientVersionPolicyRule
Última modificación del tema: 2012-03-23
Crea una regla de directiva de versión cliente. Las reglas de directiva de versión de cliente ayudan a determinar si los usuarios pueden usar una aplicación cliente concreta para iniciar sesión en Microsoft Lync Server 2010.
Sintaxis
New-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>] [-InMemory <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]
New-CsClientVersionPolicyRule -Parent <String> -RuleId <String> [-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>] [-InMemory <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Las reglas de directiva de versión de cliente se usan para determinar qué aplicaciones cliente pueden usarse para 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. 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 a través de Microsoft Office Communicator 2007 R2. Para que el usuario pueda iniciar sesión en Lync Server 2010, el sistema comprobará si hay alguna regla de versión de cliente que se aplique a Office Communicator 2007 R2. Si la hubiera, 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 realizan mediante Microsoft Update o Windows Server Update Services, según la configuración del sistema.
AllowWithUrl: el usuario podrá iniciar sesión y se mostrará un mensaje con la dirección URL donde se puede descargar e instalar la versión más reciente de Lync. La URL debe señalar a un sitio web que usted mismo haya creado. Estos sitios no se crean cuando se instala 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 mediante Microsoft Update o Windows Server Update Services, según la configuración del 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 URL debe señalar a un sitio web que usted mismo haya creado. Estos sitios no se crean cuando se instala Lync Server.
Las reglas de directiva de versión de cliente 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. Las reglas de versión de cliente se crean con el cmdlet New-CsClientVersionPolicyRule. Al crear una regla, también se debe especificar la identidad de dicha regla, que consta de un ámbito (por ejemplo, site:Redmond) y un identificador único global (GUID). Puede construir una identidad usted mismo, o bien proporcionar el ámbito (el parámetro Parent) y el identificador GUID (el parámetro RuledId) para que New-CsClientVerisonPolicyRule cree la identidad por usted.
Es importante reparar en que las directivas de versión de cliente no atañen a los usuarios federados. Estos se rigen por las directivas de versión de cliente utilizadas en su propia organización. Por ejemplo, supongamos que un usuario federado utiliza el cliente A, un cliente aceptado por la organización federada. Siempre y cuando la organización federada permita el uso del cliente A, este usuario podrá comunicarse con nuestra organización utilizando ese cliente. Y así será aunque nuestra directiva de versión de cliente bloquee el uso del cliente A. Las directivas de versión de cliente vigentes en nuestra organización no anulan las directivas de versión de cliente empleadas en la organización federada.
Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet New-CsClientVersionPolicyRule: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsClientVersionPolicyRule"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único de la regla de directiva de versión cliente que se va a crear. La identidad (Identity) de una regla de directiva de versión de 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. En lugar de usar el parámetro Identity, puede usar los parámetros Parent y RuleId para que New-CsClientVerisonPolicyRule cree la identidad por usted. |
MajorVersion |
Requerido |
Entero |
Versión principal del software. Por ejemplo, si su copia de Communicator es de la versión 2.0.6362.111, MajorVersion será 2. Las versiones principales equivalen a las versiones definitivas del software. Debe asignar un valor a la propiedad MajorVersion siempre que cree una regla nueva. |
MinorVersion |
Opcional |
Entero |
Versión secundaria del software. Por ejemplo, si su copia de Communicator es de la versión 2.0.6362.111, MinorVersion será 0. Las versiones secundarias equivalen a las versiones provisionales del software. |
UserAgent |
Requerido |
Cadena de caracteres |
El designador usado para identificar el cliente de software. Por ejemplo, OC es la designación de agente de usuario de Communicator. |
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: el usuario podrá iniciar sesión. 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. AllowAndUpgrade: El usuario podrá iniciar sesión y su copia de Communicator se actualizará automáticamente con la versión más reciente de Lync. Block: el usuario no podrá iniciar sesión. 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. BlockAndUpgrade: el usuario no podrá iniciar sesión, pero su copia de Communicator 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. |
ActionUrl |
Opcional |
Cadena de caracteres |
Dirección URL en la que 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 |
Entero |
Número de versión de compilación del software. Por ejemplo, si su copia de Communicator es de 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 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 igual a) GTR (mayor que) GEQ (mayor o igual que) LSS (menor que) LEQ (menor o igual que) |
Description |
Opcional |
Cadena de caracteres |
Permite a los administradores proporcionar información adicional sobre la regla de versión cliente. Por ejemplo, la descripción puede incluir información sobre quién contactar si cree que la regla debe cambiarse. |
Enabled |
Opcional |
Booleano |
Indica si la regla de versión cliente se va a usar o no. Si la propiedad Enabled está definida en False ($False), la regla se omitirá siempre que un usuario intente iniciar sesión con el software especificado. El valor predeterminado es True. |
Parent |
Opcional |
Cadena de caracteres |
Información de ámbito de la nueva regla. Para usar el parámetro Parent y crear una regla para la directiva global, use esta sintaxis: -Parent global. Para crear una regla para una directiva de sitio, use una sintaxis similar a: -Parent "site:Redmond". Para crear una regla para una directiva de servicio, use una sintaxis similar a: -parent "Registrar:atl-cs-001.litwareinc.com". Para crear una regla para una directiva por usuario, use una sintaxis similar a: -Parent "RedmondClientVersionPolicy". Para crear una regla, debe usar el parámetro Identity o los parámetros Parent y RuleId. |
Priority |
Opcional |
Entero |
Prioridad relativa de la regla. Las reglas se procesan por orden de prioridad, es decir, la regla con la prioridad 0 se procesa en primer lugar, la regla con la prioridad 1 se procesa en segundo lugar y así sucesivamente. Si asigna una prioridad que está en uso, la nueva regla usará esta prioridad y la numeración del resto de reglas se cambiará en consecuencia. |
QfeNumber |
Opcional |
Entero |
Número de ingeniería de corrección rápida (QFE) del software. Por ejemplo, si su copia de Communicator es de 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. |
RuleId |
Opcional |
Identificador único global |
Identificador único global (GUID) de la regla. En Windows PowerShell, puede crear un GUID con el comando siguiente: $x = [guid]::NewGuid() |
UserAgentFullName |
Opcional |
Cadena de caracteres |
Permite a los administradores proporcionar un nombre descriptivo para el agente de usuario. Por ejemplo, en vez de confiar en el 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 ocurrir 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. New-CsClientVersionPolicyRule no acepta una entrada transferida.
Tipos de valores devueltos
New-CsClientVersionPolicyRule crea instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
$x = [guid]::NewGuid()
New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -MajorVersion 4 -UserAgent InHouse
En el Ejemplo 1 se indica cómo puede crear una regla de directiva de versión cliente. Las reglas de directivas tienen identidades que constan de dos partes: el ámbito al que se debe asignar el anuncio y un GUID de 36 caracteres. Para crear una identidad para una regla de directiva de versión cliente nueva, primero es necesario usar el método NewGuid de .NET Framework para crear un GUID. Este paso se lleva a cabo en el primer comando del ejemplo y el GUID resultante se almacena en la variable $x.
Una vez creado el GUID, puede usar New-CsClientVersionPolicyRule para crear la regla. Este comando usa cuatro parámetros: Parent con un valor de parámetro que representa el ámbito (site:Redmond) de la nueva regla, RuleId con el valor de parámetro $x (que representa el GUID recién creado), MajorVersion (4) y UserAgent (InHouse). En este caso, el parámetro UserAgent representa una aplicación cliente local.
-------------------------- Ejemplo 2 ------------------------
$x = [guid]::NewGuid()
$z = New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -InMemory
$z.MajorVersion = 4
$z.UserAgent = "Inhouse"
Set-CsClientVersionPolicyRule -Instance $z
Los comandos mostrados en el Ejemplo 2 representan una variación del comando mostrado en el Ejemplo 1, pero en este caso, la nueva regla inicialmente solo se crea en la memoria y, más tarde, se agrega a Lync Server 2010. Para llevar a cabo esta tarea, el primer comando del ejemplo crea la parte de GUID de la identidad (Identity). En el comando 2, se crea una regla de directiva de versión de cliente solo en la memoria; el parámetro InMemory garantiza que la regla solo existe en la memoria y que no se agrega de forma inmediata a la infraestructura de Lync Server 2010. Como en el Ejemplo 1, los parámetros Parent y RuleId se usan para especificar el ámbito y el GUID de la nueva regla, los dos componentes que constituyen la identidad de la regla.
Una vez creada la regla virtual, se usan los dos siguientes comandos para asignar valores a las propiedades MajorVersion y UserAgent, respectivamente. Una vez completadas estas tareas, se usa el comando final del ejemplo y el cmdlet Set-CsClientVersionPolicyRule para crear la regla de directiva de versión de cliente real y asignar la regla al sitio de Redmond.
Vea también
Otros recursos
Get-CsClientVersionPolicyRule
Remove-CsClientVersionPolicyRule
Set-CsClientVersionPolicyRule