.png)
Remove-CsUserServicesConfiguration
Dernière rubrique modifiée : 2013-02-22
Supprime 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. Cette applet de commande est une nouveauté de Lync Server 2010.
Remove-CsUserServicesConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
La commande illustrée dans l’exemple 1 supprime les paramètres de configuration des services d’utilisateurs du site Redmond (-Identity site:Redmond).
Remove-CsUserServicesConfiguration -Identity site:Redmond
Dans l’exemple 2, tous les paramètres de configuration des services d’utilisateurs appliqués au niveau de l’étendue Service sont supprimés. Pour ce faire, la commande appelle l’applet de commande Get-CsUserServicesConfiguration avec le paramètre Filter. La valeur de filtre service:* limite les données retournées aux paramètres configurés au niveau de l’étendue Service (soit les paramètres dont l’identité commence par service:). Cette collection filtrée est ensuite redirigée vers l’applet de commande Remove-CsUserServicesConfiguration, qui supprime chaque élément.
Get-CsUserServicesConfiguration -Filter "service:*:" | Remove-CsUserServicesConfiguration
La commande de l’exemple 3 supprime tous les paramètres de configuration des services d’utilisateurs permettant aux utilisateurs d’avoir plus de 250 contacts. Pour effectuer cette tâche, la commande appelle d’abord l’applet de commande Get-CsUserServicesConfiguration (sans paramètres) afin de retourner une collection de tous les paramètres de configuration des services d’utilisateurs en cours d’utilisation. Cette collection est redirigée vers l’applet de commande Where-Object qui ne sélectionne que les paramètres pour lesquels la valeur de la propriété MaxContacts est supérieure à 250. Ces paramètres sont alors redirigés vers l’applet de commande Remove-CsUserServicesConfiguration puis supprimés par cette dernière.
Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 250} | Remove-CsUserServicesConfiguration
Lync Server 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 applets de commande 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.
L’applet de commande Remove-CsUserServicesConfiguration permet de supprimer les paramètres de configuration des services d’utilisateurs appliqués au niveau des étendues Site ou Service. Cette applet de commande peut aussi être exécutée sur la collection globale. Dans ce cas toutefois, les paramètres globaux ne seront pas supprimés, ces derniers ne pouvant l’être. Toutes les propriétés de la collection globale seront en revanche réinitialisées à leurs valeurs par défaut. Ainsi, si vous avez attribué à MaxContacts la valeur 500 dans les paramètres globaux, puis que vous exécutez l’applet de commande Remove-CsUserServicesConfiguration, MaxContacts sera redéfini à sa valeur par défaut, soit 250.
Personnes autorisées à exécuter cette applet de commande : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement l’applet de commande Remove-CsUserServicesConfiguration : RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette applet de commande 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-CsUserServicesConfiguration"}
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
| Identity | Obligatoire | Microsoft.Rtc.Management.Xds.XdsIdentity | Identificateur unique des paramètres de configuration des services d’utilisateurs à supprimer. Pour supprimer les paramètres configurés au niveau de cette étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Pour supprimer les paramètres au niveau du service, utilisez une syntaxe similaire à celle-ci : -Identity service:UserServer:atl-cs-001.litwareinc.com. Vous pouvez également exécuter l’applet de commande Remove-CsUserServicesConfiguration sur la collection globale. Dans ce cas toutefois, la collection globale ne sera pas supprimée. Toutes les propriétés de la collection seront en revanche réinitialisées à leurs valeurs par défaut. |
| Confirm | Facultatif | System.Management.Automation.SwitchParameter | Vous demande confirmation avant d’exécuter la commande. |
| Force | Facultatif | System.Management.Automation.SwitchParameter | 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 | System.Management.Automation.SwitchParameter | Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement. |
Objet Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings. L’applet de commande Remove-CsUserServicesConfiguration accepte les instances redirigées de l’objet de paramètres des services d’utilisateurs.
Aucun. Au lieu de cela, l’applet de commande Remove-CsUserServicesConfiguration supprime les instances existantes de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.
