Partager via

  • Article

Get-CsRegistrarConfiguration

 

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

Retourne des informations concernant les paramètres de configuration du Serveur d’inscriptions actuellement utilisés dans votre organisation. Les serveurs d’inscriptions servent à authentifier les demandes d’ouverture de session et à tenir à jour les informations sur l’état et la disponibilité des utilisateurs.

Syntaxe

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

Get-CsRegistrarConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Description détaillée

Le Serveur d’inscriptions est sans doute le composant le plus important de Microsoft Lync Server 2010. Sans lui, les utilisateurs ne seraient pas en mesure de se connecter au système et Lync Server 2010 ne pourrait pas garder de traces des utilisateurs et de leurs états actuels. Quand un utilisateur se connecte à Lync Server, le système d’extrémité à partir duquel il se connecte envoie une requête REGISTER au serveur d’inscriptions. Le serveur répond à son tour en demandant au périphérique client ses informations d’identification pour l’authentification. Si le client passe l’inspection avec succès (c’est-à-dire que le client a présenté un jeu d’informations d’authentification valide), alors l’utilisateur est authentifié et les informations de point de terminaison comme l’adresse IP, le port et le nom d’utilisateur sont journalisées dans la base de données d’administration. Cette information est supprimée de la base de données quand l’utilisateur ferme la session. Entre la connexion et la déconnexion, le serveur d’inscriptions tient les informations d’état à jour et contribue à l’acheminement des messages depuis et vers l’utilisateur.

Les paramètres de configuration du serveur d’inscriptions contribuent à gérer les systèmes d’extrémité et leurs abonnements. Ces paramètres peuvent être appliqués au niveau des étendues Site et Service, ainsi qu’au niveau de l’étendue globale. (Les paramètres au niveau de l’étendue Service ne peuvent être utilisés qu’avec le service Serveur d’inscriptions.) La cmdlet Get-CsRegistrarConfiguration est utilisée pour retourner des informations sur les collections de configurations du Serveur d’inscriptions utilisées dans votre organisation.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique pour les paramètres de configuration du Serveur d’inscriptions à retourner. Pour retourner 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 retourner des paramètres au niveau du service, utilisez une syntaxe similaire à celle-ci : -Identity service:Registrar:atl-cs-001.litwareinc.com.

Si ce paramètre est omis, alors Get-CsRegistrarConfiguration retourne tous les paramètres de configuration du Serveur d’inscriptions qui sont utilisés actuellement dans votre organisation.

Filter

Facultatif

Chaîne

Vous permet d’utiliser des caractères génériques pour retourner une ou plusieurs collections de paramètres de configuration du Serveur d’inscriptions. Par exemple, pour retourner tous les paramètres configurés au niveau de l’étendue Site, utilisez la syntaxe suivante : -Filter "site:*". Pour retourner tous les paramètres configurés au niveau de l’étendue Service, utilisez la syntaxe suivante : -Filter "service:*".

LocalStore

Facultatif

Paramètre de commutateur

Extrait les données des paramètres de configuration du Serveur d’inscriptions du réplica local de la magasin central de gestion et non de la magasin central de gestion proprement dite.

Types d’entrées

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

Types de retours

Get-CsRegistrarConfiguration retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Exemple

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

Get-CsRegistrarConfiguration

La commande indiquée à l’exemple 1 retourne la collection des paramètres de configuration du Serveur d’inscriptions utilisés actuellement dans votre organisation.

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

Get-CsRegistrarConfiguration -Identity site:Redmond

L’exemple 2 retourne la collection unique des paramètres de configuration du Serveur d’inscriptions : les paramètres configurés pour le site Redmond (-Identity site:Redmond).

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

Get-CsRegistrarConfiguration -Filter "service:*"

Dans l’exemple 3, les informations sont retournées pour tous les paramètres de configuration du Serveur d’inscriptions affectés au niveau de l’étendue Service. Pour ce faire, la commande utilise le paramètre Filter et la valeur de filtre « service:* ». Cette valeur de filtre garantit que seuls seront retournés les paramètres dont l’identité commence par la valeur de chaîne « service: » .

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

Get-CsRegistrarConfiguration | Where-Object {$_.EnableDHCPServer -eq $True}

L’exemple 4 retourne des informations concernant les paramètres de configuration du Serveur d’inscriptions permettant d’utiliser des serveurs DHCP afin d’enregistrer des clients. Pour cette tâche, la commande appelle d’abord Get-CsRegistrarConfiguration sans paramètre. Cela permet de retourner une collection de tous les paramètres de configuration du Serveur d’inscriptions utilisés actuellement. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui sélectionne uniquement les paramètres dont la propriété EnableDHCPServer est égale à True.

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

Get-CsRegistrarConfiguration | Where-Object {$_.MaxEndpointsPerUser -gt 8}

Dans la commande précédente, des informations sont retournées pour tous les paramètres de configuration du Serveur d’inscriptions, ce qui permet d’avoir plus de huit systèmes d’extrémité par utilisateur. Pour ce faire, la commande utilise d’abord Get-CsRegistrarConfiguration pour retourner une collection de tous les paramètres de configuration du Serveur d’inscriptions utilisés dans l’organisation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui ne sélectionne que les paramètres pour lesquels la propriété MaxEndpointsPerUser est supérieure à 8.