Compartir a través de

  • Artículo

Remove-CsPresencePolicy

 

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

Quita la directiva de presencia especificada.

Sintaxis

Remove-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

La información de presencia, que permite saber, entre otras cosas, si un contacto está disponible para participar en una conversación de mensajería instantánea) resulta de gran utilidad. Pero también tiene sus inconvenientes: cuantos más suscriptores de presencia haya, más ancho de banda de red debe dedicarse a actualizar la información de presencia. Si el ancho de banda de red del que dispone es limitado, puede restringir el número de suscriptores de presencia que los usuarios pueden tener.

Los cmdlets CsPresencePolicy permiten administrar dos aspectos importantes de las suscripciones de presencia: suscriptores con avisos 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 descarte el elemento emergente, cada notificación cuenta como un suscriptor con aviso. La propiedad MaxPromptedSubscriber de la directiva de presencia permite especificar el número máximo de cuadros de diálogo de notificación sin responder que puede tener un usuario. (Si un usuario alcanza el número máximo, no recibirá más notificaciones de contacto, al menos hasta que descarte algunos de los cuadros de diálogo de notificación.)

Las suscripciones de categoría representan una solicitud de una categoría específica de información; por ejemplo, una aplicación que solicita datos de calendario. La propiedad MaxCategorySubscription permite a los administradores establecer un límite en el número de suscripciones de categoría que puede tener un usuario.

En las versiones anteriores a Microsoft Lync Server 2010, los suscriptores con avisos 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 incluso por usuario. De este modo, puede controlar el uso del ancho de banda y, al mismo tiempo, garantizar que los usuarios tienen acceso a la información de presencia que necesitan para desempeñar su trabajo.

Las directivas creadas en el ámbito de sitio o por usuario pueden quitarse en cualquier momento ejecutando el cmdlet Remove-CsPresencePolicy. También puede ejecutar este cmdlet con la directiva global, aunque, si lo hace, no se quitará dicha directiva. (Lync Server 2010 no permite quitar directivas globales.) Por el contrario, las dos propiedades de la directiva global (MaxPromptedSubscriber y MaxCategorySubscription) se restablecerán con los valores predeterminados.

Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Remove-CsPresencePolicy localmente los miembros de los siguientes grupos: 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 (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

Identidad Xds

Identificador único de la directiva de presencia que se va a quitar. Para quitar una directiva configurada en el ámbito de sitio, use una sintaxis similar a ésta: -Identity "site:Redmond". Para quitar una directiva configurada en el ámbito por usuario, use una sintaxis similar a ésta: -Identity "RedmondPresencePolicy".

Remove-CsPresencePolicy también puede ejecutarse con la directiva global; para ello, use esta sintaxis: -Identity global. Sin embargo, en ese caso, no se quitará la directiva global. Por el contrario, las propiedades de dicha directiva se restablecerán con los valores predeterminados.

Force

Opcional

Parámetro modificador

Si está presente, hace que Remove-CsPresencePolicy elimine la directiva por usuario, incluso si está asignada a uno o varios usuarios. Si no está presente, se pedirá confirmación antes de eliminar una directiva que se está utilizando.

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. Remove-CsPresencePolicy acepta la entrada por canalización del objeto de directiva de presencia.

Tipos de valores devueltos

Ninguno. En su lugar, Remove-CsPresencePolicy elimina instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

Ejemplo

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

Remove-CsPresencePolicy -Identity "RedmondPresencePolicy"

El comando anterior elimina la directiva de presencia por usuario con el valor de Identity RedmondPresencePolicy.

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

Get-CsPresencePolicy -Filter "tag:*" | Remove-CsPresencePolicy

El comando del Ejemplo 2 elimina todas las directivas de presencia configuradas en el ámbito por usuario. (Estas directivas tienen un valor de Identity que comienza por el prefijo "tag:".) Para ello, el comando usa primero Get-CsPresencePolicy y el parámetro Filter para devolver todas las directivas de presencia por usuario; el valor de filtro "tag:*" limita los datos que se devuelven para incluir sólo las directivas cuya identidad comience con el valor alfanumérico "tag:". A continuación, la recopilación filtrada se transfiere a Remove-CsPresencePolicy, que elimina todas las directivas de la recopilación.

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

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 500} | Remove-CsPresencePolicy

El Ejemplo 3 elimina todas las directivas de presencia que permiten más de 500 suscriptores con avisos. Para ello, el comando llama primero a Get-CsPresencePolicy sin ningún parámetro, para devolver una recopilación de todas las directivas de presencia configuradas para su uso en la organización. Esta recopilación se transfiere al cmdlet Where-Object, que selecciona sólo las directivas en las que la propiedad MaxPromptedSubscriber es mayor que 500. A su vez, esta recopilación filtrada se transfiere a Remove-CsPresencePolicy, que elimina todas las directivas de presencia que permiten más de 500 suscriptores con avisos.