Set-CsRegistrar
Dernière rubrique modifiée : 2012-03-26
Permet de modifier les propriétés d’un ou plusieurs 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-CsRegistrar [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-BackupRegistrar <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-EnableAutomaticFailover <$true | $false>] [-FailbackDetectionInterval <TimeSpan>] [-FailureDetectionInterval <TimeSpan>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-Registrar <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-UserServer <String>] [-WebPort <UInt16>] [-WebServer <String>] [-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 (un ordinateur, un téléphone portable ou tout autre périphérique) 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. 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.
La cmdlet Set-CsRegistrar offre un moyen de modifier les propriétés d’un ou plusieurs serveurs d’inscriptions dans votre organisation. Ces modifications concernent les paramètres de port, ainsi que l’action entreprise si un serveur d’inscriptions est indisponible.
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-CsRegistrar : 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-CsRegistrar\b"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Emplacement de service du serveur d’inscriptions à modifier. Par exemple : -Identity "Registrar:atl-cs-001.litwareinc.com". Notez que vous pouvez supprimer le préfixe « Registrar: » pour spécifier un serveur d’inscription. Par exemple : -Identity "atl-cs-001.litwareinc.com". |
ArchivingServer |
Facultatif |
Chaîne |
Emplacement de service du serveur d’archivage à associer au serveur d’inscriptions. Par exemple : -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com". |
BackupRegistrar |
Facultatif |
Chaîne |
Emplacement du service Serveur d’inscriptions à utiliser si ce serveur d’inscriptions n’est pas disponible. Par exemple : -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com". |
EdgeServer |
Facultatif |
Chaîne |
Emplacement de service du serveur Edge à associer au serveur d’inscriptions. Par exemple : -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com". |
EnableAutomaticFailover |
Facultatif |
Booléen |
Si défini sur True, le serveur d’inscriptions de sauvegarde sera employé chaque fois que le serveur d’inscriptions principal n’est pas disponible. Si défini sur False, le serveur d’inscriptions de sauvegarde ne sera pas utilisé lorsque le serveur d’inscriptions principal n’est pas disponible. Ce paramètre affecte également les utilisateurs qui se sont inscrits avec un serveur d’inscriptions de sauvegarde. Si ce paramètre est défini sur True, ces utilisateurs seront supprimés du serveur d’inscriptions de sauvegarde et réinscrits sur le serveur d’inscriptions principal quand celui-ci redevient disponible. |
FailbackDetectionInterval |
Facultatif |
TimeSpan |
Spécifie l’intervalle de temps que le système doit attendre avant de vérifier si serveur d’inscriptions devenu disponible est de nouveau disponible. Si EnableAutomaticFailover est défini sur la valeur True, le système bascule automatiquement vers le serveur d’inscriptions de sauvegarde chaque fois qu’un serveur d’inscriptions devient indisponible. Ainsi, le système prend les utilisateurs qui sont connectés au serveur d’inscriptions non fonctionnel et tente de les connecter au serveur d’inscriptions de sauvegarde. La propriété FailbackDetectionInterval spécifie l’intervalle de temps que le système doit attendre avant de vérifier si serveur d’inscriptions d’origine est de nouveau disponible. S’il est spécifié, Lync Server tente alors de restaurer automatiquement le serveur. Cette restauration consiste à revenir au serveur d’inscriptions initialement utilisé. En d’autres termes, les utilisateurs sont de nouveau connectés à leur serveur d’inscriptions d’origine. Notez qu’il s’agit d’un processus automatique seulement. Vous ne pouvez pas passer manuellement d’un serveur d’inscriptions à l’autre. L’intervalle de détection peut être défini sur toute valeur comprise entre 30 et 84 400 secondes (24 heures). Spécifiez cette durée à l’aide du format heures:minutes:secondes. Par exemple, ceci définit l’intervalle de 1 heure et 15 minutes : - FailbackDetectionInterval 01:15:00. Ce paramètre ne peut pas être utilisé à moins d’avoir spécifié un serveur d’inscriptions de sauvegarde. |
FailureDetectionInterval |
Facultatif |
TimeSpan |
Spécifie l’intervalle de temps que le système doit attendre avant de décider qu’un serveur d’inscriptions n’est plus disponible. Si EnableAutomaticFailover a été défini sur True, le système tente alors de connecter les utilisateurs sur le serveur d’inscriptions de sauvegarde. L’intervalle de détection peut être défini sur toute valeur comprise entre 30 et 84 400 secondes (24 heures). Spécifiez cette durée à l’aide du format heures:minutes:secondes. Par exemple, ceci définit l’intervalle de 1 heure et 15 minutes : - FailureDetectionInterval 01:15:00. Ce paramètre ne peut pas être utilisé à moins d’avoir spécifié un serveur d’inscriptions de sauvegarde. |
MonitoringServer |
Facultatif |
Chaîne |
Emplacement de service du serveur de surveillance à associer au serveur d’inscriptions. Par exemple : -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com". |
Registrar |
Facultatif |
Chaîne |
Emplacement de service de Registrar. |
SipPort |
Facultatif |
Entier |
Port utilisé pour le trafic SIP (Session Initiation Protocol). |
SipHealthPort |
Facultatif |
Chaîne |
Port utilisé pour surveiller l’intégrité du serveur. |
SipServerTcpPort |
Facultatif |
Chaîne |
Port d’écoute SIP. La valeur par défaut est 5060. |
UserServer |
Facultatif |
Chaîne |
Emplacement de service du service services d’utilisateurs à associer au serveur d’inscriptions. Par exemple : -UserServer "UserServer:atl-cs-001.litwareinc.com". |
WebPort |
Facultatif |
Entier |
Port utilisé pour communiquer avec les serveurs Web. |
WebServer |
Facultatif |
Chaîne |
Emplacement du serveur Web à associer au serveur d’inscriptions. Par exemple : -WebServer "WebServer:atl-cs-001.litwareinc.com". |
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
Aucun. Set-CsRegistrar n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Set-CsRegistrar ne retourne ni objet, ni valeur. Au lieu de cela, la commande modifie les instances existantes de l’objet Microsoft.Rtc.Management.Xds.DisplayRegistrar.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -SipPort 5072
La commande présentée dans l’exemple 1 définit le port SIP du serveur d’inscriptions Registrar:atl-cs-001.litwareinc.com sur 5072.
-------------------------- Exemple 2 --------------------------
Get-CsService -Registrar | ForEach-Object {Set-CsRegistrar -Identity $_.Identity -SipPort 5072}
La commande précédente définit le port SIP de tous les serveurs d’inscriptions de l’organisation sur 5072. Pour ce faire, la commande utilise préalablement Get-CsService et le paramètre Registrar pour retourner une collection de tous les serveurs d’inscriptions actuellement utilisés. La collection est ensuite redirigée vers la cmdlet ForEach-Object qui choisit chaque serveur d’inscriptions dans la collection et exécute la cmdlet Set-CsRegistrar en vue de définir le port SIP sur 5072.
-------------------------- Exemple 3 --------------------------
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com" -EnableAutomaticFailover $True
L’exemple 3 configure à la fois un serveur d’inscriptions de sauvegarde (BackupRegistrar) et un basculement automatique (EnableAutomaticFailover) pour le serveur d’inscriptions Registrar:atl-cs-001.litwareinc.com.