Compartir a través de

  • Artículo

Set-CsPresencePolicy

 

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

Modifica una directiva de presencia existente.

Sintaxis

Set-CsPresencePolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]

Set-CsPresencePolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

La información de presencia (que, entre otras cosas, le permite saber si un contacto está disponible para participar en una conversación de mensajería instantánea) es invaluable. Sin embargo, al mismo tiempo, existe un costo asociado con la información de presencia: Cuanto más suscripciones de presencia tenga, más ancho de banda de red debe reservarse para actualizar la información de presencia. Si le preocupa el ancho de banda de red, sería recomendable que limite la cantidad de suscripciones de presencia que pueden tener los usuarios.

Los cmdlet CsPresencePolicy le permiten administrar dos aspectos importantes de las suscripciones de presencia: Suscriptores solicitados y suscripciones de categoría. Cuando se agrega su usuario a la lista de contactos de Microsoft Lync 2010 de otra persona, de forma predeterminada usted recibe una notificación emergente para informarle de que se le ha agregado a la lista. Hasta el momento en que cierre el elemento emergente, cada notificación cuenta como un suscriptor con aviso. La propiedad MaxPromptedSubscriber de la directiva de presencia le permite especificar la cantidad máxima de diálogos de notificación no resueltos que puede tener un usuario. (Si un usuario alcanza la cantidad máxima, no recibirá nuevas notificaciones de contacto [al menos, no hasta que algunos de esos diálogos se hayan resuelto]).

Las suscripciones de categoría representan una solicitud para una categoría específica de información; por ejemplo, una solicitud que requiera datos de calendario. La propiedad MaxCategorySubscription le permite a los administradores poner un límite a la cantidad de suscripciones de categoría que puede tener un usuario.

En las versiones anteriores a Microsoft Lync Server 2010, los suscriptores y las categorías de suscripción se administraban de manera global. Ahora, con los cmdlets CsPresencePolicy, puede administrar las suscripciones de presencia en el ámbito global, de sitio o por usuario. Esto le permite controlar el uso del ancho de banda mientras, al mismo tiempo, garantiza que los usuarios tengan acceso a la información de presencia que necesitan para hacer sus tareas.

El cmdlet Set-CsPresencePolicy lo habilita para modificar cualquiera de las directivas de presencia configuradas en su organización. La modificación de una directiva de presencia simplemente significa cambiar el valor de la propiedad MaxPromptedSubscriber o la propiedad MaxCategorySubscription.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Set-CsPresencePolicy en forma local: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identificador único para la directiva de presencia que se debe modificar. Para modificar la directiva global, use esta sintaxis: -Identity global. Para modificar una directiva en el ámbito del sitio, use una sintaxis similar a esta: -Identity "site:Redmond". A fin de modificar una directiva por usuario, use una sintaxis como esta: -Identity "RedmondPresencePolicy".

Instance

Opcional

Objeto de directiva de presencia

Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales.

Description

Opcional

Cadena de caracteres

Permite a los administradores proporcionar un texto adicional a la directiva de presencia. Por ejemplo, la descripción puede incluir información sobre los usuarios a los que se debe asignar la directiva.

MaxCategorySubscription

Opcional

Entero

La cantidad máxima de suscripciones de categoría permitidas en cualquier momento. Una suscripción de categoría representa una solicitud para una categoría específica de información; por ejemplo, una solicitud que requiera datos de calendario.

MaxCategorySubscription puede establecerse en cualquier valor entero entre 0 y 3000; el valor predeterminado es 1000.

MaxPromptedSubscriber

Opcional

Entero

Número máximo de suscriptores con avisos que un usuario puede tener en un momento dado. De manera predeterminada, cada vez que se le agrega a una lista de contactos de otro usuario se muestra un cuadro de diálogo de notificación en el que se le informa de este hecho y se le brinda la oportunidad de realizar acciones del tipo agregar la persona a su lista de contactos o bloquearla y evitar que conozca su presencia. Hasta que realice una acción y rechace el cuadro de diálogo, cada notificación cuenta como un suscriptor solicitado.

MaxPromptedSubscriber se puede establecer en cualquier valor entero comprendido entre 0 y 600, ambos incluidos; el valor predeterminado es 200. Si establece este valor en 0, los usuarios no recibirán notificaciones cuando se les agregue a la lista de contacto de otro usuario.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando.

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

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy. Set-CsPresencePolicy acepta entradas canalizadas del objeto de directivas de presencia.

Tipos de valores devueltos

Set-CsPresencePolicy no devuelve ningún valor ni objeto. En su lugar, el cmdlet modifica instancias existentes del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

Ejemplo

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

Set-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 300

El comando que se muestra en el Ejemplo 1 modifica la directiva de presencia por usuario RedmondPresencePolicy. En este ejemplo, el valor de la propiedad MaxPromptedSubscriber se establece en 300.

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

Get-CsPresencePolicy | Set-CsPresencePolicy -MaxPromptedSubscriber 300

El comando que se muestra en el Ejemplo 2 es una variación del comando usado en el Ejemplo 1. Sin embargo, en este caso, la propiedad MaxPromptedSubscriber se establece en 300 para todas las directivas de presencia configuradas en la organización. Para ello, el comando llama primero a Get-CsPresencePolicy sin ningún parámetro adicional; esto devuelve una recopilación de todas las directivas de presencia configuradas en su organización. A continuación, esta recopilación se canaliza a Set-CsPresencePolicy, que cambia el valor de MaxPromptedSubscriber de cada directiva en la recopilación a 300.

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

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 300} | Set-CsPresencePolicy -MaxPromptedSubscriber 300

El Ejemplo 3 muestra cómo puede configurar las directivas de presencia en su organización para asegurar que ninguna directiva permita más de 300 suscriptores solicitados. A fin de realizar esta tarea, el comando primero llama a Get-CsPresencePolicy sin ningún parámetro para devolver una recopilación de todas las directivas de presencia en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, que selecciona únicamente las directivas cuyo valor de la directiva MaxPromptedSubscriber es mayor de 300. Luego, la recopilación filtrada se canaliza a Set-CsPresencePolicy, que toma cada directiva en la recopilación y establece la cantidad máxima de suscriptores seleccionados en 300. Como resultado, ninguna directiva permitirá más de 300 suscriptores seleccionados, aunque algunas directivas podrían permitir menos de 300 suscriptores.