New-CsClientVersionPolicyRule
Dernière rubrique modifiée : 2012-03-23
Crée une nouvelle règle de stratégie de version des clients. Les règles de stratégie de version des clients vous aident à déterminer si les utilisateurs peuvent recourir à une application cliente spécifique pour se connecter à Microsoft Lync Server 2010.
Syntaxe
New-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>] [-InMemory <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]
New-CsClientVersionPolicyRule -Parent <String> -RuleId <String> [-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>] [-InMemory <SwitchParameter>] [-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 à 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 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 stratégies 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. Les nouvelles règles de version des clients sont créées via la cmdlet New-CsClientVersionPolicyRule. Lorsque vous créez une nouvelle règle, vous devez aussi spécifier l'identité de cette règle ; cette identité se compose d'une étendue (par exemple, site:Redmond) et d'un identificateur global unique (GUID). Vous pouvez soit fournir vous-même l'identité complète, soit fournir l'étendue (le paramètre Parent) et le GUID (le paramètre RuIeld) afin que la cmdlet New-CsClientVerisonPolicyRule crée l'identité à votre place.
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 New-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 "New-CsClientVersionPolicyRule"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique de la règle de stratégie de version des clients à créer. L'identité d'une règle de stratégie de version des clients comprend l'étendue pour laquelle la règle a été configurée et un identificateur global unique (GUID). Cela signifie qu’une règle aura une identité similaire à celle-ci : site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83. Au lieu d'utiliser le paramètre Identity, vous pouvez vous servir des paramètres Parent et RuleId pour que la cmdlet New-CsClientVerisonPolicyRule crée l'identité à votre place. |
MajorVersion |
Obligatoire |
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. Vous devez attribuer une valeur à la propriété MajorVersion à chaque fois que vous créez une nouvelle règle. |
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. |
UserAgent |
Obligatoire |
Chaîne |
Indicateur utilisé pour identifier le client logiciel. Par exemple, OC est la désignation d'agent utilisateur pour Communicator. |
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 ou 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 ($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. |
Parent |
Facultatif |
Chaîne |
Informations d’étendue de la nouvelle règle. Pour utiliser le paramètre Parent et créer une nouvelle règle pour la stratégie globale, utilisez cette syntaxe : -Parent global. Pour créer une nouvelle règle pour une stratégie de site, utilisez une syntaxe similaire à celle-ci : -Parent "site:Redmond". Pour créer une nouvelle règle pour une stratégie de service, utilisez une syntaxe similaire à celle-ci : -parent "Registrar:atl-cs-001.litwareinc.com". Pour créer une nouvelle règle pour une stratégie utilisateur, utilisez une syntaxe similaire à celle-ci : -Parent "RedmondClientVersionPolicy". Lorsque vous créez une nouvelle règle, vous devez utiliser soit le paramètre Identity, soit les paramètres Parent et RuleId. |
Priority |
Facultatif |
Entier |
Priorité relative de la règle. Les règles sont traitées selon un ordre de priorité ; la règle dotée de la priorité 0 est traitée en premier, la règle dotée de la 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. |
RuleId |
Facultatif |
Guid |
Identificateur global unique (GUID) de la règle. Dans Windows PowerShell, vous pouvez créer un GUID à l'aide de la commande suivante : $x = [guid]::NewGuid() |
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. |
InMemory |
Facultatif |
Paramètre de commutateur |
Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante. |
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
Aucun. New-CsClientVersionPolicyRule n'accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsClientVersionPolicyRule crée de nouvelles instances de l'objet Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.
Exemple
-------------------------- Exemple 1 ------------------------
$x = [guid]::NewGuid()
New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -MajorVersion 4 -UserAgent InHouse
L’exemple 1 vous indique comment créer une nouvelle règle de stratégie de version des clients. Les règles de stratégie ont des identités constituées de deux éléments : l'étendue où l'annonce doit être affectée et un GUID composé de 36 caractères. La création d’une identité pour une nouvelle règle de stratégie de version des clients nécessite d’abord que vous utilisiez la méthode .NET Framework NewGuid pour créer un nouveau GUID. Cette étape s'effectue dans la première commande de l'exemple ; le GUID qui en résulte étant stocké dans la variable $x.
Une fois le GUID créé, vous pouvez utiliser New-CsClientVersionPolicyRule pour créer la nouvelle règle. Cette commande utilise quatre paramètres : Parent avec la valeur de paramètre site:Redmond représentant l'étendue de la nouvelle règle ; RuleId avec la valeur de paramètre $x représentant le GUID nouvellement créé ; MajorVersion (4) ; et UserAgent (InHouse). Dans ce cas, le paramètre UserAgent représente une application cliente interne.
-------------------------- Exemple 2 ------------------------
$x = [guid]::NewGuid()
$z = New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -InMemory
$z.MajorVersion = 4
$z.UserAgent = "Inhouse"
Set-CsClientVersionPolicyRule -Instance $z
Les commandes présentées dans l’exemple 2 constituent une variation de la commande présentée dans l’exemple 1. Dans ce cas néanmoins, la nouvelle règle est d'abord créée en mémoire uniquement et est ajoutée ensuite à Lync Server 2010. Pour effectuer cette tâche, la première commande de l’exemple crée la partie GUID de l’identité. Dans la commande 2, une nouvelle règle de stratégie de version des clients est créée en mémoire uniquement ; le paramètre InMemory s'assure que la règle existe seulement en mémoire et qu'elle n'est pas immédiatement ajoutée à l'infrastructure Lync Server 2010. Comme dans l'exemple 1, les paramètres Parent et RuleId permettent de spécifier l'étendue et le GUID de la nouvelle règle, les deux éléments qui constituent l'identité de la règle.
Une fois que la règle virtuelle a été créée, les deux commandes suivantes sont utilisées pour attribuer des valeurs aux propriétés respectives MajorVersion et UserAgent. Une fois ces tâches terminées, la dernière commande de l'exemple et la cmdlet Set-CsClientVersionPolicyRule permettent de créer la règle de stratégie de version des clients et d'affecter la règle au site de Redmond.
Voir aussi
Autres ressources
Get-CsClientVersionPolicyRule
Remove-CsClientVersionPolicyRule
Set-CsClientVersionPolicyRule