Remove-CsPresencePolicy
Dernière rubrique modifiée : 2012-03-26
Supprime la stratégie de présence spécifiée.
Syntaxe
Remove-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Description détaillée
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 cmdlets 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 Microsoft Lync 2010 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 à Microsoft Lync Server 2010, les abonnés avertis et les abonnements aux catégories étaient gérés de manière globale. Avec les cmdlets 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 la cmdlet Remove-CsPresencePolicy. Cette cmdlet 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 2010 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 cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet 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 cmdlet 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ètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
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". La cmdlet 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. |
Force |
Facultatif |
Paramètre de commutateur |
Si vous utilisez ce paramètre, la cmdlet 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 |
Paramètre de commutateur |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Confirm |
Facultatif |
Paramètre de commutateur |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Objet Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy. Remove-CsPresencePolicy accepte les données transmises via le pipeline de l’objet de la stratégie de présence.
Types de retours
Aucun. Au lieu de cela, Remove-CsPresencePolicy supprime les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.
Exemple
-------------------------- Exemple 1 ------------------------
Remove-CsPresencePolicy -Identity "RedmondPresencePolicy"
La commande ci-dessus supprime la stratégie de présence utilisateur dont l’identité est RedmondPresencePolicy.
-------------------------- Exemple 2 ------------------------
Get-CsPresencePolicy -Filter "tag:*" | Remove-CsPresencePolicy
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 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 Remove-CsPresencePolicy qui supprime chaque stratégie dans la collection.
-------------------------- Exemple 3 ------------------------
Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 500} | 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 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 la cmdlet 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 Remove-CsPresencePolicy qui supprime toutes les stratégies de présence qui autorisent plus de 500 abonnés avertis.
Voir aussi
Autres ressources
Get-CsPresencePolicy
Grant-CsPresencePolicy
New-CsPresencePolicy
Set-CsPresencePolicy