Partager via

  • Article

Get-CsUserServicesConfiguration

 

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

Renvoie des informations sur les paramètres de configuration du service Services d'utilisateurs utilisés dans votre organisation. Le service Services d'utilisateurs permet de gérer les informations de présence et les conférences.

Syntaxe

Get-CsUserServicesConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsUserServicesConfiguration [-Filter <String>] [-LocalStore <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 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 Get-CsUserServicesConfiguration permet aux administrateurs d’extraire des informations sur un (ou tous) les paramètres de configuration du service Services d'utilisateurs actuellement utilisés.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsUserServicesConfiguration : RTCUniversalUserAdmins, 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 "Get-CsUserServicesConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique des paramètres de configuration du service Services d'utilisateurs à renvoyer. Pour renvoyer les paramètres globaux, utilisez la syntaxe suivante : -Identity global. Pour renvoyer les paramètres configurés dans l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Pour renvoyer les paramètres au niveau du service, utilisez une syntaxe similaire à celle-ci : -Identity service:UserServer:atl-cs-001.litwareinc.com.

Si ce paramètre est omis, Get-CsUserServicesConfiguration renvoie tous les paramètres de configuration du service Services d'utilisateurs actuellement utilisés dans votre organisation.

Filter

Facultatif

Chaîne

Vous permet d’utiliser des caractères génériques pour extraire un ou plusieurs ensembles de paramètres de configuration du service Services d'utilisateurs. Par exemple, pour renvoyer tous les paramètres configurés dans l’étendue Site, utilisez la syntaxe suivante : -Filter "site:*". Pour renvoyer tous les paramètres configurés dans l’étendue Service, utilisez la syntaxe suivante : -Filter "service:*".

LocalStore

Facultatif

Paramètre de commutateur

Extrait les données de configuration du service Services d’utilisateurs du réplica local du magasin central de gestion et non du magasin central de gestion proprement dit.

Types d’entrées

Aucun. Get-CsUserServicesConfiguration n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Get-CsUserServicesConfiguration retourne des instances de l'objet Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.

Exemple

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

Get-CsUserServicesConfiguration

La commande illustrée dans l’exemple 1 renvoie un ensemble de tous les paramètres de configuration du service Services d'utilisateur actuellement utilisés dans l’organisation. Cette opération est effectuée en appelant la cmdlet Get-CsUserServicesConfiguration sans aucun paramètre supplémentaire.

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

Get-CsUserServicesConfiguration -Identity site:Redmond

Dans l’exemple 2, un seul ensemble de paramètres de configuration du service Services d'utilisateurs est renvoyé : l’ensemble comportant l’identité site:Redmond. Parce que les identités doivent être uniques, cette commande ne peut jamais renvoyer plus d’un élément.

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

Get-CsUserServicesConfiguration -Filter "service:*"

L’exemple 3 renvoie un ensemble de tous les paramètres de configuration du service Services d'utilisateurs qui ont été appliqués dans l’étendue Service. Cette opération est effectuée en appelant la cmdlet Get-CsUserServicesConfiguration conjointement avec le paramètre -Filter ; la valeur de filtre « service:* » limite les données renvoyées aux paramètres dont l’identité commence par les caractères « service: ». Par définition, il s’agit des paramètres configurés dans l’étendue Service.

-------------------------- Exemple 4 --------------------------

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

La commande précédente renvoie tous les paramètres de configuration du service Services d'utilisateurs qui permettent aux utilisateurs d’avoir plus de 250 contacts. Pour ce faire, la commande appelle d’abord Get-CsUserServicesConfiguration sans aucun paramètre supplémentaire afin de renvoyer un ensemble de tous les paramètres de configuration du service Services d'utilisation actuellement utilisés. Cet ensemble est ensuite redirigé vers la cmdlet Where-Object, qui sélectionne uniquement les paramètres dont la propriété MaxContacts est supérieure à 250.

-------------------------- Exemple 5 --------------------------

Get-CsUserServicesConfiguration | Where-Object {$_.AnonymousUserGracePeriod -gt "00:10:00"}

Dans l’exemple 5, des informations sont renvoyées sur les paramètres de configuration du service Services d'utilisateurs où la période de grâce des utilisateurs anonymes est supérieure à 10 minutes. Pour exécuter cette tâche, la commande appelle d’abord Get-CsUserServicesConfiguration sans aucun paramètre supplémentaire. Un ensemble de tous les paramètres de configuration du service Services d'utilisateurs actuellement utilisés dans l’organisation est alors renvoyé. L’ensemble renvoyé est ensuite redirigé vers Where-Object, qui sélectionne uniquement les paramètres dont la propriété AnonymousUserGracePeriod est supérieure à 10 minutes (00heure : 10 minutes : 00 seconde).