Partager via

  • Article

New-CsUserServicesConfiguration

 

Dernière rubrique modifiée : 2012-04-23

Crée une nouvelle collection de paramètres de configuration pour les services d’utilisateurs. Le service Services d’utilisateurs permet de gérer les informations de présence et les conférences.

Syntaxe

New-CsUserServicesConfiguration -Identity <XdsIdentity> [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Microsoft Lync Server 2010 s’appuie sur le service Services d’utilisateurs pour mettre à jour les informations de présence des utilisateurs et pour gérer les réunions et les conférences. Les cmdlets CsUserServicesConfiguration sont à leur tour utilisées afin d’administrer les paramètres de configuration pour les services d’utilisateurs au niveau des étendues Site et Service, ainsi qu’au niveau de l’étendue globale. (notez que le seul service pouvant héberger les paramètres de configuration pour les services d’utilisateurs est le service Services d’utilisateurs proprement dit). Ces paramètres permettent de déterminer certains aspects, tels que le nombre de contacts qu’un utilisateur est autorisé à avoir, le nombre de réunions qu’un utilisateur peut planifier à une heure donnée, ainsi que la durée pendant laquelle une réunion donnée peut rester active.

La cmdlet New-CsUserServicesConfiguration offre la possibilité aux administrateurs de créer une nouvelle collection de paramètres de configuration pour les Services d’utilisateurs au niveau de l’étendue Site ou Service. (Les nouvelles collections ne peuvent pas être créées dans l’étendue globale.) Notez qu’un site ou un service donné peut héberger, au maximum, une seule collection de paramètres de configuration pour les Services d’utilisateurs. Votre commande échouera si vous essayez de créer des paramètres pour, par exemple, le site Redmond et si le site héberge déjà une collection de paramètres de configuration pour les Services d’utilisateurs.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique des paramètres de configuration pour les Services d’utilisateurs à créer. Pour créer des paramètres dans l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Pour créer des paramètres au niveau du service, utilisez une syntaxe comparable à celle-ci : -Identity service:UserServer:atl-cs-001.litwareinc.com.

AnonymousUserGracePeriod

Facultatif

TimeSpan

Représente la durée pendant laquelle un utilisateur anonyme (non authentifié) peut rester dans une réunion sans qu’un utilisateur authentifié ne soit présent dans cette réunion. Par exemple, si cette valeur est définie à 15 minutes, un utilisateur anonyme ne peut pas participer à la réunion pendant plus de 15 minutes si aucun utilisateur authentifié n’est présent. Si aucun utilisateur authentifié n’intègre la réunion avant l’expiration de la période de grâce, l’utilisateur anonyme sera retiré de la réunion. Ce paramètre s’applique aux réunions planifiées et aux réunions ad hoc créées en cliquant sur l’option Conférence maintenant dans Microsoft Lync.

AnonymousUserGracePeriod doit être spécifié au format suivant : jours.minutes:minutes:secondes (par exemple, 0.00:30:00 pour 30 minutes). La période de grâce peut être définie sur toute valeur comprise entre 0 seconde et 1 jour ; la valeur par défaut est 90 minutes (01:30:00).

DeactivationGracePeriod

Facultatif

TimeSpan

Durée maximale pendant laquelle une réunion peut rester active. Cette valeur doit être spécifiée au format suivant : jours.heures:minutes:secondes. Par exemple, pour autoriser une réunion à durer 60 heures, utilisez ce format : 2.12:00:00 (2 jours. 12 heures : 00 minute: 00 seconde.)

DeactivationGracePeriod doit être compris entre 8 heures et 365 jours inclus. La valeur par défaut est 1 jour (1.00:00:00).

DefaultSubscriptionExpiration

Facultatif

Entier

Les abonnements sont créés à chaque fois qu’un utilisateur effectue une demande de données, telles que des informations de présence. Une fois la demande effectuée, l’utilisateur (ou plus précisément l’application cliente de l’utilisateur) peut demander la durée pendant laquelle l’abonnement restera valide avant qu’il soit nécessaire de le renouveler. Si aucune demande n’est envoyée, l’abonnement est défini sur la valeur spécifiée par la propriété DefaultSubscriptionExpiration.

La durée d’abonnement par défaut doit être exprimée sous la forme d’un entier compris entre 300 secondes (5 minutes) et 86 400 secondes (24 heures) incluses. La valeur par défaut est 28 800 secondes (8 heures).

MaintenanceTimeOfDay

Facultatif

DateTime

Indique l’heure du jour à laquelle des opérations de maintenance de base de données planifiées à intervalles réguliers (par exemple, la suppression des enregistrements obsolètes) sont effectuées. Vous devez entrer cette valeur en précisant la date et l’heure. Vous pouvez choisir le format 24 heures (par exemple, « 14:00 ») ou le format 12 heures (par exemple, « 2:00 PM »).

La valeur par défaut de MaintenanceTimeOfDay est 1:00 AM (01:00:00).

MaxContacts

Facultatif

Entier

Nombre maximal de contacts que peut avoir un utilisateur. La valeur par défaut est 250. La propriété MaxContacts représente le nombre maximal absolu de contacts que peut avoir un utilisateur. Toutefois, vous pouvez utiliser les cmdlets CsClientPolicy afin de définir, pour certains utilisateurs, un nombre maximal de contacts inférieur à la valeur de MaxContacts.

MaxPersonalNotes

Facultatif

Entier

Indique le nombre maximal de notes personnelles stockées dans l’historique des notes de l’utilisateur. Par défaut, les 3 dernières notes personnelles sont conservées dans l’historique des notes. Il est possible de conserver au maximum 10 notes dans l’historique.

MaxScheduledMeetingsPerOrganizer

Facultatif

Entier

Nombre de réunions maximal pour lesquelles un utilisateur peut avoir le rôle d’organisateur pendant une période donnée. La valeur par défaut est 1 000. Cela signifie que si un utilisateur est déjà l’organisateur de 1 000 réunions, toute tentative de planification d’une nouvelle réunion par celui-ci (numéro de réunion 1 001) échouera.

MaxSubscriptionExpiration

Facultatif

Entier

Les abonnements sont créés à chaque fois qu’un utilisateur effectue une demande de données, telles que des informations de présence. Une fois la demande effectuée, l’utilisateur (ou plus précisément l’application cliente de l’utilisateur) peut demander la durée pendant laquelle l’abonnement restera valide avant qu’il soit nécessaire de le renouveler. La propriété MaxSubscriptionExpiration représente le délai maximum que les clients peuvent obtenir. Par exemple, si la durée maximale est définie sur 28 800 secondes et que le client demande un intervalle de délai de 86 400 secondes, la période d’expiration maximale autorisée lui est attribuée : 28 800 secondes.

La durée maximale d’abonnement doit être exprimée sous la forme d’un entier compris entre 300 secondes (5 minutes) et 86 400 secondes (24 heures), incluses. La valeur par défaut est 43 200 secondes (12 heures).

MaxSubscriptions

Facultatif

Entier

Nombre maximal de boîtes de dialogue d’abonnement SIP qu’un utilisateur peut ouvrir à tout moment. Une boîte de dialogue d’abonnement représente une demande de ressources SIP. La valeur par défaut est 200.

MinSubscriptionExpiration

Facultatif

Entier

Les abonnements sont créés à chaque fois qu’un utilisateur effectue une demande de données, telles que des informations de présence. Une fois la demande effectuée, l’utilisateur (ou plus précisément l’application cliente de l’utilisateur) peut demander la durée pendant laquelle l’abonnement restera valide avant qu’il soit nécessaire de le renouveler. La propriété MinSubscriptionExpiration représente le délai minimum que les clients peuvent obtenir. Par exemple, si la durée minimale est définie sur 1200 secondes et que le client demande un intervalle de délai de 200 secondes, la période d’expiration minimale autorisée lui est attribuée : 1 200 secondes.

La durée minimale d’abonnement doit être exprimée sous la forme d’un entier compris entre 300 secondes (5 minutes) et 86 400 secondes (24 heures), incluses. La valeur par défaut est de 1 200 secondes (20 minutes).

SubscribeToCollapsedDG

Facultatif

Booléen

Si la valeur True (valeur par défaut) est définie, les applications clientes seront autorisées à s’abonner aux groupes de distribution qui ne sont pas actuellement développés dans la liste des contacts. Cela permet au client de gérer les toutes dernières informations de présence pour chaque membre du groupe. Si la valeur False est définie, les applications clientes ne seront pas autorisées à s’abonner aux groupes « réduits ».

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-CsUserServicesConfiguration n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

New-CsUserServicesConfiguration crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.

Exemple

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

New-CsUserServicesConfiguration -Identity site:Redmond -MaxContacts 500 -MaintenanceTimeOfDay "11:00 PM"

La commande de l’exemple 1 crée une nouvelle collection de paramètres de configuration pour les Services d’utilisateurs qui sera appliquée au site de Redmond (-Identity site:Redmond). Outre la spécification de l’identité, la commande définit également le nombre maximal de contacts (-MaxContacts 500) et l’heure du jour à laquelle la maintenance est réalisée (-MaintenanceTimeOfDay "11:00 PM"). Veuillez noter que cette commande échouera si les paramètres Services d’utilisateurs ont déjà été configurés pour le site de Redmond. En effet, vous êtes limité à une seule collection de paramètres par site.

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

$x = New-CsUserServicesConfiguration -Identity site:Redmond -InMemory
$x.MaxContacts = 500 
$x.MaintenanceTimeOfDay = "11:00 PM"
Set-CsUserServicesConfiguration -Instance $x

L’exemple 2 crée également une nouvelle collection de paramètres de configuration pour les Services d’utilisateurs pour le site de Redmond. Cependant, dans cet exemple, la collection est initialement créée en mémoire et est ensuite appliquée au site de Redmond. Pour ce faire, la première commande de cet exemple utilise New-CsUserServicesConfiguration et le paramètre InMemory pour créer une nouvelle collection (avec l’identité site:Redmond) qui existe uniquement en mémoire. Puisque cette collection existe seulement en mémoire, l’objet Services d’utilisateurs doit être stocké dans une variable. Dans ce cas, cette variable s’appelle $x.

Une fois que la collection virtuelle a été créée, les commandes 2 et 3 sont utilisées pour modifier les valeurs des propriétés MaxContacts et MaintenanceTimeOfDay. Dans l’exemple, la commande finale utilise ensuite Set-CsUserServicesConfiguration pour convertir ces paramètres virtuels en une collection de paramètres de configuration pour les services d’utilisateurs appliquée au site de Redmond. Cette dernière étape est cruciale : si vous n’appelez pas Set-CsUserServicesConfiguration, aucun paramètre ne sera appliqué au site de Redmond et vos paramètres virtuels disparaîtront dès que vous mettrez fin à votre session Windows PowerShell ou que vous supprimerez la variable $x.