Compartir a través de

  • Artículo

Grant-CsPresencePolicy

 

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

Concede una directiva de presencia por usuario a un usuario o grupo de usuarios.

Sintaxis

Grant-CsPresencePolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

La información de presencia (que, entre otras cosas, permite saber si un contacto está disponible para participar en una conversación de mensajería instantánea) no supone ningún gasto. Sin embargo, hay un costo asociado a ella: cuantas más suscripciones de presencia haya, más ancho de banda de red se dedicará a actualizar la información de presencia. Si el ancho de banda de la red es un problema, es posible que interese limitar la cantidad de suscripciones de presencia por usuario.

Los cmdlets CsPresencePolicy permiten administrar dos aspectos importantes de las suscripciones de presencia: los suscriptores que han recibido avisos y las suscripciones a categorías. Cuando otra persona le agrega a su lista de contactos de Microsoft Lync 2010, se mostrará un mensaje de notificación emergente de manera predeterminada que le informa de que ha sido agregado a dicha lista. Hasta el momento en que cierre el mensaje emergente, cada notificación cuenta como un suscriptor con aviso. La propiedad de directiva de presencia MaxPromptedSubscriber permite especificar la cantidad máxima de cuadros de diálogo de notificación sin resolver que puede tener un usuario. (Si un usuario alcanza el número máximo, no recibirá nuevas notificaciones de contacto, al menos hasta que responda a algunos de dichos cuadros de diálogo de notificación.)

Las suscripciones a categorías son solicitudes de determinadas categorías de información; por ejemplo, la solicitud de datos del calendario por parte de una aplicación. La propiedad MaxCategorySubscription permite a los administradores definir un límite para la cantidad de suscripciones a categorías que puede tener un usuario.

En las versiones anteriores de Microsoft Lync Server 2010, los suscriptores y categorías de suscripción se administraban de manera global. Ahora, con los cmdlet CsPresencePolicy, puede administrar las suscripciones de presencia en el ámbito global, de sitio o incluso por usuario. Así, es posible controlar el uso del ancho de banda sin dejar de garantizar a los usuarios el acceso a la información de presencia que necesitan para realizar su trabajo.

Al crear una directiva por usuario, la directiva no se asigna automáticamente a nadie. Por el contrario, las directivas de presencia por usuario deben asignarse expresamente a los usuarios (o grupos de usuarios), para lo cual se ejecuta el cmdlet Grant-CsPresencePolicy.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Grant-CsPresencePolicy localmente: RTCUniversalUserAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Grant-CsPresencePolicy"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Indica la Identidad de la cuenta de usuario que se asignará a la directiva de presencia. Las identidades de usuario pueden especificarse con cuatro formatos: 1) la dirección SIP del usuario; 2) el nombre principal del usuario (UPN); 3) el nombre del dominio y el nombre de inicio de sesión del usuario, con formato dominio\nombre (por ejemplo, litwareinc\kenmyer), y 4) el nombre para mostrar de Active Directory del usuario (por ejemplo, Ken Myer). Las identidades de usuario también se pueden especificar por medio del nombre distintivo de Active Directory del usuario.

Además, puede usar el asterisco (*) como carácter comodín al usar el Nombre para mostrar como la Identidad del usuario. Por ejemplo, el parámetro Identity "* Smith" devuelve todos los usuarios con un nombre para mostrar que termine con el valor de cadena de caracteres "Smith".

PolicyName

Requerido

Identidad de la directiva por usuario que se va a asignar, por ejemplo: -PolicyName "RedmondPresencePolicy". PolicyName es el parámetro Identity de la directiva menos el prefijo "tag:". Por ejemplo, una directiva con Identity "tag:NorthAmericaPresencePolicy" tendrá "NorthAmericaPresencePolicy" como valor de PolicyName.

DomainController

Opcional

Nombre de dominio completo (FQDN) del controlador de dominio con el que se pondrá en contacto al asignar la directiva. Por ejemplo: -DomainController atl-dc-001.litwareinc.com.

Si no está especificado, Grant-CsPresencePolicy se pondrá en contacto con el controlador de dominio disponible más cercano al asignar la directiva.

PassThru

Opcional

Permite pasar un objeto de usuario a través de la canalización que representa al usuario al que se asigna la directiva. De forma predeterminada, el cmdlet Grant-CsPresencePolicy no transfiere objetos a través de la canalización.

WhatIf

Opcional

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Valor de cadena u objeto Microsoft.Rtc.Management.WritebleConfig.Policy.Presence.PresencePolicy. Grant-CsPresencePolicy acepta entradas transferidas de valores de cadena de caracteres que representen el parámetro Identity de una cuenta de usuario. Este cmdlet también acepta la entrada transferida de objetos de usuario.

Tipos de valores devueltos

De forma predeterminada, Grant-CsPresencePolicy no devuelve ningún objeto ni valor. Sin embargo, si incluye el parámetro PassThru, el cmdlet devolverá instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

Ejemplo

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

Grant-CsPresencePolicy -Identity "Ken Myer" -PolicyName "RedmondPresencePolicy"

El comando que se muestra en el Ejemplo 1 asigna la directiva de presencia por usuario RedmondPresencePolicy a un solo usuario: el que tiene la Identidad Ken Myer.

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

Get-CsUser -OU "OU=Redmond,dc=litwareinc,dc=com" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"

En el ejemplo 2, la directiva de presencia RedmondPresencePolicy se asigna a todos los usuarios con cuentas en la OU de Redmond en Active Directory Domain Services (AD DS). Para hacerlo, el comando usa primero Get-CsUser y el parámetro OU para devolver una colección de todas las cuentas de usuario que se encuentran en la OU de Redmond (OU=Redmond,dc=litwareinc,dc=com). A continuación, esta colección se transfiere a Grant-CsPresencePolicy, que asigna la directiva RedmondPresencePolicy a cada usuario de la colección.

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

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"

El comando anterior asigna la directiva RedmondPresencePolicy a todos los usuarios que trabajan en la ciudad de Redmond. Para llevar a cabo esta tarea, el comando usa primero Get-CsUser y el parámetro LDAPFilter para devolver una colección de todos los usuarios que trabajan en Redmond; el valor de filtro "l=Redmond" limita los datos devueltos a los usuarios de Redmond. (En el lenguaje de consulta LDAP, una L minúscula significa "localidad".) A continuación, la colección devuelta se transfiere a Grant-CsPresencePolicy, que asigna la directiva RedmondPresencePolicy a cada usuario de la colección.

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

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName $Null

El comando que se muestra en el ejemplo 4 quita la asignación de todas las directivas de presencia por usuario asignadas anteriormente a los usuarios que trabajan en Redmond. Si se llama a Grant-CsPresencePolicy y, al mismo tiempo, el parámetro PolicyName se establece en un valor nulo($Null), el cmdlet quita todas las directivas de presencia por usuario asignada a los usuarios afectados por el comando.