New-CsClientPolicyEntry
Última modificación del tema: 2012-03-23
Agrega opciones nuevas a las directivas de cliente de Microsoft Lync Server 2010.
Sintaxis
New-CsClientPolicyEntry -Name <String> -Value <String>
Descripción detallada
Las directivas de cliente son el mecanismo principal que utiliza Lync Server 2010 para administrar el software cliente como Microsoft Lync 2010. Al crear o configurar una directiva de cliente, tiene diversas opciones disponibles; por ejemplo, puede especificar si desea que se puedan utilizar fotos en Lync 2010, si se permite incluir emoticonos en los mensajes instantáneos, y si Lync 2010 guarda automáticamente transcripciones de las sesiones de mensajería instantánea. Estas opciones abarcan muchas de las configuraciones relacionadas con el cliente que necesitan controlar los administradores.
Aunque puede que haya algunas opciones relacionadas con clientes que los administradores necesiten especificar y que no estén incluidas. Para administrar las opciones de manera más flexible y exhaustiva, las directivas de cliente incluyen una propiedad llamada PolicyEntry. Esta propiedad multivalor permite a los administradores agregar nuevas opciones de administración no incluidas explícitamente en las directivas de cliente. Por ejemplo, antes del lanzamiento de Lync Server, los participantes en las pruebas beta podían agregar una opción de comentarios en Lync 2010. Esta opción se agregó como una nueva entrada de directiva, y se creó usando New-CsClientPolicyEntry.
Debe tener en cuenta que no es posible crear entradas de directiva de manera arbitraria y pretender administrar Lync 2010 u otras aplicaciones cliente con ellas. Es necesario esperar a obtener información de Microsoft sobre los nombres y valores que pueden usarse para crear entradas de directivas de cliente.
Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet New-CsClientPolicyEntry localmente los miembros de los siguientes grupos: 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 (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsClientPolicyEntry"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Name |
Requerido |
Cadena de caracteres |
Nombre de la nueva entrada de directiva. Por ejemplo: -Name "OnlineFeedbackURL". |
Value |
Requerido |
Cadena de caracteres |
Valor que se asignará a la nueva entrada de directiva. Por ejemplo: -Value http://www.litwareinc.com/feedback. |
Tipos de entrada
Ninguno. New-CsClientPolicyEntry no acepta la entrada por canalización.
Tipos de valores devueltos
New-CsClientPolicyEntry crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Client.PolicyEntryType.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
$x = New-CsClientPolicyEntry -Name "OnlineFeedbackURL" -Value "http://www.litwareinc.com/feedback"
$y = Get-CsClientPolicy -Identity global
$y.PolicyEntry.Add($x)
Set-CsClientPolicy -Instance $y
Los comandos del Ejemplo 1 muestran cómo agregar una nueva entrada de directiva a la directiva de cliente global. Este ejemplo agrega una nueva opción de comentarios a Lync 2010. Debe tener en cuenta que éste es un ejemplo demostrativo. No es posible ejecutar estos comandos para agregar una opción de comentarios similar en su copia de Lync 2010.
Para agregar la entrada de directiva, el primer comando del ejemplo usa New-CsClientPolicyEntry para crear una entrada con el nombre OnlineFeedbackURL y el valor http://www.litwareinc.com/feedback. La entrada de directiva resultante se almacena en una variable llamada $x.
En el segundo comando, se usa Get-CsClientPolicy para crear una referencia a objeto ($y) a la directiva de cliente global. Una vez creada la referencia a objeto, se usa el método Add para agregar la nueva entrada de directiva a la propiedad PolicyEntry. Si PolicyEntry ya tiene una o varias entradas, el nuevo valor se anexará al final de la recopilación.
Finalmente, el último comando del ejemplo usa Set-CsClientPolicy para escribir los cambios en la directiva global real. Si no llama a Set-CsClientPolicy, los cambios sólo se aplicarán en la memoria, y desaparecerán al cerrar la sesión de Windows PowerShell o eliminar la variable $x.
-------------------------- Ejemplo 2 ------------------------
$x = New-CsClientPolicyEntry -Name "OnlineFeedbackURL" -Value "http://www.litwareinc.com/feedback"
Set-CsClientPolicy -Identity global -PolicyEntry $x
El Ejemplo 2 es una variación del Ejemplo 1; aunque, en este caso, la nueva entrada de directiva reemplaza todos los elementos de la propiedad PolicyEntry de la directiva global. Para ello, el primer comando del ejemplo crea una entrada de directiva que se almacena en una variable llamada $x. El segundo comando usa Set-CsClientPolicy para definir el valor de la propiedad PolicyEntry como $x. Una vez completado el comando, el único elemento de la propiedad PolicyEntry será la nueva entrada. Todos los elementos que contenía la propiedad antes de llamar a Set-CsClientPolicy se sustituirán por la entrada nueva.
-------------------------- Ejemplo 3 ------------------------
$y = Get-CsClientPolicy -Identity global
$y.PolicyEntry.RemoveAt(0)
Set-CsClientPolicy -Instance $y
El Ejemplo 3 muestra cómo quitar una entrada de directiva de cliente de la directiva global. Para hacerlo, el primer comando del ejemplo recupera la directiva de cliente global y almacena la información en una variable llamada $y.
Después de recuperar la directiva global, el segundo comando del ejemplo utiliza el método RemoveAt() para eliminar la primera entrada de directiva de esa directiva. La entrada de directiva que se quitará se indica con el número de índice: la primera entrada de la directiva tiene un número de índice de 0; la segunda, 1, etc. La sintaxis RemoveAt(0) significa que se quitará la primera entrada de la directiva.
En cuanto se quita la entrada de directiva de la instancia de la directiva global que hay en la memoria, se llama al cmdlet Set-CsClientPolicy para escribir los cambios en la instancia real de la directiva de cliente global.
-------------------------- Ejemplo 4 ------------------------
Set-CsClientPolicy -Identity global -PolicyEntry $Null
El comando que aparece en el Ejemplo 4 quita todas las entradas de directiva de cliente configuradas para la directiva global. Para ello, se utiliza el parámetro PolicyEntry y se establece el valor del parámetro como nulo ($Null).