Get-CsClientVersionConfiguration
Dernière rubrique modifiée : 2012-03-23
Récupère des informations sur la collection spécifiée de paramètres de configuration de version des clients utilisés dans votre organisation. Les paramètres de configuration de version des clients déterminent si Microsoft Lync Server 2010 vérifie le numéro de version de chaque application cliente qui se connecte au système. Si le filtrage de version de client est activé, la possibilité pour l’application cliente de se connecter au système dépend des paramètres définis dans la stratégie de version de client appropriée.
Syntaxe
Get-CsClientVersionConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsClientVersionConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Description détaillée
Lync Server 2010 offre une grande souplesse aux administrateurs pour définir le logiciel client (ainsi que le numéro de version du logiciel, qui est tout aussi important) que les utilisateurs peuvent utiliser pour se connecter au système. Par exemple, il n’existe aucune contrainte technique qui impose aux utilisateurs de se connecter à Lync Server 2010 en utilisant Microsoft Lync 2010. D’un point de vue technique, rien n’empêche les utilisateurs de se connecter en utilisant Microsoft Office Communicator 2007 R2.
Toutefois, il peut exister des contraintes non techniques qui font qu’il est préférable que les utilisateurs ne se connectent pas en utilisant Office Communicator 2007 R2. Par exemple, Office Communicator 2007 R2 ne prend pas en charge les fonctionnalités et les fonctions de Lync 2010. Par conséquent, les utilisateurs qui se connectent avec Office Communicator 2007 R2 auront une expérience différente de celle des utilisateurs qui se connectent via Lync 2010. Cette situation peut poser des problèmes aux utilisateurs, ainsi qu’au personnel de l’assistance qui doit fournir un support pour un certain nombre d’applications clientes différentes.
Si cela pose un problème dans votre organisation, vous pouvez utiliser la fonctionnalité de filtrage de version de client afin de définir les applications clientes qui peuvent être utilisées pour se connecter à Lync Server 2010. Lorsque vous installez Lync Server 2010, un groupe de paramètres globaux de configuration de version des clients est installé et activé. Ces paramètres déterminent si le filtrage des versions des clients est activé. Outre les paramètres globaux, des paramètres de configuration de version des clients peuvent être appliqués au niveau de l’étendue Site. Dans ce cas, les paramètres de site sont prioritaires sur les paramètres globaux.
La cmdlet Get-CsClientVersionConfiguration permet de récupérer des informations sur les paramètres de configuration de version des clients actuellement utilisés dans votre organisation. Notez que cette cmdlet ne désigne pas les applications clientes autorisées ou pas. Pour récupérer ces informations, utilisez la cmdlet Get-CsClientVersionPolicy.
Notez également que la configuration de la version des clients n’est pas une fonction de sécurité. La technologie s’appuie sur l’auto-création de rapports à partir des applications clientes et ne tente pas de vérifier si une application correspond réellement à l’application et au numéro de version qu’elle prétend être.
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-CsClientVersionConfiguration : 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-CsClientVersionConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Indique l’identificateur unique de la collection de paramètres de configuration de version des clients que vous souhaitez retourner. Pour vous référer aux paramètres globaux, utilisez cette syntaxe : -Identity global. Pour vous référer à une collection configurée au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Vous ne pouvez pas utiliser de caractères génériques avec une propriété Identity. Si vous souhaitez utiliser des caractères génériques, ajoutez plutôt le paramètre Filter. Si ce paramètre n’est pas spécifié, Get-CsClientVersionConfiguration retourne alors une collection de tous les paramètres de configuration de version des clients utilisés dans votre organisation. |
Filter |
Facultatif |
Chaîne |
Permet d’utiliser des caractères génériques afin de retourner une ou plusieurs collections de paramètres de configuration de version des clients. Pour retourner une collection de tous les paramètres configurés au niveau de l’étendue Site, utilisez cette syntaxe : -Filter site:*. Pour retourner une collection de tous les paramètres dont l’identité contient la valeur de chaîne « EMEA » (la seule propriété sur laquelle le filtrage peut être basé), utilisez la syntaxe suivante : -Filter *EMEA*. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait des données de configuration 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-CsClientVersionConfiguration n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsClientVersionConfiguration retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsClientVersionConfiguration
Dans le premier exemple, la cmdlet Get-CsClientVersionConfiguration est appelée sans préciser de paramètre supplémentaire. La cmdlet Get-CsClientVersionConfiguration retourne ainsi une collection de tous les paramètres de configuration de version des clients actuellement utilisés dans votre organisation.
-------------------------- Exemple 2 --------------------------
Get-CsClientVersionConfiguration -Identity site:Redmond
Dans l’exemple ci-dessus, Get-CsClientVersionConfiguration retourne tous les paramètres de configuration de version des clients ayant l’identité site:Redmond. Du fait du caractère unique impératif des identités, cette commande ne retourne jamais plus d’un élément.
-------------------------- Exemple 3 --------------------------
Get-CsClientVersionConfiguration -Filter "site:*"
L’exemple 3 retourne tous les paramètres de configuration de version des clients qui ont été appliqués au niveau de l’étendue Site. Pour ce faire, la commande utilise le paramètre Filter et la valeur de filtre « site:* ». Cette valeur de filtre indique à Get-CsClientVersionConfiguration de retourner uniquement les stratégies dont la valeur Identity commence par « site: ».
-------------------------- Exemple 4 --------------------------
Get-CsClientVersionConfiguration | Where-Object {$_.Enabled -eq $False}
L’exemple ci-dessus retourne tous les paramètres de configuration de version des clients actuellement désactivés. Pour exécuter cette tâche, la commande utilise d’abord Get-CsClientVersionConfiguration pour retourner une collection de tous les paramètres de version des clients configurés pour être utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui applique un filtre limitant la collection aux paramètres dont la propriété Enabled est égale à False.
Voir aussi
Autres ressources
New-CsClientVersionConfiguration
Remove-CsClientVersionConfiguration
Set-CsClientVersionConfiguration