Partager via

  • Article

New-CsClientVersionPolicy

 

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

Crée une nouvelle stratégie de version des clients. Les stratégies de version des clients permettent de spécifier quelles versions des clients (par exemple, Microsoft Office Communicator 2007 R2) pourront se connecter à votre système Microsoft Lync Server 2010.

Syntaxe

New-CsClientVersionPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Rules <PSListModifier>] [-WhatIf [<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 Microsoft 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 souhaitez empêcher les utilisateurs de se connecter à Lync Server 2010 à l’aide de Communicator 2007 R2 car l’ancienne application cliente ne prend pas en charge les mêmes fonctions et fonctionnalité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.

Toutefois, notez que les utilisateurs anonymes ne sont affectés que par les stratégies globales. En effet, les utilisateurs anonymes ne sont pas associés à un site ou un service ; il n’est pas possible de leur affecter une stratégie par utilisateur.

La création des nouvelles stratégies de version des clients s’effectue à l’aide de la cmdlet New-CsClientVersionPolicy. Ces nouvelles stratégies peuvent être créées au niveau de l’étendue Site, de l’étendue Service (service Serveur d’inscriptions uniquement) ou au niveau de l’étendue Utilisateur.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

Identificateur unique de la stratégie à créer. Pour créer une stratégie au niveau de l’étendue Site, utilisez une syntaxe semblable à celle-ci : -Identity "site:Redmond". Pour créer une stratégie au niveau de l’étendue Service, utilisez une syntaxe semblable à celle-ci : -Identity "Registrar:atl-cs-001.litwareinc.com". Le service Serveur d’inscriptions est le seul service qui peut héberger une stratégie de version des clients.

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

Description

Facultatif

Chaîne

Vous permet d’ajouter un texte décrivant la stratégie. Vous pouvez par exemple ajouter des informations sur les utilisateurs auxquels la stratégie doit être attribuée.

Rules

Facultatif

Modificateur de liste PS

Collection de règles de stratégie de version des clients. Les cmdlets New-CsClientVersionPolicyRule et Remove-CsClientVersionPolicyRule permettent d’ajouter des règles à une stratégie et d’en supprimer. Pour ajouter une règle lors de la création d’une stratégie, créez la règle et stockez la valeur dans une variable (par exemple, $x). Vous pouvez ensuite utiliser une syntaxe similaire à la syntaxe suivante pour créer une nouvelle stratégie :

New-CsClientVersionPolicy –Identity "RedmondClientVersionPolicy" –Rules @{Add=$x}

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. Get-CsClientVersionPolicy n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

New-CsClientVersionPolicy crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy.

Exemple

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

New-CsClientVersionPolicy -Identity site:Redmond

Dans l’exemple 1, une stratégie de version des clients est créée pour le site Redmond. Étant donné qu’aucun paramètre n’est spécifié (sauf le paramètre obligatoire Identity), la nouvelle stratégie contiendra toutes les valeurs par défaut d’une stratégie de version des clients.

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

Get-CsSite | Select-Object Identity | ForEach-Object {New-CsClientVersionPolicy -Identity ("site:" + $_.Identity)}

La commande illustrée dans l’exemple 2 crée une stratégie de version des clients pour chaque site de l’organisation. Pour réaliser cette tâche, la commande appelle d’abord Get-CsSite sans paramètres supplémentaires qui retourne une collection de tous les sites dans la topologie. Cette collection de sites est ensuite redirigée vers la cmdlet Select-Object qui extrait la propriété Identity pour chaque site. Ces identités sont ensuite redirigées vers la cmdlet ForEach-Object qui utilise chaque site de la collection pour créer une nouvelle stratégie de version des clients pour ce site.