Set-CsUserServer
Dernière rubrique modifiée : 2012-04-23
Permet de modifier un pool existant de services d’utilisateurs. Entre autres choses, le pool de services d’utilisateurs fournit des informations de présence et facilite la gestion des conférences.
Syntaxe
Set-CsUserServer [-Identity <XdsGlobalRelativeIdentity>] [-ConferenceServer <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-McuFactorySipPort <UInt16>] [-UserDatabase <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Le module Services d’utilisateurs est un composant générique qui joue plusieurs rôles Microsoft Lync Server 2010 clés. Il fournit notamment des informations de présence, aide à gérer les conférences (via le focus et le planificateur de focus), gère les autorisations des utilisateurs et le routage des données au niveau de ces derniers et sert de principale interface pour la base de données principale. Les services d’utilisateurs contribuent également à la mise en service des comptes des utilisateurs.
C’est pourquoi il est important pour les administrateurs de connaître la configuration exacte de leurs pools de services d’utilisateurs et, si nécessaire, d’y apporter des modifications. Vous pouvez récupérer des informations sur les pools de services d’utilisateurs à l’aide de la commande suivante :
Get-CsService -UserServer
De même, la cmdlet Set-CsUserServer permet d’apporter des modifications à ces pools. Grâce à la cmdlet Set-CsUserServer, les administrateurs peuvent modifier la base de données des utilisateurs et/ou le serveur de conférence associé à un pool. La cmdlet vous permet également de modifier le port employé pour les connexions avec le planificateur de focus.
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-CsUserServer : 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-CsUserServer"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique du pool de services d’utilisateurs à modifier. Par exemple : -Identity "UserServer:atl-cs-001.litwareinc.com". Notez que vous pouvez supprimer le préfixe « UserServer: » lorsque vous spécifiez un serveur User Server. Par exemple : -Identity "atl-cs-001.litwareinc.com". |
ConferenceServer |
Facultatif |
Chaîne |
ID de service du serveur de conférence associé au pool de services d’utilisateurs. Par exemple : -ConferenceServer "ConferenceServer:atl-cs-001.litwareinc.com". |
McuFactorySipPort |
Facultatif |
Entier |
Port utilisé pour la connexion au planificateur de focus (McuFactory). Le planificateur de focus alloue des unités de contrôle de média (MCU) dans le but d’ajouter des types de média spécifiques (comme l’audio) à des conférences. |
UserDatabase |
Facultatif |
Chaîne |
ID de service de la base de données utilisateur associé au pool de services d’utilisateurs. Par exemple : -UserDatabase "UserDatabase: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-CsUserServer n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Set-CsUserServer ne retourne ni objet ni valeur. Au lieu de cela, la cmdlet modifie les instances existantes de l’objet Microsoft.Rtc.Management.Xds.DisplayUserServer.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsUserServer -Identity "UserServer:atl-cs-001.litwareinc.com" -McuFactorySipPort 445
La commande présentée dans l’exemple 1 modifie la valeur McuFactorySipPort pour un seul pool de services d’utilisateurs : il s’agit du pool dont le paramètre Identity est UserServer:atl-cs-001.litwareinc.com Dans cet exemple, le port est redéfini sur le port 445.
-------------------------- Exemple 2 ------------------------
Get-CsService -UserServer | ForEach-Object {Set-CsUserServer -Identity $_.Identity -McuFactorySipPort 445}
La commande présentée dans l’exemple 2 est une variante de la commande dévoilée dans l’exemple 1. Dans ce cas, en revanche, la valeur McuFactorySipPort est modifiée pour tous les pools de services d’utilisateurs de l’organisation. Pour ce faire, la commande utilise d’abord la cmdlet Get-CsService et le paramètre UserServer pour retourner une collection de tous les pools de services d’utilisateurs en cours d’utilisation. Cette collection est ensuite redirigée vers la cmdlet ForEach-Object qui extrait chaque pool de la collection et définit McuFactorySipPort sur 445. Les données doivent être redirigées vers ForEach-Object car la cmdlet Set-CsUserServer elle-même ne peut pas accepter de données transmises via le pipeline.