Partager via

  • Article

Set-CsClientVersionPolicyRule

 

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

Modifie une ou plusieurs règles de stratégies de versions des clients actuellement configurées pour être utilisées dans votre organisation.

Syntaxe

Set-CsClientVersionPolicyRule [-Identity <XdsIdentity>] [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <Nullable>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

Set-CsClientVersionPolicyRule [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <Nullable>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Les règles de version des clients permettent de déterminer quelles applications clientes sont autorisées à se connecter à Microsoft 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 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. Par exemple, supposons qu’un utilisateur tente de se connecter à l’aide de Microsoft Office Communicator 2007 R2. Avant que l’utilisateur puisse se connecter à Lync Server 2010, le système vérifie si une règle de version des clients s’applique à Office Communicator 2007 R2. Si une telle règle existe, Lync Server 2010 appliquera alors l’action spécifiée par la règle. Cette action doit être l’une des suivantes :

Allow. L’utilisateur est autorisé à se connecter.

AllowAndUpgrade. L’utilisateur est autorisé à se connecter et sa copie Communicator 2007 R2 est automatiquement mise à niveau vers la dernière version de Lync. Les mises à niveau sont exécutées à l’aide de Microsoft Update ou de Windows Server Update Services (WSUS), selon la configuration de votre système.

AllowWithUrl. L’utilisateur est autorisé à se connecter et un message s’affiche lui indiquant l’URL d’un site à partir duquel il peut télécharger la dernière version de Lync pour l’installer. L’URL doit pointer vers un site Web que vous avez créé vous-même ; aucun site n’est créé pour vous lorsque vous installez Lync Server.

Block. L’utilisateur n’est pas autorisé à se connecter.

BlockAndUpgrade. L’utilisateur n’est pas autorisé à se connecter et sa copie Communicator 2007 R2 est automatiquement mise à niveau vers la dernière version de Lync. L’utilisateur peut alors tenter de se connecter à l’aide de la nouvelle application cliente. Les mises à niveau sont exécutées à l’aide de Microsoft Update ou de Windows Server Update Services (WSUS), selon la configuration de votre système.

BlockWithUrl. L’utilisateur n’est pas autorisé à se connecter mais un message s’affiche lui indiquant l’URL d’un site à partir duquel il peut télécharger la dernière version de Lync pour l’installer. L’URL doit pointer vers un site Web que vous avez créé vous-même ; aucun site n’est créé pour vous lorsque vous installez Lync Server.

Les règles de version des clients sont recueillies dans des stratégies de version des clients. Ces stratégies peuvent être configurées au niveau de l’étendue globale, de l’étendue Site, de l’étendue Service (service Serveur d’inscriptions) ou de l’étendue Utilisateur. La cmdlet Set-CsClientVersionPolicyRule vous permet de modifier les propriétés d’une règle de version des clients existante.

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-CsClientVersionPolicyRule : 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-CsClientVersionPolicyRule"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique de la règle de stratégie de version de client à modifier. L’identité d’une règle de version des clients se compose de l’étendue dans laquelle la règle a été configurée et d’un identificateur global unique (GUID). Cela signifie qu’une règle aura une identité similaire à celle-ci : site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83.

Instance

Facultatif

Objet Règle

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

Action

Facultatif

Modificateur de liste PS

Action à effectuer à chaque fois que la règle est déclenchée (c’est-à-dire à chaque fois que quelqu’un tente de se connecter par l’intermédiaire du logiciel spécifié). Les valeurs valides sont les suivantes :

Allow. L’utilisateur est autorisé à se connecter.

AllowWithUrl. L’utilisateur est autorisé à se connecter et un message s’affiche lui indiquant l’URL d’un site à partir duquel il peut télécharger la dernière version de Lync pour l’installer.

AllowAndUpgrade. L’utilisateur est autorisé à se connecter et sa copie Communicator est automatiquement mise à niveau vers la dernière version de Lync.

Block. L’utilisateur n’est pas autorisé à se connecter.

BlockWithUrl. L’utilisateur n’est pas autorisé à se connecter mais un message s’affiche lui indiquant l’URL d’un site à partir duquel il peut télécharger la dernière version de Lync pour l’installer.

BlockAndUpgrade. L’utilisateur n’est pas autorisé à se connecter et sa copie Communicator est automatiquement mise à niveau vers la dernière version de Lync. L’utilisateur peut alors tenter de se connecter à l’aide de la nouvelle application cliente.

ActionUrl

Facultatif

Chaîne

URL à partir de laquelle les utilisateurs peuvent télécharger la dernière version de Lync Cette propriété est requise si l’action est définie sur BlockWithUrl or AllowWithUrl.

BuildNumber

Facultatif

Entier

Numéro de build du logiciel. Par exemple, si vous disposez de la version 2.0.6362.111 de Communicator, alors le numéro de build est 6362. Les numéros de build représentent les versions internes du logiciel pendant le processus de développement et vous permettent de vous assurer que vous utilisez la version finale et non une version préliminaire.

CompareOp

Facultatif

Modificateur de liste PS

Opérateur de comparaison permettant de déterminer si le logiciel client qui tente de se connecter a été mis à disposition avant, après ou en même temps que la version spécifiée dans la règle. Les valeurs valides sont les suivantes :

EQL (égal à)

NEQ (différent de)

GTR (supérieur à)

GEQ (supérieur ou égal à)

LSS (inférieur à)

LEQ (inférieur ou égal à)

Description

Facultatif

Chaîne

Permet aux administrateurs de fournir des informations supplémentaires sur la règle de version des clients. Par exemple, le champ Description peut contenir des données sur la personne à contacter si vous pensez que la règle doit être modifiée.

Enabled

Facultatif

Booléen

Indique si la règle de version des clients doit être utilisée. Si la propriété Enabled est définie sur False, la règle sera ignorée à chaque fois qu’un utilisateur tentera de se connecter avec le logiciel spécifié. La valeur par défaut est True.

MajorVersion

Facultatif

Entier

Version principale du logiciel. Par exemple, si vous disposez de la version 2.0.6362.111 de Communicator, alors la version principale est 2. Les versions principales sont les versions de base du logiciel.

MinorVersion

Facultatif

Entier

Version secondaire du logiciel. Par exemple, si vous disposez de la version 2.0.6362.111 de Communicator, alors la version secondaire est 0. Les versions secondaires sont les versions temporaires du logiciel.

Priority

Facultatif

Entier

Priorité relative de la règle. Les règles sont traitées selon un ordre de priorité ; la règle de priorité 0 est traitée en premier, la règle de priorité 1 est traitée en second, etc. Si vous attribuez une priorité déjà utilisée, la nouvelle règle appliquera cette priorité et les autres règles seront renumérotées en conséquence.

QfeNumber

Facultatif

Entier

Numéro de mise à jour de correctif (QFE) du logiciel. Par exemple, si vous disposez de la version 2.0.6362.111 de Communicator, alors le numéro de mise à jour de correctif (QFE) est 111. Les numéros QFE correspondent aux mises à jour planifiées d’une application qui sont accessibles dès que la version officielle du logiciel est disponible.

UserAgent

Facultatif

Chaîne

Indicateur utilisé pour identifier le client logiciel. Par exemple, OC est la désignation d’agent utilisateur pour Communicator. La cmdlet Get-CsClientVersionConfiguration fournit les noms conviviaux correspondants de chaque désignation d’agent utilisateur.

UserAgentFullName

Facultatif

Chaîne

Permet aux administrateurs de fournir un nom convivial pour l’agent utilisateur. Par exemple, au lieu de compter sur l’UCCP de l’agent utilisateur pour identifier l’agent, ils peuvent utiliser la forme complète : Microsoft Unified Communications Client.

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.Rule. Set-CsClientVersionPolicyRule accepte les instances transmises via le pipeline de l’objet de la règle de version des clients.

Types de retours

Aucun. En fait, Set-CsClientVersionPolicyRule modifie les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.

Exemple

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

Set-CsClientVersionPolicyRule -Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820 -Enabled $False

La commande illustrée dans l’exemple 1 désactive la règle de stratégie de version de client dont la propriété Identity est site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820. Pour désactiver la règle, la commande inclut le paramètre Enabled et la valeur de paramètre $False.

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

Get-CsClientVersionPolicyRule -Filter "site:Redmond*" | Set-CsClientVersionPolicyRule -Description "Client policy rules for Redmond"

L’exemple 2 ajoute une description générique à toutes les règles de stratégies de versions des clients attribuées au site Redmond. Pour cela, la commande appelle d’abord Get-CsClientVersionPolicyRule avec le paramètre Filter ; la valeur de filtre « site:Redmond* » limite les données retournées aux règles de stratégies attribuées au site Redmond. Cette collection est ensuite redirigée vers la cmdlet Set-CsClientVersionPolicyRule, qui attribue la Description « Client policy rules for Redmond » (Règles de stratégies de clients pour Redmond) à chaque élément de cette collection.

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

Get-CsClientVersionPolicyRule | Where-Object {$_.UserAgent -eq "UCCP"} | Set-CsClientVersionPolicyRule -Action "Block"

La commande ci-dessus bloque l’utilisation de clients UCCP (Unified Communications Client Platform) pour toute règle de stratégie de version de client faisant référence à UCCP en tant qu’agent utilisateur. Pour cela, la commande appelle d’abord Get-CsClientVersionPolicyRule pour récupérer une collection de toutes les règles de stratégies de clients actuellement utilisées. Cette collection est ensuite redirigée vers la cmdlet Where-Object, qui sélectionne uniquement les règles dans lesquelles la propriété UserAgent est égale à (-eq) UCCP. Cette collection filtrée est ensuite redirigée vers la cmdlet Set-CsClientVersionPolicyRule, qui prend chaque élément de la collection et définit la propriété Action sur Block.