New-CsPresencePolicy
Dernière rubrique modifiée : 2012-03-25
Crée une nouvelle stratégie de présence soit au niveau de l’étendue Site, soit au niveau de l’étendue Utilisateur.
Syntaxe
New-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Les informations de présence (qui permettent notamment de savoir si un contact est disponible pour prendre part à une conversation par messagerie instantanée) constituent un outil précieux. Il existe toutefois une contrepartie aux avantages procurés par ces informations de présence : plus vous disposez d’abonnements aux informations de présence, plus la bande passante du réseau consacrée à la mise à jour de ces informations est importante. Si la bande passante constitue un problème, vous serez peut être amené à limiter le nombre d’abonnements de présence dont chaque 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 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 de la stratégie de présence permet de spécifier le nombre maximum de boîtes de dialogue non résolues qu’un utilisateur peut avoir. (Si un utilisateur atteint ce nombre maximum, il ne recevra plus de notifications de contact, du moins jusqu’à ce qu’il résolve un certain nombre de boîtes de dialogue.)
Les enregistrements aux catégories représentent une requête pour une catégorie spécifique d’informations, comme une application demandant des données de calendrier. La propriété MaxCategorySubscription permet aux administrateurs d’établir une limite sur le 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 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. Vous pouvez ainsi contrôler la bande passante tout en vous assurant que les utilisateurs ont accès aux informations de présence dont ils ont besoin pour faire leur travail.
La cmdlet New-CsPresencePolicy permet de créer des stratégies de présence personnalisées soit au niveau de l’étendue Site, soit au niveau de l’étendue Utilisateur. Les stratégies créées au niveau de l’étendue Site sont automatiquement appliquées au site. Les stratégies créées au niveau de l’étendue Utilisateur doivent être affectées aux utilisateurs par l’exécution de la cmdlet Grant-CsPresencePolicy. Notez que vous ne pouvez pas créer de nouvelle stratégie de présence au niveau de l’étendue globale, ni créer une deuxième stratégie de présence sur un site individuel. (Par exemple, le site Redmond ne peut héberger qu’une stratégie de présence.)
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-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 "New-CsPresencePolicy"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
XdsIdentity |
Identificateur unique de la nouvelle stratégie de présence. Pour créer une nouvelle stratégie Utilisateur, utilisez une syntaxe similaire à celle-ci : -Identity "RedmondPresencePolicy". Pour créer une nouvelle stratégie au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity "site:Redmond". Notez que vous ne pouvez pas créer de nouvelle stratégie de présence au niveau de l’étendue globale. En outre, votre commande échouera si le site en question héberge déjà une stratégie de présence ou si vous essayez d’utiliser l’identité d’une stratégie utilisateur qui existe déjà. |
|
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 données sur les utilisateurs auxquels la stratégie doit être affectée. |
MaxCategorySubscription |
Facultatif |
Entier |
Nombre maximal d’abonnements simultanés aux catégories. Un enregistrement aux catégories représente une requête pour une catégorie spécifique d’informations, comme une application demandant des données de calendrier. MaxCategorySubscription peut être défini sur n’importe quel entier entre 0 et 3 000. La valeur par défaut est 1 000. |
MaxPromptedSubscriber |
Facultatif |
Entier |
Nombre maximal d’abonnés promus 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 apparaît sur votre écran 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. Dans la mesure où vous ne refusez pas l’invitation, chaque notification compte comme un abonné invité. MaxPromptedSubscriber peut être défini sur n’importe quel entier compris 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. |
InMemory |
Facultatif |
Paramètre de commutateur |
Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante. |
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
Aucun. New-CsPresencePolicy n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsPresencePolicy crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.
Exemple
-------------------------- Exemple 1 ------------------------
New-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 400 -MaxCategorySubscription 500
La commande illustrée dans l’exemple 1 crée une nouvelle stratégie de présence utilisateur dont l’identité est RedmondPresencePolicy. Dans cet exemple, la valeur de la propriété MaxPromptedSubscriber est définie sur 400 et la valeur de la propriété MaxCategorySubscription est définie sur 500.
-------------------------- Exemple 2 ------------------------
$x = New-CsPresencePolicy -Identity "RedmondPresencePolicy" -InMemory
$x.MaxPromptedSubscriber = 400
$x.MaxCategorySubscription = 500
Set-CsPresencePolicy -Instance $x
Dans l’exemple 2, une nouvelle stratégie de présence utilisateur est initialement créée dans la mémoire, avant d’être convertie en une stratégie de présence réelle. Pour ce faire, la première commande de l’exemple crée une stratégie de présence avec l’identité RedmondPresencePolicy et la stocke dans la variable $x. Le paramètre InMemory garantit que la stratégie est créée en mémoire seulement et qu’elle n’est pas immédiatement ajoutée à Lync Server 2010.
Les commandes 2 et 3 sont ensuite utilisées pour configurer MaxPromptedSubscriber et les propriétés MaxCategorySubscription de la stratégie virtuelle. Une fois les valeurs de la stratégie définies, la ligne 4 utilise Set-CsPresencePolicy et le paramètre Instance pour créer une stratégie de présence réelle en fonction des informations stockées dans $x. Cette étape finale est essentielle : si vous n’appelez pas la cmdlet Set-CsPresencePolicy, la stratégie existera en mémoire uniquement et disparaîtra au moment même où vous fermerez Windows PowerShell ou supprimerez la variable $x.
Voir aussi
Autres ressources
Get-CsPresencePolicy
Grant-CsPresencePolicy
Remove-CsPresencePolicy
Set-CsPresencePolicy