Partager via


Set-CsRegistrarConfiguration

 

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

Modifie les valeurs de propriété au sein d’une collection existante de paramètres de configuration de serveurs 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

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

Set-CsRegistrarConfiguration [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 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 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’enregistrement. 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 sont uniquement utilisés avec le service Serveur d’inscriptions.) La cmdlet Set-CsRegistrarConfiguration peut être utilisée pour modifier une ou toutes les collections de configurations de serveurs 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 Set-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 "Set-CsRegistrarConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique des paramètres de configuration du serveur d’inscriptions à modifier. Pour modifier les paramètres globaux, utilisez cette syntaxe : -Identity global. Pour modifier les paramètres configurés au niveau de l’étendue Site, utilisez une syntaxe similaire à celle-ci : -Identity site:Redmond. Pour modifier les paramètres au niveau du service, utilisez une syntaxe comparable à celle-ci : -Identity service:Registrar:atl-cs-001.litwareinc.com. Notez que les paramètres du serveur d’inscriptions ne s’appliquent qu’au service Serveur d’inscriptions. Un message d’erreur est généré si vous tentez d’appliquer ces paramètres à un autre service.

Instance

Facultatif

Objet RegistrarSettings

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

DefaultEndpointExpiration

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é 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 (10 minutes).

EnableDHCPServer

Facultatif

Booléen

Indique si les systèmes d'extrémité 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 (FQDN) 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.

MaxEndpointsPerUser

Facultatif

Entier

Indique le nombre maximum de systèmes d'extrémité 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.

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.

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.Registrar.RegistrarSettings. Set-CsRegistrarConfiguration accepte les instances transmises via le pipeline de l’objet de paramètres du serveur d’inscriptions.

Types de retours

Set-CsRegistrarConfiguration ne renvoie aucune valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings.

Exemple

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

Set-CsRegistrarConfiguration -Identity site:Redmond -EnableDHCPServer $True

La commande ci-dessus modifie les paramètres de configuration du serveur d’inscriptions appliqués au site Redmond (-Identity site:Redmond). Dans cet exemple, la valeur de la propriété EnableDHCPServer est définie sur True.

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

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

Dans l’exemple 2, tout paramètre de configuration du serveur d’inscriptions permettant aux utilisateurs de disposer de plus de 8 systèmes d’extrémité est modifié. Pour effectuer cette tâche, la commande appelle d’abord Get-CsRegistrarConfiguration sans paramètres, ce qui retourne 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 choisit uniquement les paramètres pour lesquels la propriété MaxEndpointsPerUser est supérieure (-gt) à 8. Pour finir, la collection filtrée est redirigée vers la cmdlet Set-CsRegistrarCollection qui définit le nombre maximal de systèmes d’extrémité pour chaque élément de la collection sur la valeur 8.

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

Get-CsRegistrarConfiguration -Filter "site:*"| Set-CsRegistrarConfiguration -EnableDHCPServer $False

La commande de l’exemple 3 désactive l’inscription du client en utilisant le serveur DHCP de chaque site de l’organisation qui héberge une collection de paramètres de configuration du serveur d’inscriptions. Pour ce faire, la commande appelle Get-CsRegistrarConfiguration avec le paramètre Filter. La valeur de paramètre "site:*" limite les données renvoyées aux paramètres configurés au niveau de l’étendue Site. La collection est ensuite redirigée vers Set-CsRegistrarConfiguration, qui utilise le paramètre EnableDHCPServer et la valeur de paramètre $False pour empêcher les clients d’utiliser un serveur DHCP pour localiser un serveur d’inscriptions.