Set-CsClientVersionConfiguration
Dernière rubrique modifiée : 2012-03-27
Modifie le regroupement des paramètres de configuration définis de la version du client. Les paramètres de configuration de la version 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
Set-CsClientVersionConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsClientVersionConfiguration [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<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.
En revanche, il peut exister des contraintes non techniques qui peuvent inciter les utilisateurs à ne pas se connecter 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 des versions 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 la version cliente 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 Set-CsClientVersionConfiguration permet de modifier une collection existante de paramètres de configuration des versions des clients.
Notez que la configuration de version de client n’est pas une fonctionnalité 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 Set-CsClientVersionConfiguration : 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-CsClientVersionConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Correspond à l’identificateur unique des paramètres de configuration de la version de client à modifier. Pour modifier les paramètres globaux, utilisez la syntaxe suivante : -Identity global. Pour modifier les paramètres associés à l’étendue du site, utilisez la syntaxe suivante : "site:Redmond". Si vous ne définissez pas ce paramètre, Set-CsClientVersionConfiguration définit automatiquement les paramètres globaux. |
Instance |
Facultatif |
Objets ClientVersionPolicy |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. |
DefaultAction |
Facultatif |
Chaîne |
Indique l’action à exécuter si l’utilisateur tente de se connecter depuis une application cliente dont le numéro de version est introuvable dans la stratégie de version de client appropriée. DefaultAction doit avoir l’une des valeurs suivantes : Allow. L’application cliente est autorisée à se connecter. AllowWithUrl. L’application cliente est autorisée à se connecter. Par ailleurs, le message qui s’affiche à l’attention de l’utilisateur contient l’URL d’une page Web depuis laquelle il peut télécharger une application cliente approuvée. Vous devez définir l’URL de cette page Web comme valeur de la propriété DefaultUrl. Block. L’application cliente n’est pas autorisée à se connecter. BlockWithUrl. L’application cliente n’est pas autorisée à se connecter. Toutefois, le message de refus d’accès qui s’affiche à l’attention de l’utilisateur contient l’URL d’une page Web depuis laquelle il peut télécharger une application cliente approuvée. Vous devez définir l’URL de cette page Web comme valeur de la propriété DefaultUrl. Cette propriété est ignorée si la propriété Enabled est affectée de la valeur False. Lorsque cette propriété a la valeur False, aucun filtrage de la version des clients n’a lieu. |
DefaultUrl |
Facultatif |
Chaîne |
Définit l’URL de la page Web depuis laquelle l’utilisateur peut télécharger une application cliente approuvée. Si vous la définissez et que DefaultAction a la valeur BlockWithURL, l’URL apparaît dans le message de refus d’accès qui s’affiche chaque fois qu’un utilisateur tente de se connecter depuis une application cliente non prise en charge. |
Enabled |
Facultatif |
Booléen |
Indique si le filtrage des versions des clients est activé ou désactivé. Si la propriété Enabled est définie sur True, le serveur vérifie le numéro de version de chaque application cliente qui tente de se connecter. Le serveur autorise ou refuse l’accès en fonction de la stratégie de version de client appropriée. Si la propriété Enabled a la valeur False, toute application cliente en mesure de se connecter est autorisée à le faire. |
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 |
Booléen |
Vous demande confirmation avant d’exécuter la commande. |
Types d’entrées
Objet Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration. Set-CsClientVersionConfiguration accepte les instances transmises via le pipeline de l’objet de configuration de la version du client.
Types de retours
Set-CsClientVersionConfiguration ne renvoie aucune valeur ni aucun objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsClientVersionConfiguration -Identity site:Redmond -Enabled $False
Dans l’exemple 1, Set-CsClientVersionConfiguration permet de modifier la collection de paramètres avec l’identité « site:Redmond ». Dans ce cas, le paramètre Enabled est défini sur False afin de désactiver les paramètres de configuration des versions des clients.
-------------------------- Exemple 2 --------------------------
Get-CsClientVersionConfiguration | Set-CsClientVersionConfiguration -DefaultURL "https://litwareinc.com/csclients"
Dans l’exemple précédent, la propriété DefaultUrl est modifiée pour tous les paramètres de configuration des versions des clients utilisés dans l’organisation. Pour ce faire, la commande appelle d’abord Get-CsClientVersionConfiguration sans paramètres supplémentaires pour retourner tous les paramètres de configuration des versions des clients. Ces informations sont ensuite transmises à Set-CsClientVersionConfiguration qui affecte la valeur https://litwareinc.com/csclients à DefaultUrl pour chaque collection de configurations.
-------------------------- Exemple 3 --------------------------
Get-CsClientVersionConfiguration | Where-Object {$_.DefaultAction -eq "Block"} | Set-CsClientVersionConfiguration -DefaultAction "BlockWithUrl" -DefaultURL "https://litwareinc.com/csclients"
Dans l’exemple 3, tous les paramètres de configuration des versions des clients sont modifiés lorsque la valeur de DefaultAction est Block. Pour effectuer cette tâche, la commande utilise d’abord Get-CsClientVersionConfiguration pour retourner tous les paramètres de configuration des versions des clients actuellement utilisés. Ces informations sont ensuite redirigées vers la cmdlet Where-Object qui choisit uniquement les éléments pour lesquels la propriété DefaultAction est définie sur Block. La collection filtrée est ensuite envoyée à la cmdlet Set-CsClientVersionConfiguration qui exécute deux actions pour chacun des éléments de la collection : 1) elle affecte à DefaultAction la valeur BlockWithUrl et 2) elle affecte à DefaultUrl la valeur https://litwareinc.com/csclients.
Voir aussi
Autres ressources
Get-CsClientVersionConfiguration
New-CsClientVersionConfiguration
Remove-CsClientVersionConfiguration