Partager via

  • Article

Get-CsPresencePolicy

 

Dernière rubrique modifiée : 2012-05-21

Retourne des informations sur les stratégies de présence configurées pour être utilisées dans votre organisation.

Syntaxe

Get-CsPresencePolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsPresencePolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Description détaillée

Les informations de présence (qui vous permettent notamment de savoir si un contact est disponible pour participer à une conversation par messagerie instantanée) sont inestimables. Toutefois, elles impliquent également un coût : en effet, plus vous avez d’abonnements de présence, plus la bande passante réseau doit se consacrer à la mise à jour des informations de présence. Si la bande passante réseau est un problème, vous pouvez limiter le nombre d’abonnements de présence dont un utilisateur peut disposer.

Les cmdlets CsPresencePolicy permettent de gérer deux aspects importants des abonnements de présence : les abonnés invités et les abonnements par catégorie. 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é invité. La propriété MaxPromptedSubscriber de la stratégie de présence vous permet de spécifier le nombre maximal de notifications restées sans réponse qu’un utilisateur peut recevoir. (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 par catégorie représentent une demande pour une 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 placer une limite sur le nombre d’abonnements par catégorie qu’un utilisateur peut avoir.

Dans les versions antérieures à Microsoft Lync Server 2010, les abonnés invités 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 vous permet de contrôler l’utilisation de la bande passante tout en vous assurant que les utilisateurs ont accès aux informations de présence dont ils ont besoin pour travailler.

La cmdlet Get-CsPresencePolicy vous fournit un moyen de retourner l’information sur les stratégies de présence configurées dans votre organisation.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsPresencePolicy : RTCUniversalUserAdmins, 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 "Get-CsPresencePolicy"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la stratégie de présence à récupérer. Pour retourner la stratégie globale, utilisez cette syntaxe : -Identity global. Pour retourner une stratégie configurée au niveau du site, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond". Pour retourner une stratégie configurée au niveau du site, utilisez une syntaxe similaire à celle-ci : -Identity "RedmondPresencePolicy". Vous ne pouvez pas utiliser de caractères génériques pour spécifier l’identité.

Si ni le paramètre Identity, ni le paramètre Filter ne sont spécifiés, alors Get-CsPresencePolicy retourne toutes les stratégies de présence configurées pour être utilisées dans l’organisation.

Filter

Facultatif

Chaîne

Vous permet d’utiliser les caractères génériques pour spécifier la stratégie (ou les stratégies) à retourner. Par exemple, cette syntaxe retourne toutes les stratégies de présence configurées au niveau de l'étendue Site : -Filter "site:*".

Les paramètres Filter et Identity ne peuvent pas être utilisés dans la même commande.

LocalStore

Facultatif

Paramètre de commutateur

Extrait les données de stratégie de présence à partir du réplica local de la magasin central de gestion et non du magasin central de gestion lui-même.

Types d’entrées

Aucun. Get-CsPresencePolicy n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Get-CsPresencePolicy retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

Exemple

-------------------------- Exemple 1 --------------------------

Get-CsPresencePolicy

La commande indiquée dans l’exemple 1 retourne les informations sur les stratégies de présence configurées pour être utilisées dans l’organisation. Cela est possible en appelant la cmdlet Get-CsPresencePolicy sans aucun paramètre.

-------------------------- Exemple 2 --------------------------

Get-CsPresencePolicy -Identity "RedmondPresencePolicy"

L’exemple 2 retourne une seule stratégie de présence par utilisateur : la stratégie avec l’identité RedmondPresencePolicy.

-------------------------- Exemple 3 --------------------------

Get-CsPresencePolicy -Filter "site:*"

La commande ci-dessus retourne toutes les informations de présence configurées dans l’étendue Site. Pour ce faire, la commande utilise le paramètre Filter et la valeur de filtre « site:* ». Ce filtre limite les données retournées à toutes les stratégies de présence ayant une identité qui commence par la valeur de chaîne « site: ».

-------------------------- Exemple 4 --------------------------

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -le 100}

Dans l’exemple 4, les informations sont renvoyées pour toutes les stratégies de présence qui restreignent le nombre maximal d’utilisateurs inscrits à 100 ou moins. Pour effectuer cette tâche, la commande appelle d’abord Get-CsPresencePolicy (sans paramètres) afin de renvoyer une collection de toutes les stratégies de présence de l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui ne sélectionne que les stratégies pour lesquelles la propriété MaxPromptedSubscriber est inférieure ou égale à 100.