Partager via

  • Article

Grant-CsClientVersionPolicy

 

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

Attribue une stratégie de version des clients au niveau de l’étendue globale, des étendues Site et Service ou de l’étendue Utilisateur. Les stratégies de version des clients permettent de spécifier quels clients (par exemple, Microsoft Office Communicator 2007 R2) pourront se connecter à votre système Microsoft Lync Server 2010.

Syntaxe

Grant-CsClientVersionPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-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 de l’autoriser, mais ensuite de mettre à jour silencieusement l’application cliente avec la dernière version (par exemple, une mise à jour de Office 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. Vous souhaiterez peut-être, par exemple, empêcher les utilisateurs de se connecter à Lync Server 2010 en utilisant Communicator 2007 R2, car cette ancienne application cliente ne prend pas en charge les mêmes fonctionnalités que Lync 2010. Toutefois, en raison de conflits matériels ou logiciels, vous pourriez également avoir un groupe particulier d’utilisateurs qui ne peut pas effectuer de 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 d’Communicator 2007 R2.

La cmdlet Grant-CsClientVersionPolicy vous permet d’affecter des stratégies de version des clients à des utilisateurs individuels. Lorsque vous créez une stratégie utilisateur, celle-ci n’est pas automatiquement attribuée à un personne. L’attribution n’a lieu que lorsque vous appelez la cmdlet Grant-CsClientVersionPolicy pour attribuer explicitement la stratégie à un utilisateur ou un groupe d’utilisateurs.

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 Grant-CsClientVersionPolicy : RTCUniversalUserAdmins. 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 "Grant-CsClientVersionPolicy"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Paramètre ID utilisateur

Indique l’identité du compte d’utilisateur auquel la stratégie doit être attribuée. Les identités utilisateur peuvent être spécifiées dans l’un des quatre formats suivants : 1) L’adresse SIP de l’utilisateur ; 2) Le nom d’utilisateur principal de l’utilisateur ; 3) Le nom de domaine et le nom d’ouverture de session de l’utilisateur, sous la forme domaine\ouverture de session (par exemple, litwareinc\kenmyer) ; et 4) Le nom complet Active Directory de l’utilisateur (par exemple, Ken Myer). Les identités utilisateur peuvent être référencées à l’aide d’un nom unique Active Directory.

En outre, vous pouvez recourir à l’astérisque (caractère générique *) si vous utilisez le nom complet comme identité utilisateur. Par exemple, l’identité « * Smith » renvoie tous les utilisateurs dont le nom complet se termine par la valeur de chaîne « Smith ».

PolicyName

Obligatoire

Chaîne

« Nom » de la stratégie à attribuer. PolicyName est simplement l’identité de stratégie moins l’étendue de stratégie (« tag: »). Par exemple, pour une stratégie dont l’identité est tag:Redmond, PolicyName est égal à Redmond ; pour une stratégie dont l’identité est tag:RedmondClientVersionPolicy, PolicyName est égal à RedmondClientVersionPolicy. Pour désattribuer une stratégie attribuée à un utilisateur, définissez le paramètre PolicyName sur une valeur null ($Null).

DomainController

Facultatif

Chaîne

Permet de spécifier le contrôleur de domaine avec lequel vous souhaitez établir une connexion au moment d’attribuer la stratégie. Si ce paramètre n’est pas inclus, la cmdlet utilisera le premier contrôleur de domaine disponible.

PassThru

Facultatif

Paramètre de commutateur

S’il est présent, la cmdlet transmet le ou les objets utilisateur via le pipeline Windows PowerShell. Par défaut, Grant-CsClientVersionPolicy ne transmet aucun objet via le pipeline.

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

Valeur de chaîne ou objet Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Grant-CsClientVersionPolicy accepte la saisie de données transmises via le pipeline pour les valeurs de chaîne représentant l’identité d’un compte d’utilisateur. La cmdlet accepte également la saisie de données transmises via le pipeline pour les objets utilisateur.

Types de retours

Par défaut, Grant-CsClientVersionPolicy ne retourne ni objet, ni valeur. Toutefois, si vous incluez le paramètre PassThru, la cmdlet retourne des instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

Exemple

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

Grant-CsClientVersionPolicy -Identity "Ken Myer" -PolicyName "RedmondClientVersionPolicy"

Dans l’example 1, la stratégie de version de client RedmondClientVersionPolicy est attribuée à l’utilisateur Ken Myer.

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

Get-CsUser -LdapFilter "l=Redmond" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

La commande illustrée dans l’exemple 2 attribue la stratégie de version de client RedmondClientVersionPolicy à tous les utilisateurs travaillant dans la ville de Redmond. Pour ce faire, la commande utilise d’abord la cmdlet Get-CsUser et le paramètre LdapFilter pour extraire la collection appropriée de comptes d’utilisateurs ; la valeur de filtre « l=Redmond » (où« l » est un L minuscule, le nom d’attribut LDAP de « locality », ou ville) limite les données récupérées aux utilisateurs qui travaillent dans la ville de Redmond. Cette collection est ensuite redirigée vers la cmdlet Grant-CsClientVersionPolicy, qui attribue la stratégie spécifiée à chaque utilisateur de la collection.

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

Get-CsUser -OU "ou=Redmond,ou=North America,dc=litwareinc,dc=com" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

Dans l’exemple 3, la stratégie de version de client RedmondClientVersionPolicy est attribuée à tous les utilisateurs d’une unité d’organisation spécifique (OU). Pour réaliser cette tâche, la commande appelle d’abord Get-CsUser et le paramètre OU ; la valeur du paramètre correspond au nom unique de l’unité d’organisation (ou=Redmond,ou=North America,dc=litwareinc,dc=com) aux utilisateurs de laquelle la stratégie de version de client sera attribuée. Une fois les comptes d’utilisateurs récupérés, la collection est redirigée vers la cmdlet Grant-CsClientVersionPolicy qui attribue la stratégie RedmondClientVersionPolicy à chacun des utilisateurs.

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

Get-CsUser -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

La commande ci-dessus attribue la stratégie de version de client RedmondClientVersionPolicy à tous les utilisateurs auxquels la stratégie de voix RedmondVoicePolicy a déjà été attribuée. Pour ce faire, la commande appelle d’abord Get-CsUser avec le paramètre Filter ; la valeur de filtre {VoicePolicy -eq "RedmondVoicePolicy"} garantit que les seuls comptes d’utilisateurs retournés sont ceux dont la propriété VoicePolicy est égale à « RedmondVoicePolicy ». Les comptes d’utilisateurs obtenus sont ensuite redirigés vers la cmdlet Grant-CsClientVersionPolicy, et la stratégie de version de client RedmondClientVersionPolicy leur est attribuée.

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

Get-CsUser | Grant-CsClientVersionPolicy -PolicyName $Null

Dans l’exemple 5, tous les utilisateurs de l’organisation se voient retirer leur stratégie de version de client utilisateur qui leur avait été attribuée. Pour ce faire, la commande utilise d’abord Get-CsUser pour retourner une collection de tous les utilisateurs de l’organisation activés pour Lync Server. Cette collection est ensuite redirigée vers la cmdlet Remove-CsClientVersionPolicy, qui supprime les stratégies de version des clients utilisateur attribuées à ces utilisateurs. On effectue cette opération en définissant la valeur de paramètre PolicyName sur $Null.