Compartir a través de

  • Artículo

Get-CsPresencePolicy

 

Última modificación del tema: 2012-05-21

Devuelve información sobre las directivas de presencia configuradas para utilizar en su organización.

Sintaxis

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

Get-CsPresencePolicy [-Filter <String>] [-LocalStore <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 cmdlet 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 la cantidad máxima, no recibirá más notificaciones de contactos salvo que resuelva alguno de los cuadros de diálogo).

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.

El cmdlet Get-CsPresencePolicy devuelve información sobre todas las directivas de presencia configuradas para su uso en la organización.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsPresencePolicy localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. 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 "Get-CsPresencePolicy"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la directiva de presencia que se recuperará. Para devolver la directiva global, use la siguiente sintaxis: -Identity global. Para devolver una directiva configurada en el ámbito de sitio, use la sintaxis siguiente: -Identity "site:Redmond". Para devolver una directiva configurada en el ámbito de usuario, use la sintaxis siguiente: -Identity "RedmondPresencePolicy". No se pueden usar caracteres comodín al especificar la Identidad.

Si no se especifican los parámetros Identity ni Filter, Get-CsPresencePolicy devuelve todas las directivas de presencia configuradas para su uso en la organización.

Filter

Opcional

Cadena de caracteres

Permite usar comodines al especificar la directiva (o directivas) que se devolverá. Por ejemplo, esta sintaxis devuelve todas las directivas de presencia configuradas en el ámbito del sitio: -Filter "site:*".

Los parámetros Filter e Identity no se pueden usar en el mismo comando.

LocalStore

Opcional

Parámetro modificador

Recupera los datos de directiva de presencia a partir de una réplica local de Almacén de administración central en lugar de hacerlo directamente desde Almacén de administración central.

Tipos de entrada

Ninguno. Get-CsPresencePolicy no acepta entradas transferidas.

Tipos de valores devueltos

Get-CsPresencePolicy devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

Ejemplo

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

Get-CsPresencePolicy

El comando que se muestra en el Ejemplo 1 devuelve información sobre todas las directivas de presencia configuradas para su uso en la organización. Para hacerlo, se llama a Get-CsPresencePolicy sin ningún parámetro.

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

Get-CsPresencePolicy -Identity "RedmondPresencePolicy"

En el Ejemplo 2 se devuelve una sola directiva de presencia de usuario: la directiva con Identidad RedmondPresencePolicy.

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

Get-CsPresencePolicy -Filter "site:*"

El comando anterior devuelve información sobre todas las directivas de presencia que se han configurado en el ámbito de sitio. Para ello, el comando usa el parámetro Filter y el valor de filtro "site:*", que limita los datos devueltos a todas las directivas de presencia con un parámetro Identity que comienza con el valor de cadena "site:".

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

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -le 100}

En el Ejemplo 4, se devuelve la información de todas las directivas de presencia que limitan a 100 o menos la cantidad máxima de suscriptores que han recibido un aviso. Para realizar esta tarea, el comando llama primero a Get-CsPresencePolicy sin ningún parámetro para devolver una colección de todas las directivas de presencia configuradas para su uso en la organización. A continuación, esta recopilación se transfiere al cmdlet Where-Object , que selecciona solo las directivas cuya propiedad MaxPromptedSubscriber es menor o igual que 100.