Move-CsUser
Dernière rubrique modifiée : 2012-03-23
Déplace un ou plusieurs comptes d’utilisateur activés pour Microsoft Lync Server 2010 vers un nouveau pool de serveurs d’inscriptions.
Syntaxe
Move-CsUser -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet Move-CsUser vous permet de déplacer un compte d’utilisateur activé pour Lync Server 2010 d’un pool de serveurs d’inscriptions à un autre. Move-CsUser n’affecte que l’emplacement du compte Lync Server, mais ne déplace pas le compte Active Directory de l’utilisateur vers une nouvelle unité d’organisation (OU) ou un nouvel emplacement.
Si Lync Server coexiste avec Office Communications Server 2007 R2 ou Office Communications Server 2007, alors la cmdlet Move-CsUser peut servir à ramener un utilisateur de Lync Server à l’ancienne installation de Office Communications Server. Pour ramener un utilisateur à Office Communications Server, affectez le nom de domaine complet (FQDN) de l’ancien pool au paramètre Target. Si vous faites cela, gardez à l’esprit que les utilisateurs ramenés à Office Communications Server connaîtront probablement une perte de données ou de fonctionnalités. Ceci est dû au fait que Lync Server comporte des fonctionnalités bien plus nombreuses que Office Communications Server 2007 ou Office Communications Server 2007 R2. Les utilisateurs ramenés à une version antérieure pourraient également devoir installer les versions précédentes de leur logiciel client et replanifier les rendez-vous créés lorsque leurs comptes d’utilisateur étaient hébergés sur Lync Server.
Pour ramener des utilisateurs de Communications Server 2007 ou Communications Server 2007 R2 à Lync Server, utilisez la cmdlet Move-CsLegacyUser. Move-CsUser est conçue pour déplacer des utilisateurs d’un pool Lync Server à un autre pool Lync Server, ou pour déplacer un utilisateur d’un pool Lync Server à un pool Office Communications Server. Move-CsLegacyUser déplace des utilisateurs de Office Communications Server vers Lync Server.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Move-CsUser : RTCUniversalUserAdmins. 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 "Move-CsUser"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Paramètre ID utilisateur |
Indique l’identité du compte d’utilisateur à déplacer. Les identités utilisateur peuvent être spécifiées dans l’un des quatre formats suivants : 1) L’adresse SIP de l’utilisateur ; 2) Le nom d’utilisateur principal de l’utilisateur ; 3) Le nom de domaine et le nom d’ouverture de session de l’utilisateur, sous la forme domaine\ouverture de session (par exemple, litwareinc\kenmyer) ; et 4) Le nom complet Active Directory de l’utilisateur (par exemple, Ken Myer). Les identités utilisateur peuvent être référencées à l’aide d’un nom unique Active Directory. Vous pouvez recourir à l’astérisque (caractère générique *) si vous utilisez le nom complet comme identité utilisateur. Par exemple, l’identité « * Smith » retourne tous les utilisateurs dont le nom complet se termine par la valeur de chaîne « Smith ». |
Target |
Obligatoire |
FQDN |
Nom de domaine complet (par exemple, atl-cs-001.litwareinc.com) du pool de serveurs d’inscriptions vers lequel le compte d’utilisateur doit être déplacé. En plus du pool de serveurs d’inscriptions, la cible peut également être le nom complet d’un ancien fournisseur d’hébergement ou serveur frontal Office Communications Server. Tout compte déplacé vers un fournisseur d’hébergement (par exemple, Microsoft Lync Online 2010) perd toutes ses données utilisateur associées. Par exemple, les conférences auxquelles l’utilisateur a prévu d’assister seront supprimées et ne seront pas disponibles dans Lync Online 2010. |
DomainController |
Facultatif |
Chaîne |
Vous permet de vous connecter à un contrôleur de domaine défini, afin de récupérer des informations de contact. Pour vous connecter à un contrôleur de domaine spécifique, incluez le paramètre DomainController suivi du nom de l’ordinateur (par exemple, atl-cs-001) ou de son nom de domaine complet (par exemple, atl-cs-001.litwareinc.com). |
ProxyPool |
Facultatif |
Chaîne |
Ce paramètre est utilisé uniquement pour Microsoft Lync Online 2010. Il ne doit pas être utilisé avec une implémentation locale de Lync Server. |
Force |
Facultatif |
Paramètre de commutateur |
S’il est présent, il déplace le compte d’utilisateur, mais supprime toutes les données associées (telles que les conférences planifiées par l’utilisateur). S’il est absent, à la fois le compte et les données associées sont déplacés. |
PassThru |
Facultatif |
Paramètre de commutateur |
Vous permet de transférer un objet d’utilisateur représentant l’utilisateur dont le compte a été modifié par le pipeline. Par défaut, la cmdlet Move-CsUser ne transmet aucun objet via le pipeline. |
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 |
Permet d’ignorer l’invite de confirmation qui s’affiche normalement lorsque vous essayez de déplacer un utilisateur. Pour ignorer l’invite de confirmation, incluez le paramètre Confirm avec la syntaxe suivante : -Confirm:$False Si vous préférez avoir l’invite de confirmation, utilisez plutôt la syntaxe suivante : -Confirm |
Types d’entrées
Objet String ou Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Move-CsUser accepte une valeur de chaîne transmise via le pipeline représentant l’identité d’un compte d’utilisateur qui a été activé pour Lync Server. La cmdlet accepte également les instances redirigées de l’objet utilisateur Active Directory.
Types de retours
Move-CsUser ne retourne ni valeur ni objet. Au lieu de cela, la cmdlet modifie les instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.ADUser.
Exemple
-------------------------- Exemple 1 --------------------------
Move-CsUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com"
Dans l’exemple précédent, Move-CsUser a été utilisé pour déplacer le compte d’utilisateur dont l’identité est Pilar Ackerman vers le pool de serveurs d’inscriptions atl-cs-001.litwareinc.com.
-------------------------- Exemple 2 --------------------------
Get-CsUser -OU "ou=Finance,dc=litwareinc,dc=com" | Move-CsUser -Target "atl-cs-001.litwareinc.com"
Dans l’exemple 2, tous les comptes d’utilisateur de l’unité d’organisation (OU) Finance sont déplacés vers le pool de serveurs d’inscriptions atl-cs-001.litwareinc.com. Pour effectuer cette tâche, la commande utilise d’abord Get-CsUser, puis le paramètre OU, pour récupérer une collection de tous les comptes d’utilisateur contenus dans l’unité d’organisation (OU) Finance. Une fois que les données ont été récupérées, les informations sont redirigées vers Move-CsUser qui déplace chaque compte de la collection vers le serveur d’inscriptions atl-cs-001.litwareinc.com.
-------------------------- Exemple 3 --------------------------
Move-CsUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com" -Force
Dans l’exemple précédent, Move-CsUser a été utilisé pour déplacer le compte d’utilisateur dont l’identité est Pilar Ackerman vers le pool de serveurs d’inscriptions atl-cs-001.litwareinc.com. En outre, le paramètre Force permet de s’assurer que seul le compte sera déplacé. Les données utilisateur associées à ce compte (comme les conférences planifiées par Pilar) ne seront pas déplacées, mais plutôt ignorées. Le paramètre Force doit être utilisé uniquement si vous avez essayé d’appeler Move-CsUser sans le paramètre et que ce déplacement a échoué.