Compartir a través de

  • Artículo

New-CsPresencePolicy

 

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

Crea una nueva directiva de presencia en el ámbito de sitio o en el ámbito por usuario.

Sintaxis

New-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-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 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 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 a Microsoft Lync Server 2010, los suscriptores y 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. 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 New-CsPresencePolicy proporciona la manera de crear directivas de presencia personalizadas en el ámbito de sitio o en el ámbito por usuario. Las directivas creadas en el ámbito de sitio se aplican automáticamente a dicho sitio; las directivas creadas en el ámbito por usuario se deben asignar a usuarios ejecutando el cmdlet Grant-CsPresencePolicy. Tenga en cuenta que no puede crear una nueva directiva de presencia en el ámbito global ni una segunda directiva de presencia en un sitio individual. (Por ejemplo, el sitio Redmond sólo puede hospedar una directiva de presencia).

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Identidad Xds

Identificador único para la nueva directiva de presencia. Para crear una nueva directiva por usuario, use la sintaxis siguiente: -Identity "RedmondPresencePolicy". Para crear una nueva directiva en el ámbito de sitio, use la sintaxis del siguiente ejemplo: -Identity "site:Redmond".

Tenga en cuenta que no puede crear una nueva directiva de presencia en el ámbito global. Además, el comando dará error si el sitio en cuestión ya hospeda una directiva de presencia o si intenta usar la Identidad de una directiva por usuario que ya exista.

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

Número máximo de suscripciones a categorías permitidas en un momento dado. La suscripción a categorías representa una solicitud de determinadas categorías de información; por ejemplo, la solicitud de datos del calendario por parte de una aplicación.

MaxCategorySubscription se puede establecer en cualquier valor entero comprendido 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 forma predeterminada, cada vez que se le agrega a una lista de contactos de otro usuario se muestra en pantalla 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 descarte el cuadro de diálogo, cada notificación contará como un suscriptor que ha recibido un aviso.

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 ocurrir al ejecutar el comando.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

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

Ninguno. New-CsPresencePolicy no acepta la entrada transferida.

Tipos de valores devueltos

New-CsPresencePolicy crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

Ejemplo

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

New-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 400 -MaxCategorySubscription 500

El comando del Ejemplo 1 crea una nueva directiva de presencia por usuario con la identidad RedmondPresencePolicy. En este ejemplo, el valor de la propiedad MaxPromptedSubscriber se ha establecido en 400 y el valor de la propiedad MaxCategorySubscription se ha establecido en 500.

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

$x = New-CsPresencePolicy -Identity "RedmondPresencePolicy" -InMemory
$x.MaxPromptedSubscriber = 400
$x.MaxCategorySubscription = 500
Set-CsPresencePolicy -Instance $x

En el ejemplo 2, una nueva directiva de presencia por usuario se crea inicialmente en la memoria y es más tarde cuando se convierte en una directiva de presencia real. Para ello, el primer comando del ejemplo crea una directiva de presencia con la identidad RedmondPresencePolicy y almacena esta directiva en una variable llamada $x. El parámetro –InMemory garantiza que la directiva se cree solo en la memoria y que no se agregue de inmediato a Lync Server 2010.

Los comandos 2 y 3 se usan a continuación para configurar las propiedades MaxPromptedSubscriber y MaxCategorySubscription de la directiva virtual. Después de establecer los valores de directiva, la línea 4 usa Set-CsPresencePolicy y el parámetro Instance para crear una directiva de presencia real basada en la información almacenada en $x. Este paso final es crucial: si no activa Set-CsPresencePolicy, la directiva existirá únicamente en la memoria y desaparecerá cuando finalice la sesión de Windows PowerShell o elimine la variable $x.