Partager via

  • Article

Get-CsClientVersionPolicyRule

 

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

Retourne les règles de stratégie de version des clients configurées en vue de leur utilisation dans votre organisation.

Syntaxe

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

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

Description détaillée

Les règles de stratégie de version des clients permettent de déterminer quelles applications clientes sont autorisées à se connecter à Microsoft 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 sont ensuite contrôlées par rapport à une collection de règles de version des clients pour voir si les règles peuvent être appliquées à cette application spécifique. Par exemple, supposons qu’un utilisateur tente de se connecter à l’aide de Microsoft Office Communicator 2007 R2. Avant que l’utilisateur puisse se connecter à Lync Server 2010, le système vérifie si une règle de version des clients s’applique à Office Communicator 2007 R2. Si une telle règle existe, Lync Server 2010 appliquera alors l’action spécifiée par la règle. Cette action doit être l’une des suivantes :

Allow. L’utilisateur est autorisé à se connecter.

AllowAndUpgrade. L’utilisateur est autorisé à se connecter et sa copie Communicator 2007 R2 est automatiquement mise à niveau vers la dernière version de Lync. Les mises à niveau sont exécutées à l’aide de Microsoft Update ou de Windows Server Update Services (WSUS), selon la configuration de votre système.

AllowWithUrl. L’utilisateur est autorisé à se connecter et un message s’affiche lui indiquant l’URL d’un site à partir duquel il peut télécharger la dernière version de Lync pour l’installer. L’URL doit pointer vers un site Web que vous avez créé vous-même ; aucun site n’est créé pour vous lorsque vous installez Lync Server.

Block. L’utilisateur n’est pas autorisé à se connecter.

BlockAndUpgrade. L’utilisateur n’est pas autorisé à se connecter et sa copie Communicator 2007 R2 est automatiquement mise à niveau vers la dernière version de Lync. L’utilisateur peut alors tenter de se connecter à l’aide de la nouvelle application cliente. Les mises à niveau sont exécutées à l’aide de Microsoft Update ou de Windows Server Update Services (WSUS), selon la configuration de votre système.

BlockWithUrl. L’utilisateur n’est pas autorisé à se connecter mais un message s’affiche lui indiquant l’URL d’un site à partir duquel il peut télécharger la dernière version de Lync pour l’installer. L’URL doit pointer vers un site Web que vous avez créé vous-même ; aucun site n’est créé pour vous lorsque vous installez Lync Server.

Les règles de version des clients sont recueillies dans des stratégies de version des clients. Ces stratégies peuvent être configurées au niveau de l’étendue globale, de l’étendue Site, de l’étendue Service (service Serveur d’inscriptions) ou de l’étendue Utilisateur. La cmdlet Get-CsClientVersionPolicyRule permet aux administrateurs d’afficher des informations détaillées sur chacune des règles de stratégie configurées en vue de leur utilisation dans leur organisation.

Il est important de noter que les stratégies de version des clients ne s’appliquent pas aux utilisateurs fédérés ; à la place, ceux-ci sont liés par les stratégies de version des clients utilisées dans votre 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. Ce sera vrai même si votre stratégie de version des clients bloque l’utilisation du client A. Les stratégies de version des clients appliquées dans votre organisation ne remplacent pas les stratégies de version des clients 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-CsClientVersionPolicyRule : 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-CsClientVersionPolicyRule"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la règle de stratégie de version des clients à extraire. L’identité d’une règle de version des clients se compose de l’étendue dans laquelle la règle a été configurée et d’un identificateur global unique (GUID). Cela signifie qu’une règle aura une identité similaire à celle-ci : site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83. Étant donné que les GUID sont difficiles à mémoriser et à utiliser, la section Exemples de cette rubrique décrit d’autres manières d’identifier les règles à retourner.

Si ce paramètre n’est pas spécifié, toutes les règles de stratégie de version des clients configurées en vue de leur utilisation seront retournées.

Filter

Facultatif

Chaîne

Permet d’utiliser des caractères génériques lorsque vous spécifiez les règles de stratégie de version des clients à retourner. Par exemple, pour retourner toutes les règles configurées pour le site de Redmond, utilisez la syntaxe suivante : -Filter "site:Redmond/*".

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

LocalStore

Facultatif

Paramètre de commutateur

Récupère 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-CsClientVersionPolicyRule n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Get-CsClientVersionPolicyRule retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.

Exemple

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

Get-CsClientVersionPolicyRule

L’exemple 1 retourne des informations sur toutes les règles de stratégie de version des clients actuellement utilisées dans l’organisation.

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

Get-CsClientVersionPolicyRule -Identity "Global/2336c611-a243-4c5d-994b-eea8a524d0e4"

Dans l’exemple 2, des informations relatives à une seule règle de stratégie de version des clients sont retournées : il s’agit de la règle dont l’identité est Global/2336c611-a243-4c5d-994b-eea8a524d0e4.

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

Get-CsClientVersionPolicyRule -Filter "Global/*"

La commande ci-dessus retourne toutes les règles de stratégie de version des clients qui ont été configurées au niveau de l’étendue globale. Pour cela, la commande utilise le paramètre Filter avec la valeur de filtre « Global/* ». Cette valeur retourne uniquement les règles dont l’identité commence avec la valeur de chaîne « Global/ ».

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

Get-CsClientVersionPolicyRule | Where-Object {$_.Enabled -eq $False}

La commande présentée dans l’exemple 4 retourne toutes les règles de stratégie de version des clients actuellement désactivées. Pour exécuter cette tâche, la commande appelle d’abord la cmdlet Get-CsClientVersionPolicy pour retourner une collection de toutes les règles de stratégie de version des clients disponibles. La collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne toutes les règles dont la propriété Enabled est égale à False.

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

Get-CsClientVersionPolicyRule | Where-Object {$_.Action -eq "Block"}

La commande ci-dessus retourne toutes les règles de stratégie de version des clients qui empêchent une application cliente de se connecter. Pour ce faire, la commande appelle d’abord la cmdlet Get-CsClientVersionPolicy sans aucun paramètre. Cette cmdlet retourne une collection de toutes les règles actuellement utilisées. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les règles dont la propriété Action est égale à Block.