Partager via

  • Article

Get-CsClientVersionPolicy

 

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

Retourne des informations indiquant quels clients (par exemple, Microsoft Office Communicator 2007 R2) sont pris en charge dans votre environnement Microsoft Lync Server 2010. Les stratégies de version des clients permettent de spécifier quels clients (par exemple, Office Communicator 2007 R2) pourront se connecter à votre système Lync Server 2010.

Syntaxe

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

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

Description détaillée

Les stratégies de version des clients représentent une collection de règles de version des clients ; les règles de version des clients sont quant à elles utilisées pour déterminer les applications clientes autorisées à se connecter à Lync Server 2010. Lorsqu’un utilisateur tente de se connecter à Lync Server 2010, son application cliente envoie un en-tête SIP au serveur ; cet en-tête comporte des informations détaillées sur l’application elle-même, y compris la version principale, la version secondaire et le numéro de version du logiciel. Les informations de version incluses dans l’en-tête SIP sont ensuite comparées à une collection de règles de version des clients pour déterminer si des règles s’appliquent à cette application particulière. Si une telle règle existe, Lync Server 2010 appliquera alors l’action spécifiée par la règle. Par exemple, cette règle pourra demander à Lync Server 2010 d’autoriser la connexion, de la bloquer, ou d’autoriser la connexion mais ensuite de mettre à niveau silencieusement l’application cliente avec la dernière version (par exemple, une mise à niveau de Communicator 2007 R2 vers Lync 2010).

Les stratégies de version des clients, qui peuvent être appliquées au niveau de l’étendue globale et des étendues Site et Service (service Serveur d’inscriptions uniquement), ou de l’étendue Utilisateur, vous apportent une flexibilité pour déterminer quelles applications clientes peuvent être utilisées pour accéder au système. Par exemple, vous pourriez empêcher les utilisateurs de se connecter à Lync Server 2010 à l’aide de Communicator 2007 R2 car ce dernier ne prend pas en charge les mêmes fonctionnalités et capacités que Lync 2010. Toutefois, en raison de conflits matériels ou logiciels, vous pouvez également avoir un groupe d’utilisateurs qui ne peut pas effectuer la mise à niveau vers Lync 2010. Dans ce cas, vous pouvez créer une règle distincte et une stratégie distincte de version des clients, permettant aux utilisateurs de se connecter à partir de Communicator 2007 R2.

La cmdlet Get-CsClientVersionPolicy offre un moyen de récupérer toutes les stratégies de version des clients actuellement utilisées dans votre organisation, ainsi que d’afficher les différentes règles qui composent chacune de ces stratégies.

Il est important de noter que les stratégies de version des clients ne s’appliquent pas aux utilisateurs fédérés ; ceux-ci sont liés par les stratégies de version des clients utilisées dans leur propre organisation. Par exemple, supposons qu’un utilisateur fédéré utilise le client A, c’est-à-dire un client autorisé par l’organisation fédérée. Tant que l’organisation fédérée autorise le recours au client A, cet utilisateur pourra communiquer avec votre organisation par l’entremise de ce client. Cette condition est vraie même si votre stratégie de version des clients bloque l’utilisation du client A. En effet, les stratégies de version de clients mises en place dans votre organisation ne remplacent pas les stratégies utilisées dans une organisation fédérée.

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-CsClientVersionPolicy : 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-CsClientVersionPolicy\b"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la stratégie à retourner. 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 de l’étendue Service, utilisez une syntaxe semblable à ceci : -Identity "Registrar:atl-cs-001.litwareinc.com". Le Serveur d’inscriptions est le seul service pouvant héberger une stratégie de version des clients.

Les stratégies peuvent également être configurées au niveau de l’étendue Utilisateur. Pour retourner l’une de ces stratégies, utilisez une syntaxe similaire à celle-ci : -Identity "SalesDepartmentPolicy".

Si ce paramètre n’est pas inclus, alors toutes les stratégies de version des clients 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 afin de spécifier la ou les stratégies à récupérer. Par exemple, cette syntaxe renvoie toutes les stratégies qui ont été configurées au niveau de l’étendue Site : -Filter "site:*". Cette syntaxe retourne toutes les stratégies qui ont été configurées au niveau de l’étendue Utilisateur : -Filter "tag:*".

Vous ne pouvez pas utiliser à la fois les paramètres Filter et Identity dans la même commande.

LocalStore

Facultatif

Paramètre de commutateur

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

Types d’entrées

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

Types de retours

Get-CsClientVersionPolicy retourne les instances de l’objet de stratégie Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersion.

Exemple

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

Get-CsClientVersionPolicy

Dans le premier exemple, Get-CsClientVersionPolicy est appelée sans paramètre supplémentaire. Ainsi, Get-CsClientVersionPolicy retourne une collection de toutes les stratégies de version des clients configurées pour être utilisées dans votre organisation.

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

Get-CsClientVersionPolicy -Identity site:Redmond

Dans l’exemple précédent, Get-CsClientVersionPolicy retourne toutes les stratégies de version des clients ayant l’identité site:Redmond. Tenant compte du caractère unique des identités, cette commande ne retourne jamais plus d’un élément.

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

Get-CsClientVersionPolicy -Filter site:*

L’exemple 3 retourne toutes les stratégies de version des clients qui ont été configurées au niveau de l’étendue Site. Pour ce faire, on inclut le paramètre Filter et la valeur de filtre site:* ; cette valeur indique à Get-CsClientVersionPolicy de ne retourner que les stratégies dont l’identité commence par la valeur de chaîne « site: ».

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

Get-CsClientVersionPolicy | Select-Object -ExpandProperty Rules

La commande utilisée dans l’exemple 4 affiche des informations détaillées sur chacune des règles configurées pour chaque stratégie de version des clients. Pour cela, Get-CsClientVersionPolicy est d’abord utilisée pour récupérer une collection de toutes les stratégies de version des clients configurées pour être utilisées dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Select-Object qui utilise le filtre ExpandProperty pour développer les valeurs de la propriété Rules. Lorsque cette propriété est développée, des informations détaillées sur chaque règle (comme le numéro de version du logiciel, la version principale et la version secondaire) s’affichent à l’écran.