Partager via

  • Article

Remove-CsClientVersionPolicyRule

 

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

Supprime une ou plusieurs des règles de stratégie applicables à votre version client qui sont configurées et utilisées dans votre organisation.

Syntaxe

Remove-CsClientVersionPolicyRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 contrôlées par rapport à une collection de règles de version client pour voir si les règles peuvent être appliquées à cette application spécifique. 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, le système vérifie si une règle de version de client 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, au niveau des étendues Site et Service (service Serveur d’inscriptions) ou au niveau de l’étendue Utilisateur. La cmdlet Remove-CsClientVersionPolicyRule vous permet de supprimer une ou plusieurs règles de stratégie de client configurées pour être utilisées dans votre organisation. Ces règles peuvent être supprimées à partir de n’importe quelle stratégie de version des clients, y compris la stratégie globale.

Il est important de noter que les stratégies de version des clients ne s’appliquent pas aux utilisateurs fédérés ; au lieu de cela, ces derniers sont liés par des stratégies de version des clients utilisées dans leur propre 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 Remove-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 "Remove-CsClientVersionPolicyRule"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique de la règle de stratégie de version de client à supprimer. 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.

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. Remove-CsClientVersionPolicyRule accepte les instances transmises via le pipeline de l’objet de règle de version de client.

Types de retours

Aucun. Au lieu de cela, Remove-CsClientVersionPolicyRule supprime les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.

Exemple

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

Remove-CsClientVersionPolicyRule -Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820

La commande illustrée à l’exemple 1 supprime la règle de stratégie de version client dont l’identité est site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820. Parce que ces identités doivent être uniques, cette commande renverra au plus une règle unique.

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

Get-CsClientVersionPolicyRule -Filter "site:Redmond/*" | Remove-CsClientVersionPolicyRule

La commande précédente supprime toutes les règles de stratégie de version client configurées pour le site Redmond. Pour ce faire, la commande appelle d’abord Get-CsClientVersionPolicyRule avec le paramètre Filter. La valeur de filtre « site:Redmond/* » restreint le retour des données aux règles de stratégie dont l’identité commence par la valeur de chaîne « site:Redmond/ ». La collection filtrée est ensuite redirigée vers Remove-CsClientVersionPolicyRule qui supprime chaque élément dans la collection.

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

Get-CsClientVersionPolicyRule | Where-Object {$_.Enabled -eq $False} | Remove-CsClientVersionPolicyRule

L’exemple 3 supprime toutes les règles de stratégie de version de client actuellement désactivées. Pour ce faire, la commande appelle d’abord Get-CsClientVersionPolicyRule sans paramètre afin de retourner une collection de toutes les règles de stratégie utilisées actuellement dans l’organisation. La collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne toutes les règles pour lesquelles la propriété Enabled est égale à False. La collection filtrée est ensuite redirigée vers Remove-CsClientVersionPolicyRule qui supprime chaque élément dans la collection.