Move-CsLegacyUser

 

Dernière rubrique modifiée : 2012-05-21

Migre un ou plusieurs comptes d’utilisateurs depuis Microsoft Office Communications Server 2007 R2 ou Microsoft Office Communications Server 2007 vers Microsoft Lync Server 2010.

Syntaxe

Move-CsLegacyUser -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExcludeArchivingPolicy <SwitchParameter>] [-ExcludeConferencingPolicy <SwitchParameter>] [-ExcludeDialPlan <SwitchParameter>] [-ExcludeExternalAccessPolicy <SwitchParameter>] [-ExcludePresencePolicy <SwitchParameter>] [-ExcludeVoicePolicy <SwitchParameter>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Beaucoup d’organisations qui installent Lync Server 2010 utilisent également une version antérieure du logiciel (soit Office Communications Server 2007 R2, soit Office Communications Server 2007). Heureusement, cette situation ne pose aucun problème : vous pouvez exécuter simultanément la dernière version et une version antérieure du logiciel, puis à échéance, effectuer la migration de vos paramètres de configuration, de vos stratégies et, enfin, de vos comptes d’utilisateurs vers Lync Server 2010.

La cmdlet Move-CsLegacyUser non seulement vous permet de migrer des utilisateurs vers Lync Server 2010 mais vous offre aussi un moyen de contrôle considérable sur le processus de migration. Par exemple, dans sa forme la plus simple, vous pouvez communiquer à la cmdlet Move-CsLegacyUser l’identité de l’utilisateur à migrer et le nom de domaine complet du pool de serveurs d’inscriptions Lync Server 2010 dans lequel le compte d’utilisateur sera hébergé ; à son tour, Move-CsLegacyUser déplacera le compte d’utilisateur et conservera l’ensemble des stratégies et des paramètres existants qui ont été appliqués au compte. Par exemple, supposons qu’un plan de numérotation a été affecté à l’utilisateur Ken Myer dans Office Communications Server. Par défaut, au moment de migrer le compte de Ken, vous migrerez également le plan de numérotation : Move-CsLegacyUser affectera ainsi automatiquement à Ken Myer l’équivalent Lync Server 2010 du plan de numérotation qui lui a été attribué dans Communications Server 2007 R2.

Bien entendu, cette opération aura seulement lieu si vous avez migré les plans de numérotation et s’il existe un équivalent Lync Server 2010 du plan de numérotation affecté à Ken Myer dans Communications Server 2007 R2. Vous pouvez également choisir d’installer Lync Server 2010 sans migrer des plans de numérotation. Dans ce cas, vous pouvez appeler la cmdlet Move-CsLegacyUser avec le paramètre ExcludeDialPlan. Lorsque vous utilisez ce paramètre, les plans de numérotation ne sont pas migrés avec le compte d’utilisateur, ce qui signifie que le compte de l’utilisateur Ken Myer sera déplacé vers Lync Server 2010 mais qu’aucun plan de numérotation lui sera affecté. (Ce sera le cas même si vous n’avez pas migré de plans de numérotation ; le paramètre ExcludeDialPlan empêche l’affectation d’un plan de numérotation à un compte d’utilisateur migré.) D’autres paramètres vous permettent d’exclure des stratégies de voix, des stratégies de conférence, des stratégies d’archivage, des stratégies d’accès externe et/ou des stratégies de présence lorsque vous migrez des comptes d’utilisateurs.

Avant d’exécuter la cmdlet Merge-CsLegacyTopology, vous devez installer le package des interfaces de compatibilité descendante Windows Management Instrumentation (WMI), application installée au moyen du fichier exécutable OCSWMIBC.msi (disponible sur le DVD du programme d’installation, dans le dossier d’installation). Une fois ce package installé, vous pouvez appeler la cmdlet Merge-CsLegacyUser pour déplacer un ou plusieurs comptes d’utilisateurs depuis Communications Server 2007 R2 ou Communications Server 2007 vers Lync Server 2010.

Si vous devez redéplacer un utilisateur de Lync Server vers Office Communications Server, n’utilisez pas la cmdlet Move-CsLegacyUser. À la place, faites appel à la cmdlet Move-CsUser, et utilisez le nom de domaine complet (FQDN) du pool Office Communications Server existant comme valeur pour le paramètre Target Move-CsUser. Par exemple :

Move-CsUser –Identity "Ken Myer" –Target "ocs13.litwareinc.com"

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-CsLegacyUser : 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-CsLegacyUser"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Indique la valeur Identity (identité) du compte d’utilisateur à migrer. 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 des services de domaine 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 « Smith ».

Target

Obligatoire

Chaîne

Nom de domaine complet (FQDN) du pool de serveurs d’inscriptions dans lequel le compte d’utilisateur doit être hébergé. Par exemple : -Target atl-cs-001.litwareinc.com.

DomainController

Facultatif

Chaîne

Permet de vous connecter au contrôleur de domaine spécifié afin de déplacer un compte d’utilisateur. 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).

ExcludeArchivingPolicy

Facultatif

Paramètre de commutateur

Si elles interviennent, toutes les stratégies d’archivage affectées au compte d’utilisateur ne sont pas conservées lors de la migration du compte.

ExcludeConferencingPolicy

Facultatif

Paramètre de commutateur

Si elles interviennent, toutes les stratégies de conférence affectées au compte d’utilisateur ne sont pas conservées lors de la migration du compte.

ExcludeDialPlan

Facultatif

Paramètre de commutateur

S’ils interviennent, tous les plans de numérotation affectés au compte d’utilisateur ne sont pas conservés lors de la migration du compte.

ExcludeExternalAccessPolicy

Facultatif

Paramètre de commutateur

Si elles interviennent, toutes les stratégies d’accès externe affectées au compte d’utilisateur ne sont pas conservées lors de la migration du compte.

ExcludePresencePolicy

Facultatif

Paramètre de commutateur

Si elles interviennent, toutes les stratégies de présence affectées au compte d’utilisateur ne sont pas conservées lors de la migration du compte.

ExcludeVoicePolicy

Facultatif

Paramètre de commutateur

Si elles interviennent, toutes les stratégies de voix affectées au compte d’utilisateur ne sont pas conservées lors de la migration du compte.

ProxyPool

Facultatif

Chaîne

Ce paramètre est utilisé uniquement avec Microsoft Lync Online 2010. Il ne doit pas être utilisé dans le cadre d’une implémentation sur site de Lync Server.

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.

PassThru

Facultatif

Paramètre de commutateur

Vous permet de transférer via le pipeline un objet d’utilisateur représentant l’utilisateur dont le compte a été modifié. Par défaut, la cmdlet Move-CsLegacyUser ne transmet aucun objet par le biais du 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

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

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

Types de retours

Move-CsLegacyUser ne retourne ni valeur, ni objet. Au lieu de cela, la cmdlet modifie les instances de l’objet Microsoft.Rtc.Management.ADConnect.Schema.ADUser object.

Exemple

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

Move-CsLegacyUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com"

Dans l’exemple ci-dessus, la cmdlet Move-CsLegacyUser est utilisée 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. Aucun paramètre supplémentaire n’étant inclus, toutes les stratégies ou tous les paramètres précédemment affectés à ce compte seront également migrés. Ainsi donc, si une stratégie héritée (un plan de numérotation, par exemple) était affectée à Pilar Ackerman, l’équivalent Lync Server 2010 lui sera également attribué au moment de déplacer son compte.

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

Move-CsLegacyUser -Identity "Pilar Ackerman" -Target "atl-cs-001.litwareinc.com" -ExcludeDialPlan 

La commande présentée dans l’exemple 2 migre le compte de l’utilisateur Pilar Ackerman mais aucun plan de numérotation précédemment attribué à ce compte. Après la migration du compte, Pilar ne disposera d’aucun plan de numérotation qui lui est affecté.

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

Get-CsUser -OU "ou=Finance,dc=litwareinc,dc=com" | Move-CsLegacyUser -Target "atl-cs-001.litwareinc.com"

Dans l’exemple 3, tous les comptes d’utilisateurs de l’unité d’organisation (OU) Finance sont déplacés vers le pool de serveurs d’inscriptions Lync Server 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’utilisateurs contenus dans l’unité d’organisation (OU) Finance. Une fois les comptes récupérés, la collection est redirigée vers la cmdlet Move-CsLegacyUser qui déplace chaque compte vers le pool de serveurs d’inscriptions. Cette commande part du principe que tous les utilisateurs dans l’unité d’organisation Finance sont des utilisateurs hérités.

-------------------------- Exemple 4 ------------------------

Get-CsUser -UnassignedUser | Move-CsLegacyUser -Target "atl-cs-001.litwareinc.com"

Dans l’exemple ci-dessus, la cmdlet Move-CsLegacyUser est utilisée pour affecter un pool de serveurs d’inscriptions à toutes les personnes qui utilisent Lync Server mais qui ne sont pas actuellement affectées à un pool de serveurs d’inscriptions. Dans cette commande, la cmdlet Get-CsUser est appelée en premier lieu avec le paramètre UnassignedUser pour retourner une collection de tous les utilisateurs qui ne sont pas actuellement affectés à un pool de serveurs d’inscriptions. Cette collection est ensuite redirigée vers Move-CsLegacyUser qui à son tour affecte chaque utilisateur au pool de serveurs d’inscriptions atl-cs-001.litwareinc.com. Cet exemple part du principe que tous les utilisateurs non affectés sont des utilisateurs hérités.