Set-CsUserServicesConfiguration
Dernière rubrique modifiée : 2012-04-23
Modifie une collection existante de paramètres de configuration des services d’utilisateurs. Le service Services d’utilisateurs permet de gérer les informations de présence et les conférences.
Syntaxe
Set-CsUserServicesConfiguration [-Identity <XdsIdentity>] [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-MaintenanceTimeOfDay <DateTime>] [-MaxContacts <UInt16>] [-MaxPersonalNotes <UInt32>] [-MaxScheduledMeetingsPerOrganizer <UInt32>] [-MaxSubscriptionExpiration <Int64>] [-MaxSubscriptions <UInt16>] [-MinSubscriptionExpiration <Int64>] [-SubscribeToCollapsedDG <$true | $false>] [-WhatIf [<SwitchParameter>]]
Set-CsUserServicesConfiguration [-AnonymousUserGracePeriod <TimeSpan>] [-Confirm [<SwitchParameter>]] [-DeactivationGracePeriod <TimeSpan>] [-DefaultSubscriptionExpiration <Int64>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 pour administrer les paramètres de configuration des 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 des 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 Set-CsUserServicesConfiguration permet aux administrateurs de modifier les informations relatives aux paramètres de configuration des services d’utilisateurs utilisés actuellement.
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-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 "Set-CsUserServicesConfiguration"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique des paramètres de configuration des services d’utilisateurs à modifier. Pour modifier les paramètres globaux, utilisez la syntaxe : -Identity global. Pour modifier des paramètres configurés au niveau du site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Pour modifier des paramètres au niveau du service, utilisez une syntaxe similaire à celle-ci : -Identity service:UserServer:atl-cs-001.litwareinc.com. |
Instance |
Facultatif |
Objet UserServicesSettings |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. |
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 Conférence maintenant dans Microsoft Lync. La période AnonymousUserGracePeriod doit être spécifiée au format : jours.minutes:secondes (par exemple, 0.00:30:00 pour 30 minutes). La période de grâce peut être définie avec n’importe quelle valeur entre 0 seconde et 1 jour, la valeur par défaut étant 90 minutes (01:30:00). |
DeactivationGracePeriod |
Facultatif |
TimeSpan |
La durée maximale pendant laquelle une réunion peut rester active. La valeur doit être spécifiée au format suivant : jours.heures:minutes:secondes. Par exemple, pour activer une réunion pendant au moins 60 heures, il vous faut utiliser ce format : 2.12:00:00 (2 jours : 12 heures: 00 minute : 00 seconde). La période DeactivationGracePeriod doit être définie entre 8 heures et 365 jours, inclus. La valeur par défaut est 1 jour. |
DefaultSubscriptionExpiration |
Facultatif |
Entier |
Les inscriptions sont créées chaque fois qu’un utilisateur fait une demande de données telles que les informations de présence. Pour la requête, l’utilisateur (ou, plus exactement l’application client de l’utilisateur) peut demander la durée pendant laquelle la souscription restera valide avant son renouvellement. Si une telle requête n’est pas formulée, alors l’inscription est définie à la valeur spécifiée par la propriété DefaultSubscriptionExpiration. La durée de souscription par défaut doit être exprimée en tant que valeur entière, entre 300 secondes (5 minutes) et 86400 secondes (24 heures), incluses. La valeur par défaut est 28 800 secondes (8 heures). |
MaintenanceTimeOfDay |
Facultatif |
DateTime |
Indique l’heure de la journée à laquelle la maintenance des bases de données programmée a lieu régulièrement (comme le nettoyage des enregistrements obsolètes). Cette valeur doit être spécifiée en tant que valeur date-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 pour MaintenanceTimeOfDay est 1 h (01:00:00). |
MaxContacts |
Facultatif |
Entier |
Nombre maximal de contacts dont peut disposer 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 cmdletsCsClientPolicy 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 |
Le nombre de réunions maximum pour un utilisateur unique, organisateur pour 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 demande de planification d’une nouvelle réunion par celui-ci (numéro de réunion 1 001) échouera. |
MaxSubscriptionExpiration |
Facultatif |
Entier |
Les inscriptions sont créées chaque fois qu’un utilisateur fait une demande de données telles que les informations de présence. Pour la requête, l’utilisateur (ou, plus exactement l’application client de l’utilisateur) peut demander la durée pendant laquelle la souscription restera valide avant son renouvellement. La propriété MaxSubscriptionExpiration représente la durée maximale accordée aux clients. Par exemple, si la durée maximale est configurée sur 28800 secondes et que le client demande un intervalle de temporisation de 86400 secondes, il lui sera accordé la période d’expiration maximale permise. 28800 secondes. La durée maximale d’inscription doit être exprimée en tant que valeur entière, entre 300 secondes (5 minutes) et 86400 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. |
MinSubscriptionExpiration |
Facultatif |
Entier |
Les inscriptions sont créées chaque fois qu’un utilisateur fait une demande de données telles que les informations de présence. Pour la requête, l’utilisateur (ou, plus exactement l’application client de l’utilisateur) peut demander la durée pendant laquelle la souscription restera valide avant son renouvellement. La propriété MinSubscriptionExpiration représente la durée minimale accordée aux clients. Par exemple, si la durée minimale est configurée avec une valeur de 1200 secondes et que le client demande un intervalle de temporisation de 200 secondes, il lui sera accordé la période d’expiration minimale permise. 1200 secondes. La durée minimale d’inscription doit être exprimée en tant que valeur entière, entre 300 secondes (5 minutes) et 86400 secondes (24 heures), incluses. La valeur par défaut est de 1200 secondes (20 minutes). |
SubscribeToCollapsedDG |
Facultatif |
Booléen |
Si la valeur par défaut est True, 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. |
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.Settings.UserServices.UserServicesSettings. Set-CsUserServicesConfiguration accepte les instances transmises via le pipeline de l’objet de paramètres des services d’utilisateurs.
Types de retours
Set-CsUserServicesConfiguration ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsUserServicesConfiguration -Identity site:Redmond -AnonymousUserGracePeriod "00:30:00"
La commande indiquée dans l’exemple 1 modifie les paramètres de configuration des services d’utilisateurs pour le site de Redmond (-Identity site:Redmond). Dans cet exemple, AnonymousUserGracePeriod est configurée sur 30 minutes (00 heure: 30 minutes: 00 seconde).
-------------------------- Exemple 2 --------------------------
Set-CsUserServicesConfiguration -Identity site:Redmond -MaintenanceTimeOfDay "13:30"
Dans l’exemple 2, la propriété MaintenanceTimeOfDay est modifiée pour les paramètres de configuration des services d’utilisateurs appliqués au site Redmond. Vous pouvez pour cela utiliser le paramètre MaintenanceTimeOfDay et la valeur de paramètre 13:30, fixant ainsi l’heure de maintenance à 13 h 30 (soit 13 heures et 30 minutes au format 24 heures).
-------------------------- Exemple 3 --------------------------
Get-CsUserServicesConfiguration -Filter "service:*" | Set-CsUserServicesConfiguration -MaxContacts 300
La commande précédente récupère tous les paramètres de configuration des services d’utilisateurs appliqués à l’étendue Service, puis modifie le nombre de contacts permis pour chacun de ces éléments. Pour effectuer cette tâche, la commande utilise d’abord Get-CsUserServicesConfiguration et le paramètre Filter pour récupérer tous les paramètres configurés dans l’étendue Service. La valeur de filtre « service:* » limite les données renvoyées aux paramètres dont l’identité commence par les caractères « service: ». Cette collection filtrée est ensuite transférée à Set-CsUserServicesConfiguration qui prend chaque élément dans la collection et définit la propriété MaxContacts à 300.
-------------------------- Exemple 4 --------------------------
Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 300} | Set-CsUserServicesConfiguration -MaxContacts 300
Dans l’exemple 4, tous les paramètres de configuration des services d’utilisateurs permettent aux utilisateurs de modifier plus de 300 contacts. Une fois les modifications effectuées, aucun paramètre ne peut autoriser plus de 300 contacts. Pour ce faire, la commande appelle d’abord Get-CsUserServicesConfiguration sans paramètres supplémentaires. La commande retourne une collection de tous les paramètres de configuration des services utilisateurs actuellement utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui ne choisit que les paramètres MaxContacts supérieurs à 300. Puis, la collection filtrée est redirigée vers Set-CsUserServicesConfiguration qui prend chaque élément dans la collection filtrée et modifie le nombre maximum de contacts à 300.
Voir aussi
Autres ressources
Get-CsUserServicesConfiguration
New-CsUserServicesConfiguration
Remove-CsUserServicesConfiguration