Remove-CsPresencePolicy
Dernière rubrique modifiée : 2013-03-07
Supprime la stratégie de présence spécifiée. Cette applet de commande est une nouveauté de Lync Server 2010.
Remove-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
L’exemple 1 supprime la stratégie de présence utilisateur dont l’identité est RedmondPresencePolicy.
Remove-CsPresencePolicy -Identity "RedmondPresencePolicy"
La commande présentée dans l’exemple 2 supprime toutes les stratégies de présence qui ont été configurées au niveau de l’étendue Utilisateur. (Ces stratégies ont une identité qui commence par le préfixe « tag: ».) Pour réaliser cette tâche, la commande utilise d’abord l’applet de commande Get-CsPresencePolicy et le paramètre Filter pour retourner toutes les stratégies de présence utilisateur. La valeur de filtre « tag:* » limite les données retournées aux stratégies dont l’identité commence par la valeur de chaîne « tag: ». La collection filtrée est ensuite redirigée vers l’applet de commande Remove-CsPresencePolicy qui supprime chaque stratégie dans la collection.
Get-CsPresencePolicy -Filter "tag:*" | Remove-CsPresencePolicy
L’exemple 3 supprime toutes les stratégies de présence qui autorisent plus de 500 abonnés avertis. Pour ce faire, la commande appelle d’abord l’applet de commande Get-CsPresencePolicy sans aucun paramètre pour retourner une collection de toutes les stratégies de présence configurées pour être utilisées dans l’organisation. Cette collection est ensuite redirigée vers l’applet de commande Where-Object qui sélectionne uniquement les stratégies dont la propriété MaxPromptedSubscriber est supérieure à 500. La collection filtrée est à son tour redirigée vers l’applet de commande Remove-CsPresencePolicy qui supprime toutes les stratégies de présence qui autorisent plus de 500 abonnés avertis.
Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 500} | Remove-CsPresencePolicy
Les informations de présence (lesquelles, entre autres choses, vous permettent de savoir si un contact est disponible pour participer à une conversation de messagerie instantanée) sont précieuses. Mais ces informations représentent un certain coût : plus vous disposez d’abonnements aux informations de présence, plus la bande passante à affecter à la mise à jour de ces informations de présence sera importante. Si la bande passante réseau est une préoccupation, vous pouvez limiter le nombre d’abonnements aux informations de présence que chaque utilisateur peut avoir.
Les applets de commande CsPresencePolicy permettent de gérer deux aspects importants des abonnements de présence : les abonnés avertis et les abonnements aux catégories. Lorsque vous êtes ajouté à la liste de contacts Lync d’une autre personne, vous recevez par défaut une notification contextuelle vous informant que vous avez été ajouté à cette liste. Jusqu’à ce que cette boîte de dialogue soit fermée, chaque notification compte comme un abonné averti. La propriété MaxPromptedSubscriber d’une stratégie de présence permet de spécifier le nombre maximum de boîtes de dialogue de notification non résolues qu’un utilisateur peut avoir. (Si un utilisateur atteint le nombre maximal, il ne reçoit plus de nouvelles notifications de contact, du moins pas temps qu’il n’a pas répondu à certaines de ces boîtes de dialogue.)
Les abonnements aux catégories représentent une demande de catégorie spécifique d’informations ; par exemple, une application qui demande des données de calendrier. La propriété MaxCategorySubscription permet aux administrateurs de fixer la limite du nombre d’abonnements aux catégories qu’un utilisateur peut avoir.
Dans les versions antérieures à Lync Server, les abonnés avertis et les abonnements aux catégories étaient gérés de manière globale. Avec les applets de commande CsPresencePolicy, vous pouvez désormais gérer ces abonnements aux informations de présence au niveau de l’étendue globale, au niveau de l’étendue Site, voire au niveau de l’étendue Utilisateur. Cela permet de contrôler l’utilisation de la bande passante tout en s’assurant que les utilisateurs ont accès aux informations de présence dont ils ont besoin pour travailler.
Les stratégies créées au niveau de l’étendue Site ou au niveau de l’étendue Utilisateur peuvent être supprimées à tout moment en exécutant l’applet de commande Remove-CsPresencePolicy. Cette applet de commande peut également être exécutée sur la stratégie globale ; toutefois, si vous faites cela, la stratégie globale ne sera pas réellement supprimée. (Lync Server n’autorise pas la suppression des stratégies globales.) Les deux propriétés dans la stratégie globale (MaxPromptedSubscriber et MaxCategorySubscription) seront en revanche réinitialisées selon leurs valeurs par défaut.
Personnes autorisées à exécuter cette applet de commande : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement l’applet de commande Remove-CsPresencePolicy : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette applet de commande a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsPresencePolicy"}
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
| Identity | Obligatoire | Microsoft.Rtc.Management.Xds.XdsIdentity | Identificateur unique de la stratégie de présence à supprimer. Pour supprimer une stratégie configurée au niveau de l’étendue Site, utilisez une syntaxe semblable à ceci : -Identity "site:Redmond". Pour supprimer une stratégie configurée au niveau de l’étendue Utilisateur, utilisez une syntaxe semblable à ceci : -Identity "RedmondPresencePolicy". L’applet de commande Remove-CsPresencePolicy peut également être exécutée sur la stratégie globale ; pour ce faire, utilisez la syntaxe suivante : -Identity global. Notez en revanche que la stratégie globale ne sera pas supprimée. Au lieu de cela, les propriétés dans cette stratégie seront réinitialisées d’après leurs valeurs par défaut. |
| Confirm | Facultatif | System.Management.Automation.SwitchParameter | Vous demande confirmation avant d’exécuter la commande. |
| Force | Facultatif | System.Management.Automation.SwitchParameter | Si vous utilisez ce paramètre, l’applet de commande Remove-CsPresencePolicy supprime la stratégie utilisateur, même si cette dernière est actuellement affectée à un utilisateur au minimum. Dans le cas contraire, le système vous demandera de confirmer la demande de suppression avant de supprimer une stratégie en cours d’utilisation. |
| WhatIf | Facultatif | System.Management.Automation.SwitchParameter | Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Objet Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy. L’applet de commande Remove-CsPresencePolicy accepte les données redirigées de l’objet de la stratégie de présence.
Aucun. Au lieu de cela, l’applet de commande Remove-CsPresencePolicy supprime les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.
