Partager via

  • Article

Set-CsPresencePolicy

 

Dernière rubrique modifiée : 2012-03-25

Modifie une stratégie de présence existante.

Syntaxe

Set-CsPresencePolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]

Set-CsPresencePolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<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 vous 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 Set-CsPresencePolicy vous permet de modifier toute stratégie de présence configurée pour être utilisée dans votre organisation. Le fait de modifier une stratégie de présence implique simplement de modifier la valeur de la propriété MaxPromptedSubscriber et/ou de la propriété MaxCategorySubscription.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Identificateur unique de la stratégie de présence à modifier. Pour modifier la stratégie globale, utilisez la syntaxe suivante : -Identity global. Pour modifier une stratégie au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond". Pour modifier une stratégie utilisateur, utilisez une syntaxe de type : -Identity "RedmondPresencePolicy".

Instance

Facultatif

Objet de stratégie de présence

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

Description

Facultatif

Chaîne

Permet aux administrateurs de fournir un texte supplémentaire en accompagnement d’une stratégie de présence. Par exemple, la description peut contenir des informations sur les utilisateurs auxquels la stratégie doit être affectée.

MaxCategorySubscription

Facultatif

Entier

Nombre maximal d’abonnements par catégorie autorisés. Un abonnement par catégorie représente 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 peut être définie sur une valeur entière comprise entre 0 et 3 000, inclus ; la valeur par défaut est 1 000.

MaxPromptedSubscriber

Facultatif

Entier

Nombre maximal d’abonnés invités qu’un utilisateur peut avoir en même temps. Par défaut, dès que vous êtes ajouté à la liste de contacts d’un utilisateur, une boîte de dialogue de notification s’affiche et vous donne la possibilité notamment d’ajouter la personne à votre propre liste de contacts ou de la bloquer afin de l’empêcher de voir votre présence. Tant que vous ignorez la boîte de dialogue, chaque notification est comptée comme un abonné invité.

MaxPromptedSubscriber peut être défini sur n’importe quel entier entre 0 et 600 inclus. La valeur par défaut est 200. Si vous définissez cette valeur sur 0, les utilisateurs ne recevront pas de notification quand ils sont ajoutés à la liste de contacts d’un autre utilisateur.

Force

Facultatif

Paramètre de commutateur

Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande.

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. Set-CsPresencePolicy accepte les données transmises via le pipeline de l’objet de la stratégie de présence.

Types de retours

Set-CsPresencePolicy ne retourne ni valeur, ni objet. En fait, la cmdlet modifie les instances existantes de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

Exemple

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

Set-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 300

La commande illustrée dans l’exemple 1 modifie la stratégie de présence utilisateur RedmondPresencePolicy. Dans cet exemple, la valeur de la propriété MaxPromptedSubscriber est définie sur 300.

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

Get-CsPresencePolicy | Set-CsPresencePolicy -MaxPromptedSubscriber 300

La commande illustrée dans l’exemple 2 est une variation de la commande de l’exemple 1 ; ici, toutefois, la propriété MaxPromptedSubscriber est définie sur 300 pour toutes les stratégies de présence configurées pour être utilisées dans l’organisation. Pour ce faire, la commande appelle d’abord Get-CsPresencePolicy sans aucun paramètre, qui retourne 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 Set-CsPresencePolicy, qui définit la valeur de la propriété MaxPromptedSubscriber de chaque stratégie de la collection sur 300.

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

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 300} | Set-CsPresencePolicy -MaxPromptedSubscriber 300

L’exemple 3 illustre comment configurer les stratégies de présence de votre organisation pour qu’aucune d’elles n’autorise plus de 300 abonnés invités. Pour effectuer cette tâche, la commande appelle d’abord Get-CsPresencePolicy (sans paramètre) afin de retourner une collection de toutes les stratégies de présence de l’organisation. Cette collection est alors redirigée vers la cmdlet Where-Object, qui sélectionne uniquement les stratégies dont la valeur de la propriété MaxPromptedSubscriber est supérieure à (-gt) 300. La collection filtrée est ensuite redirigée vers Set-CsPresencePolicy, qui prend chaque stratégie de la collection et définit le nombre maximal d’abonnés invités sur 300. Ainsi, aucune stratégie n’autorisera plus de 300 abonnés invités (certaines, d’ailleurs, pourront en autoriser moins).