Compartir a través de

  • Artículo

Get-CsClientPolicy

 

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

Devuelve información sobre las directivas de cliente configuradas para el uso en una organización. Entre otras cosas, las directivas de cliente ayudan a determinar las características de Microsoft Lync 2010 que tienen disponibles los usuarios; por ejemplo, puede permitir a algunos usuarios transferir archivos y prohibírselo a otros.

Sintaxis

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

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

Descripción detallada

En Lync Server 2010, las directivas de cliente reemplazan la configuración de directivas de grupo usada en las versiones anteriores del producto. En Microsoft Office Communicator 2007 y Microsoft Office Communicator 2007 R2, la directiva de grupo ayudaba a determinar lo que los usuarios podían hacer con Communicator y con otros clientes; por ejemplo, existían configuraciones de directivas de grupo que determinaban si los usuarios podían guardar una transcripción de las sesiones de mensajería instantánea, si la información de Microsoft Outlook se incorporaba en su información de presencia y si los usuarios podían incluir emoticonos o texto con formato en los mensajes instantáneos.

A pesar de que la directiva de grupo es muy útil, la tecnología sigue teniendo sus limitaciones a la hora de aplicarla a Lync Server 2010. Por un lado, la directiva de grupo está diseñada para aplicarse por dominios o por unidades organizativas (OU) , por tanto, se hace difícil dirigir las directivas a un grupo más específico de usuarios (por ejemplo, todos los usuarios que trabajan en un departamento concreto o todos los usuarios que tienen un cargo específico). Por otra parte, la directiva de grupo solo se aplica a usuarios que inician sesión en el dominio y que inician sesión usando un equipo. La directiva de grupo no se aplica a usuarios que obtienen acceso al sistema a través de Internet o mediante un teléfono móvil. Esto significa que un mismo usuario puede tener una experiencia distinta según el dispositivo que use para iniciar sesión y desde donde inicie sesión.

Para corregir estas incoherencias, Lync Server 2010 usa directivas de administración de cliente en lugar de directivas de grupo. Las directivas de cliente se aplican cada vez que un usuario obtiene acceso al sistema, independientemente de desde dónde inicie sesión el usuario y del tipo de dispositivo en que el usuario inicie la sesión. Además, las directivas de cliente, como otras directivas de Lync Server 2010, pueden enfocarse fácilmente a grupos de usuarios seleccionados. Incluso se puede crear una directiva personalizada que se asignará a un solo usuario.

Las directivas de cliente pueden configurarse en el ámbito global, de sitio y por usuario. El cmdlet Get-CsClientPolicy permite devolver información sobre todas las directivas de cliente que se hayan configurado para su uso en la organización.

Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsClientPolicy de forma local: RTCUniversalUserAdmins, 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 "Get-CsClientPolicy"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la directiva de cliente que se quiere devolver. Para hacer referencia a la directiva global, use esta sintaxis: -Identity global. Para hacer referencia a una directiva de sitio, use una sintaxis similar a: -Identity site:Redmond. Para hacer referencia a una directiva por usuario, use una sintaxis similar a: -Identity SalesDepartmentPolicy.

Si se omite este parámetro, se devolverán todas las directivas de cliente configuradas para su uso en la organización.

Filter

Opcional

Cadena de caracteres

Permite usar caracteres comodín para indicar la directiva (o directivas) que se van a devolver. Por ejemplo, para devolver todas las directivas configuradas en el ámbito de sitio, use esta sintaxis: -Filter "site:*". Para devolver una colección de todas las directivas por usuario, use esta sintaxis: -Filter "tag:*".

LocalStore

Opcional

Parámetro modificador

Recupera los datos de directivas de cliente de la réplica local de Almacén de administración central en lugar de recuperarlos de Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsClientPolicy no acepta la entrada transferida.

Tipos de valores devueltos

Get-CsClientPolicy devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy.

Ejemplo

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

Get-CsClientPolicy

En el ejemplo anterior, se llama a Get-CsClientPolicy sin ningún parámetro adicional, lo que devuelve una colección de todas las directivas de cliente configuradas para su uso en la organización.

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

Get-CsClientPolicy -Identity SalesPolicy

En el Ejemplo 2, Get-CsClientPolicy se usa para devolver una directiva de cliente por usuario con la identidad SalesPolicy. Puesto que las identidades son únicas, este comando nunca devolverá más de un elemento.

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

Get-CsClientPolicy -Filter "tag:*"

En el Ejemplo 3 se usa el parámetro Filter para devolver todas las directivas de cliente que se han configurado en el ámbito por usuario. El valor de filtro "tag:*" indica a Get-CsClientPolicy que únicamente devuelva las directivas que tengan una identidad que comience por el valor de cadena de caracteres "tag:".

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

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True}

El comando anterior devuelve una recopilación de todas las directivas de cliente cuya propiedad DisableSavingIM sea True. Para ello, primero se llama a Get-CsClientPolicy sin ningún parámetro para devolver una colección de todas las directivas de cliente que están configuradas para su uso en la organización. A continuación, esta colección se transfiere al cmdlet Where-Object, que selecciona únicamente las directivas en las que la propiedad DisableSavingIM sea igual a True.

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

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -and $_.EnableIMAutoArchiving -eq $False}

En el Ejemplo 5, las únicas directivas de cliente que se devuelven son las directivas que cumplen dos criterios: la propiedad DisableSavingIM debe ser True y la propiedad EnableIMAutoArchiving debe ser False. Para ello, el comando primero llama a Get-CsClientPolicy para devolver una colección de todas las directivas de cliente configuradas para su uso en la organización. A continuación, esta colección se transfiere a Where-Object, que solo selecciona las directivas que cumplan los dos criterios siguientes: DisableSavingIM debe ser igual a True y EnableIMAutoArchiving debe ser igual a False. El operador -and indica a Where-Object que únicamente se deben seleccionar los objetos que cumplan todos los criterios especificados.

-------------------------- Ejemplo 6 --------------------------

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -or $_.EnableIMAutoArchiving -eq $False}

El Ejemplo 6 es una variación del comando mostrado en el Ejemplo 5, pero esta vez las directivas se seleccionan siempre que cumplan por lo menos uno de los criterios siguientes: la propiedad DisableSavingIM es True o la propiedad EnableIMAutoArchiving es False. Para llevar a cabo esta tarea, el comando primero llama a Get-CsClientPolicy para devolver una colección de todas las directivas de cliente configuradas para su uso en la organización. A continuación, esta colección se transfiere a Where-Object, que solo selecciona las directivas que cumplan como mínimo uno de los criterios siguientes: DisableSavingIM es igual a True y EnableIMAutoArchiving es igual a False. El operador -or indica a Where-Object que se deben seleccionar todos los objetos que cumplan como mínimo una de las condiciones especificadas.