Partager via

  • Article

Set-CsClientVersionPolicy

 

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

Modifie une stratégie de version des clients existante. Les stratégies de version des clients permettent de spécifier quels clients (par exemple, Microsoft Office Communicator 2007 R2) seront autorisés à se connecter à votre système Microsoft Lync Server 2010.

Syntaxe

Set-CsClientVersionPolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Rules <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsClientVersionPolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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. Il se peut que vous souhaitiez par exempleempêcher les utilisateur de se connecter à Lync Server 2010 avec Communicator 2007 R2 ; c'est parce qu'il ne dispose pas des mêmes fonctionnalités et capacités que Lync 2010. Toutefois, en raison de conflits matériels ou logiciels, vous pourriez également avoir un groupe d'utilisateurs qui ne pourra pas se mettre à niveau avec 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 d'Communicator 2007 R2.

Les stratégies de version des clients peuvent être modifiées à tout moment ; modifier une stratégie de version des clients correspond généralement à ajouter de nouvelles règles, supprimer des règles existantes ou modifier les propriétés d'une règle existante (par exemple, changer une action de règle de Autoriser à Bloquer). Ces modifications peuvent être effectuées à l'aide de la cmdlet Set-CsClientVersionPolicy. Toutefois, il vous semblera probablement plus aisé de procéder à ces modifications par l'intermédiaire de la cmdlet CsClientVersionPolicyRule.

D'un autre côté, Set-CsClientVersionPolicy ne vous permet pas de copier facilement tout un ensemble de règles d'une stratégie de version des clients vers une autre. Pour plus d'informations, consultez la section Exemples de cette rubrique d'aide.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la stratégie à modifier. Pour modifier la stratégie globale, utilisez la syntaxe suivante : -Identity global. Pour modifier une stratégie configurée au niveau de l'étendue Site, utilisez une syntaxe semblable à ceci : -Identity "site:Redmond". Pour modifier une stratégie configurée au niveau de l'étendue Service, utilisez une syntaxe semblable à ceci : -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 utilisateur peuvent aussi être modifiées à l'aide de cette cmdlet. Pour modifier une stratégie utilisateur, utilisez une syntaxe similaire à celle-ci : -Identity "SalesDepartmentPolicy".

Si ce paramètre n'est pas inclus, Set-CsClientVersionPolicy modifiera la stratégie globale.

Instance

Facultatif

Objet ClientVersionPolicy

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

Description

Facultatif

Chaîne

Permet de fournir des informations explicatives sur une stratégie. Par exemple, vous pouvez fournir des informations décrivant les utilisateurs auxquels la stratégie doit être affectée.

Rules

Facultatif

Modificateur de liste PS

Collection de règles de stratégies des clients individuelles qui ont été affectées à la stratégie.

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.

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

Objet Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy. Remove-CsClientVersionPolicy accepte les instances transmises via le pipeline de l'objet de stratégie de version client.

Types de retours

Set-CsClientVersionPolicy ne retourne ni valeur ni objet. En fait, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy.

Exemple

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

Set-CsClientVersionPolicy -Identity site:Redmond -Rules $Null

$x = Get-CsClientVersionPolicy -Identity site:Dublin | Select-Object -ExpandProperty Rules

Set-CsClientVersionPolicy -Identity site:Redmond -Rules $x

Les commandes présentées dans l’exemple 1 copient toutes les règles de version des clients, d’une stratégie de version des clients vers une autre. Pour effectuer cette opération, la première commande de cet exemple utilise Set-CsClientVersionPolicy pour supprimer toutes les règles de la stratégie site:Redmond ; pour ce faire, la propriété Rules doit avoir la valeur Null. Une fois les règles supprimées, la deuxième commande de cet exemple utilise Get-CsClientVersionPolicy pour récupérer toutes les règles de stratégie de version des clients configurées pour la stratégie site:Dublin. Ces règles sont stockées dans la variable $x.

Dans la dernière commande, Set-CsClientVersionPolicy est de nouveau appelée, mais la propriété Rules de la stratégie de Redmond est cette fois définie sur $x. Cette opération permet effectivement de copier toutes les règles de la stratégie site:Dublin, puis de les ajouter à la stratégie site:Redmond.