Partager via

  • Article

Get-CsClientPolicy

 

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

Retourne des informations sur les stratégies de clients configurées pour être utilisées dans votre organisation. Les stratégies de clients permettent notamment de déterminer les fonctions de Microsoft Lync 2010 qui sont disponibles pour les utilisateurs ; par exemple, vous pouvez accorder à certains utilisateurs le droit de transférer des fichiers et refuser ce droit à d'autres utilisateurs.

Syntaxe

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

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

Description détaillée

Dans Lync Server 2010, les stratégies de clients remplacent les paramètres de stratégie de groupe utilisés dans les précédentes versions du produit. Dans Microsoft Office Communicator 2007 et Microsoft Office Communicator 2007 R2, la stratégie de groupe était utilisée pour aider à déterminer ce que les utilisateurs pouvaient faire avec Communicator et avec d'autres clients ; par exemple, certains paramètres de stratégie de groupe déterminaient si les utilisateurs pouvaient ou non enregistrer une transcription de leurs sessions de messagerie instantanée, si les informations de Microsoft Outlook étaient incorporées à leurs informations de présence et s'ils pouvaient ou non inclure des émoticônes ou du texte mis en forme dans les messages instantanés.

Bien que la technologie de stratégie de groupe soit utile, elle impose tout de même certaines restrictions, notamment lorsqu'elle est appliquée à Lync Server 2010. Tout d'abord, la stratégie de groupe est conçue pour être appliquée par domaine ou par unité d'organisation ; elle ne permet pas de cibler facilement les stratégies sur un groupe d'utilisateurs en particulier (par exemple, tous les utilisateurs d'un service particulier ou tous les utilisateurs qui occupent une fonction précise). D'autre part, la stratégie de groupe ne s'applique qu'aux utilisateurs qui se connectent au domaine à partir d'un ordinateur. La stratégie de groupe ne s'applique pas aux utilisateurs qui accèdent au système par Internet ou grâce à un téléphone mobile. Cela signifie que le même utilisateur peut avoir une expérience très différente en fonction du périphérique qu'il utilise pour se connecter et de l'emplacement à partir duquel il se connecte.

Pour résoudre ces incohérences, Lync Server 2010 utilise des stratégies de gestion des clients au lieu de la stratégie de groupe. Les stratégies de clients s’appliquent chaque fois qu’un utilisateur accède au système, quel que soit l’emplacement à partir duquel il se connecte et du type de périphérique qu’il utilise pour se connecter. De plus, comme d’autres stratégies Lync Server 2010, les stratégies de clients peuvent viser certains groupes d’utilisateurs. Vous pouvez même créer une stratégie personnalisée pour un seul utilisateur.

Les stratégies de clients peuvent être configurées au niveau de l’étendue globale, de l’étendue Site et de l’étendue Utilisateur. La cmdlet Get-CsClientPolicy vous permet de retourner des informations sur toutes les stratégies de clients qui ont été configurées pour être utilisé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-CsClientPolicy : 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-CsClientPolicy"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la stratégie de client à retourner. Pour faire référence à la stratégie globale, utilisez la syntaxe suivante : -Identity global. Pour faire référence à une stratégie du site, utilisez une syntaxe de type : -Identity site:Redmond. Pour spécifier une stratégie par utilisateur, utilisez une syntaxe de type : -Identity SalesDepartmentPolicy.

Si ce paramètre est omis, toutes les stratégies de client configurées pour être utilisées dans votre organisation seront retournées.

Filter

Facultatif

Chaîne

Permet d’utiliser des caractères génériques lors de la spécification des stratégies à retourner. Par exemple, pour retourner toutes les stratégies configurées dans l’étendue Site, utilisez cette syntaxe : -Filter "site:*". Pour retourner une collection de toutes les stratégies utilisateur, utilisez cette syntaxe : -Filter "tag:*".

LocalStore

Facultatif

Paramètre de commutateur

Récupère les données de stratégies de clients à partir du réplica local du magasin central de gestion, plutôt que du magasin central de gestion lui-même.

Types d’entrées

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

Types de retours

Get-CsClientPolicy retourne les instances de l'objet Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy.

Exemple

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

Get-CsClientPolicy

Dans l'exemple précédent, Get-CsClientPolicy est appelée sans paramètres supplémentaires ; le système retourne ainsi une collection de toutes les stratégies de client configurées pour être utilisées dans votre organisation.

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

Get-CsClientPolicy -Identity SalesPolicy

Dans l'exemple 2, Get-CsClientPolicy est utilisée pour retourner la stratégie de client utilisateur dont l'identité est SalesPolicy. Puisque les identités sont uniques, cette commande ne retournera jamais plus d'un élément.

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

Get-CsClientPolicy -Filter "tag:*"

L'exemple 3 utilise le paramètre Filter pour retourner toutes les stratégies de client qui ont été configurées au niveau de l'étendue utilisateur. La valeur de filtre "tag:*" indique à Get-CsClientPolicy de retourner uniquement les stratégies dont l'identité commence par la valeur de chaîne "tag:".

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

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True}

La commande précédente retourne une collection de toutes les stratégies de client pour lesquelles la propriété DisableSavingIM a la valeur True. Pour ce faire, Get-CsClientPolicy est d'abord appelée sans aucun paramètre, afin de retourner une collection de toutes les stratégies de client 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é DisableSavingIM est égale à True.

-------------------------- Exemple 5 --------------------------

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -and $_.EnableIMAutoArchiving -eq $False}

Dans l'exemple 5, les seules stratégies de clients retournées sont celles qui remplissent deux critères : la propriété DisableSavingIM doit avoir la valeur True et la propriété EnableIMAutoArchiving doit avoir la valeur False. Pour ce faire, la commande appelle d'abord Get-CsClientPolicy pour retourner une collection de toutes les stratégies de client configurées pour être utilisées dans l'organisation. Cette collection est ensuite redirigée vers Where-Object, qui sélectionne uniquement les stratégies répondant aux deux critères suivants : DisableSavingIM doit être égale à True et EnableIMAutoArchiving doit être égale à False. L'opérateur -and indique à Where-Object que seuls les objets répondant à l'ensemble des critères spécifiés doivent être sélectionnés.

-------------------------- Exemple 6 --------------------------

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -or $_.EnableIMAutoArchiving -eq $False}

L’exemple 6 est une variation de la commande présentée dans l’exemple 5. Les stratégies sont ici sélectionnées si elles répondent à au moins un des critères suivants : la propriété DisableSavingIM a la valeur True et/ou la propriété EnableIMAutoArchiving a la valeur False. Pour effectuer cette tâche, la commande appelle d'abord Get-CsClientPolicy pour retourner une collection de toutes les stratégies de client configurées pour être utilisées dans l'organisation. Cette collection est ensuite redirigée vers Where-Object, qui sélectionne uniquement les stratégies répondant à au moins un des critères suivants : DisableSavingIM est égal à True et/ou EnableIMAutoArchiving est égal à False. L'opérateur -or indique à Where-Object que tout objet répondant à au moins une des conditions spécifiées doit être sélectionné.