Grant-CsPresencePolicy
Dernière rubrique modifiée : 2012-03-23
Accorde une stratégie utilisateur de présence à un utilisateur ou un groupe d’utilisateurs.
Syntaxe
Grant-CsPresencePolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <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 tant 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.
Quand vous créez une stratégie utilisateur, cette dernière n’est pas assignée automatiquement à qui que ce soit. En fait, les stratégies de présence utilisateur doivent être affectées explicitement aux utilisateurs (ou groupes d’utilisateurs) en exécutant la cmdlet Grant-CsPresencePolicy.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Grant-CsPresencePolicy : RTCUniversalUserAdmins. 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 "Grant-CsPresencePolicy"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
Indique l’identité du compte d’utilisateur à assigner à la stratégie de présence. Les identités utilisateur peuvent être spécifiées dans l’un des quatre formats suivants : 1) L’adresse SIP de l’utilisateur ; 2) Le nom d’utilisateur principal de l’utilisateur ; 3) Le nom de domaine et le nom d’ouverture de session de l’utilisateur, sous la forme domaine\ouverture de session (par exemple, litwareinc\kenmyer) ; et 4) Le nom complet Active Directory de l’utilisateur (par exemple, Ken Myer). Les identités utilisateur peuvent être spécifiées à l’aide d’un nom unique Active Directory. En outre, vous pouvez recourir à l’astérisque (caractère générique *) si vous utilisez le nom complet comme identité utilisateur. Par exemple, l’identité « * Smith » retourne tous les utilisateurs dont le nom complet se termine par la valeur de chaîne « Smith ». |
|
PolicyName |
Obligatoire |
Identité de la stratégie Utilisateur à affecter. Par exemple : -PolicyName "RedmondPresencePolicy". Le nom PolicyName est l’identité de la stratégie moins le préfixe « tag: » . Par exemple, pour une stratégie dont l’identité est « tag:NorthAmericaPresencePolicy », PolicyName est égal à « NorthAmericaPresencePolicy ». |
|
DomainController |
Facultatif |
Nom complet du contrôleur de domaine à contacter quand vous affectez la stratégie. Par exemple : -DomainController atl-dc-001.litwareinc.com. En l’absence de spécifications, Grant-CsPresencePolicy contactera le contrôleur de domaine disponible le plus proche pour affecter la stratégie. |
|
PassThru |
Facultatif |
Permet de transmettre un objet d’utilisateur via le pipeline qui représente l’utilisateur auquel la stratégie est affectée. Par défaut, la cmdlet Grant-CsPresencePolicy ne transmet aucun objet via le pipeline. |
|
WhatIf |
Facultatif |
Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
|
Confirm |
Facultatif |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Valeur de chaîne ou objet Microsoft.Rtc.Management.WritebleConfig.Policy.Presence.PresencePolicy. Grant-CsPresencePolicy accepte la saisie de données transmises via le pipeline de valeurs de chaîne qui représentent l’identité d’un compte d’utilisateur. La cmdlet accepte également la saisie de données transmises via le pipeline pour les objets utilisateur.
Types de retours
Par défaut, Grant-CsPresencePolicy ne retourne aucun objet, ni aucune valeur. Toutefois, si vous incluez le paramètre PassThru, la cmdlet retourne des instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.
Exemple
-------------------------- Exemple 1 --------------------------
Grant-CsPresencePolicy -Identity "Ken Myer" -PolicyName "RedmondPresencePolicy"
La commande illustrée à l’exemple 1 assigne la stratégie de présence utilisateur RedmondPresencePolicy à un seul utilisateur : l’utilisateur avec l’identité Ken Myer.
-------------------------- Exemple 2 --------------------------
Get-CsUser -OU "OU=Redmond,dc=litwareinc,dc=com" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"
Dans l’exemple 2, la stratégie de présence RedmondPresencePolicy est affectée à tous les utilisateurs ayant des comptes dans l’unité d’organisation Redmond dans services de domaine Active Directory (AD DS). Pour ce faire, la commande utilise d’abord Get-CsUser et le paramètre OU pour renvoyer une collection de tous les comptes d’utilisateur présents dans l’unité d’organisation Redmond (OU=Redmond,dc=litwareinc,dc=com). La collection est ensuite redirigée vers Grant-CsPresencePolicy qui affecte à chaque utilisateur de la collection la stratégie RedmondPresencePolicy.
-------------------------- Exemple 3 --------------------------
Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"
La commande précédente assigne la stratégie RedmondPresencePolicy à tous les utilisateurs qui travaillent dans la ville de Redmond. Pour ce faire, la commande utilise d’abord Get-CsUser et le paramètre LDAPFilter pour retourner une collection de tous les utilisateurs qui travaillent à Redmond. La valeur de filtre « l=Redmond » restreint les informations retournées aux utilisateurs de Redmond. (Dans le langage de requête LDAP, I en minuscule est l’abréviation de « localité ».) La collection extraite est ensuite redirigée vers Grant-CsPresencePolicy qui affecte à chaque utilisateur de la collection la stratégie RedmondPresencePolicy.
-------------------------- Exemple 4 --------------------------
Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName $Null
La commande illustrée à l’exemple 4 annule l’affectation de toutes les stratégies de présence Utilisateur préalablement affectées aux utilisateurs qui travaillent à Redmond. En appelant Grant-CsPresencePolicy et en définissant le paramètre PolicyName sur une valeur null ($Null), la cmdlet supprime toute stratégie de présence Utilisateur affectée aux utilisateurs concernés par la commande.
Voir aussi
Autres ressources
Get-CsPresencePolicy
New-CsPresencePolicy
Remove-CsPresencePolicy
Set-CsPresencePolicy