Partager via

  • Article

New-CsRegistrarConfiguration

 

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

Crée une nouvelle collection de paramètres de configuration du serveur d’inscriptions. 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

New-CsRegistrarConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Le serveur d’inscriptions est sans doute le composant le plus important de Lync Server. Sans lui, les utilisateurs ne seraient pas en mesure de se connecter au système et Lync Server 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 répond à la demande (c’est-à-dire s’il présente un ensemble d’informations d’identification valide), alors l’utilisateur est authentifié et les informations relatives au système d’extrémité, comme l’adresse IP, le port et le nom d’utilisateur, sont consignées dans la base de données d’inscription. Quand un utilisateur se déconnecte, ces informations sont supprimées de la base de données. 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 New-CsRegistrarConfiguration vous permet de créer de nouveaux paramètres de configuration du serveur d’inscriptions au niveau de l’étendue Site ou Service. Notez qu’un site ou service donné ne peut présenter qu’une seule de ces collections de paramètres ; si vous tentez d’ajouter une nouvelle collection à un site ou à un service qui héberge déjà une collection de paramètres de configuration de serveur d’inscriptions, votre commande échouera. Elle échouera également si vous essayez de créer des paramètres au niveau de l’étendue Globale.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identifiant unique des paramètres de configuration du serveur d’inscriptions à créer. Pour créer les paramètres configurés au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Pour créer des paramètres au niveau du service, utilisez une syntaxe comparable à celle-ci : -Identity service:Registrar:atl-cs-001.litwareinc.com. Notez qu’un site ou un service donné peut héberger, au maximum, une seule collection de paramètres de serveur d’inscriptions. Si vous essayez de créer une collection avec l’identité site:Redmond et si le site de Redmond héberge déjà une collection de paramètres de serveur d’inscriptions, votre tentative se soldera par un échec.

En outre, vous ne pouvez pas créer de nouveaux paramètres de serveur d’inscriptions au niveau de l’étendue globale. Si vous souhaitez modifier les valeurs au niveau de l’étendue globale, utilisez la cmdlet Set-CsRegistrarConfiguration.

DefaultEndpointExpiration

Facultatif

Entier

Quand des points de terminaison se connectent, ils peuvent demander un délai d’expiration. Ce dernier spécifie l’intervalle de temps durant lequel un point de terminaison peut rester connecté au système avant de contacter le serveur et de demander une extension. La propriété DefaultEndpointExpiration représente l’intervalle du délai d’expiration pour les clients qui ne demandent pas de valeur de délai spécifique.

DefaultEndpointExpiration doit être situé entre 300 (5 minutes) et 900 (15 minutes). La valeur par défaut est 600 secondes (10 minutes).

EnableDHCPServer

Facultatif

Booléen

Indique si les points de terminaison peuvent utiliser des serveurs DHCP afin de localiser un serveur d’inscriptions. Si la valeur est définie sur True, les clients envoient un message d’information DHCP lorsqu’ils démarrent. Le serveur DHCP répond par l’envoi du nom de domaine complet d’un serveur d’inscriptions pouvant être utilisé pour la connexion de l’utilisateur.

MaxEndpointExpiration

Facultatif

Entier

Quand des systèmes d’extrémité se connectent, ils peuvent demander un délai d’expiration. Ce dernier spécifie l’intervalle de temps durant lequel un système d’extrémité peut rester connecté au système avant de contacter le serveur et de demander une extension. La propriété MaxEndpointExpiration représente la durée maximale que les clients peuvent obtenir. Par exemple, si la durée maximale est définie sur 600 secondes et que le client demande un intervalle de délai de 800 secondes, la période d’expiration maximale autorisée lui est attribuée : 600 secondes.

MaxEndpointExpiration doit être situé entre 300 (5 minutes) et 900 (15 minutes). La valeur par défaut est 900.

MinEndpointExpiration

Facultatif

Entier

Quand des systèmes d’extrémité se connectent, ils peuvent demander un délai d’expiration. Ce dernier spécifie l’intervalle de temps durant lequel un système d’extrémité peut rester connecté au système avant de contacter le serveur et de demander une extension. La propriété MinEndpointExpiration représente le délai minimum que les clients peuvent obtenir. Par exemple, si la durée minimale est définie sur 600 secondes et que le client demande un intervalle de délai de 200 secondes, la période d’expiration minimale autorisée lui est attribuée : 600 secondes.

MinEndpointExpiration doit être situé entre 300 (5 minutes) et 900 (15 minutes). La valeur par défaut est 300.

MaxEndpointsPerUser

Facultatif

Entier

Indique le nombre maximum de points de terminaison qu’un utilisateur peut connecter simultanément au système. (Par exemple, un utilisateur connecté à Lync Server 2010 avec un ordinateur et un téléphone mobile utilise deux systèmes d’extrémité. MaxEndpointsPerUser doit être compris entre 1 et 64 inclus. La valeur par défaut est 8.

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.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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

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

Types de retours

New-CsRegistrarConfiguration crée des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Exemple

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

New-CsRegistrarConfiguration -Identity site:Redmond -MaxEndpointsPerUser 4 -EnableDHCPServer $True

La commande ci-dessus crée une nouvelle collection de paramètres de configuration du serveur d’inscriptions pour le site de Redmond (-Identity site:Redmond). Outre la spécification de l’identité pour les nouveaux paramètres, la commande définit également le nombre maximal de points de terminaison par utilisateur sur 4 (-MaxEndpointsPerUser 4) et autorise l’utilisation du serveur DHCP pour l’inscription des clients (-EnableDHCPServer $True). Notez que cette commande échouera si le site Redmond est déjà affecté à une collection de paramètres de configuration de serveur d’inscriptions.

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

$x = New-CsRegistrarConfiguration -Identity site:Redmond -InMemory 
$x.MaxEndpointsPerUser = 4 
$x.EnableDHCPServer = $True
Set-CsRegistrarConfiguration -Instance $x

La commande illustrée dans l’exemple 2 crée également une collection de paramètres de configuration du serveur d’inscriptions pour le site Redmond (-Identity site:Redmond). Dans cet exemple cependant, ces paramètres sont d’abord créés en mémoire uniquement, puis appliqués ultérieurement au site lui-même.

Pour effectuer cette tâche, la première commande utilise New-CsRegistrarConfiguration pour créer une collection de paramètres pour le site:Redmond ; le paramètre InMemory est ajouté à la fin de la commande pour s’assurer que les paramètres sont créés uniquement en mémoire et ne sont pas immédiatement appliqués au site Redmond. Puisque ces paramètres n’existent qu’en mémoire, ils doivent être enregistrés dans une variable. Dans cet exemple, cette variable s’appelle $x.

Dans les commandes 2 et 3, deux propriétés de ces nouveaux paramètres virtuels (MaxEndpointsPerUser et EnableDHCPServer) sont modifiées. La dernière commande de l’exemple utilise ensuite Set-CsRegistrarConfiguration pour transformer les paramètres virtuels stockés dans $x en un ensemble réel de paramètres de configuration de serveur d’inscriptions appliqué au site Redmond. Si vous n’appelez pas Set-CsRegistrarConfiguration, aucun paramètre ne sera créé pour le site Redmond et vos paramètres virtuels disparaîtront dès que vous mettrez fin à votre session Windows PowerShell ou que vous supprimerez la variable $x.