Partager via

  • Article

Remove-CsUserServicesConfiguration

 

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

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.

Syntaxe

Remove-CsUserServicesConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 Remove-CsUserServicesConfiguration permet de supprimer les paramètres de configuration des services d’utilisateurs appliqués au niveau des étendues Site ou Service. Cette cmdlet 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 Remove-CsUserServicesConfiguration, MaxContacts sera redéfini à sa valeur par défaut, soit 250.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

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 la cmdlet 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.

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. Remove-CsUserServicesConfiguration accepte les instances transmises via le pipeline de l’objet de paramètres des services d’utilisateurs.

Types de retours

Aucun. Au lieu de cela, Remove-CsUserServicesConfiguration supprime les instances existantes de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.

Exemple

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

Remove-CsUserServicesConfiguration -Identity site:Redmond

La commande illustrée dans l’exemple 1 supprime les paramètres de configuration des services d’utilisateurs du site Redmond (-Identity site:Redmond).

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

Get-CsUserServicesConfiguration -Filter "service:*:" | Remove-CsUserServicesConfiguration

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 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 Remove-CsUserServicesConfiguration, qui supprime chaque élément.

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

Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 250} | Remove-CsUserServicesConfiguration

La commande ci-dessus 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 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 la cmdlet 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 la cmdlet Remove-CsUserServicesConfiguration puis supprimés par cette dernière.