Partager via

  • Article

Merge-CsLegacyTopology

 

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

Merge-CsLegacyTopology vous permet de migrer les informations de topologie depuis Microsoft Office Communications Server 2007 R2 ou Microsoft Office Communications Server 2007 vers Microsoft Lync Server 2010. Cette action garantit l’interopérabilité entre Lync Server 2010 et les versions logicielles antérieures.

Syntaxe

Merge-CsLegacyTopology -TopologyXmlFileName <String> [-UserInputFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Merge-CsLegacyTopology -Reserved <PSObject> [-UserInputFileName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Merge-CsLegacyTopology est le premier outil utilisé pour migrer depuis une version antérieure d’Office Communications Server (Office Communications Server 2007 R2 ou Office Communications Server 2007) vers Lync Server 2010. Merge-CsLegacyTopology s’utilise pour migrer des entrées de service et des informations de topologie pour les composants suivants : domaines, services utilisateur, serveur d’inscriptions, serveur de médiation et serveur Edge. De plus, la cmdlet migre des entrées de service de confiance pour l’application Intendant Conférence, Communicator Web Access et les annuaires de conférence. (Une entrée de service de confiance est un enregistrement Active Directory qui représente un serveur auquel Lync Server fait confiance.) La fusion des informations de topologie permet aux utilisateurs hébergés sur Lync Server de communiquer avec les utilisateurs hébergés sur Communications Server 2007 ou Communications Server 2007 R2.

Avant d’exécuter Merge-CsLegacyTopology, vous devez d’abord installer le package d’interfaces de compatibilité descendante WMI (Windows Management Instrumentation). Cette application s’installe en exécutant OCSWMIBC.msi, qui se trouve sur le DVD d’installation. Une fois le package d’interfaces de compatibilité installé, Merge-CsLegacyTopology peut-être appelé. Merge-CsLegacyTopology utilise les données WMI pour lire les données héritées de l’ancienne version d’Office Communications Server. Les données sont ensuite récupérées et les objets correspondants créés dans Lync Server. Par exemple, pour chaque domaine SIP trouvé sur votre installation d’Office Communications Server, un domaine SIP correspondant sera créé dans votre nouvelle installation de Lync Server.

Après avoir exécuté Merge-CsLegacyTopology, vous devez exécuter les cmdlets Import-CsLegacyConfiguration et Import-CsLegacyConferenceDirectory.

La cmdlet Merge-CsLegacyTopology doit être exécutée au moins deux fois : une fois au début d’une migration (afin d’introduire la topologie Communications Server 2007 ou Communications Server 2007 R2) et une fois à la fin de la migration, quand l’environnement Office Communications Server précédent est hors service. Vous devrez également exécuter la cmdlet chaque fois que vous effectuez un changement dans votre environnement Office Communications Server hérité. Ainsi, si vous ajoutez un serveur de médiation afin de désactiver un pool de votre topologie Office Communications Server, vous devez exécuter de nouveau Merge-CsLegacyTopology pour importer la topologie modifiée.

Les cmdlets Import-CsLegacyConfiguration et Import-CsLegacyConferenceDirectory dépendent des valeurs configurées par Merge-CsLegacyTopology. Cela signifie que vous pouvez recevoir des messages d’erreur de Import-CsLegacyConfiguration ou Import-CsLegacyConferenceDirectory vous invitant à exécuter Merge-CsLegacyTopology comme solution possible au problème qui vient de se produire. Si vous n’exécutez pas de nouveau Merge-CsLegacyTopology, d’autres erreurs pourront se produire, notamment quand un élément est ôté de l’environnement Office Communications Server alors qu’il est encore utilisé par Lync Server.

Si vous devez fusionner des serveurs Edge à partir d’une installation antérieure de Office Communications Server, vous devez d’abord créer un fichier XML personnalisé contenant votre serveur Edge. Vous devez créer le fichier vous-même, car les paramètres du serveur Edge ne sont pas stockés dans Active Directory et ne peuvent donc pas être retournés par Merge-CsLegacyTopology. Une fois le fichier XML créé (voir pour cela le Guide de déploiement Microsoft Lync Server 2010 pour de plus amples informations), vous devez inclure le chemin vers ce fichier et le paramètre UserInputFileName lors de l’exécution de Merge-CsLegacyTopology. À défaut, aucun serveur Edge ne sera inclus dans votre topologie fusionnée.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Merge-CsLegacyTopology : 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 "Merge-CsLegacyTopology"}

Paramètres

Paramètre Obligatoire Type Description

TopologyXmlFileName

Obligatoire

Chaîne

Chemin du fichier de sortie à créer lors de l’exécution de Merge-CsLegacyTopology. Notez que ce fichier diffère du fichier spécifié à l’aide du paramètre Report. Ce dernier est utilisé pour enregistrer l’information d’erreur alors que le fichier de topologie XML contient la nouvelle topologie Lync Server. Ce fichier sera ensuite utilisé pour publier la nouvelle topologie.

Si le fichier spécifié existe déjà, il sera supprimé quand vous exécuterez Merge-CsLegacyTopology.

UserInputFileName

Facultatif

Chaîne

Chemin vers le fichier XML utilisé pour importer les données du serveur Edge à partir d’une version antérieure d’Office Communications Server. Ce fichier XML (que vous devez créer vous-même en respectant les directives du Guide de déploiement Lync Server 2010) est obligatoire étant donné que les paramètres du serveur Edge ne sont pas enregistrés dans les services de domaine Active Directory (AD DS). Si vous n’avez pas besoin d’importer des informations pour le serveur Edge, vous pouvez ignorer ce paramètre.

Si ce paramètre n’est pas utilisé, les fonctionnalités d’accès à distance et d’accès externe (y compris la fédération) pourront ne pas fonctionner comme prévu dans un environnement exécutant Communications Server 2007 R2 ou Communications Server 2007 R2 et 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.

Report

Facultatif

Chaîne

Permet de spécifier un chemin d’accès au fichier journal créé lors de l’exécution de la cmdlet. Par exemple : -Rapport « C:\Logs\MergeTopology.html »

Reserved

Facultatif

Objet de topologie PS

Vous permet de fusionner la topologie à l’aide d’un objet de topologie au lieu d’un fichier XML de topologie.

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. Merge-CsLegacyTopology n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Merge-CsLegacyTopology ne retourne ni valeur ni objet.

Exemple

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

Merge-CsLegacyTopology -TopologyXmlFileName C:\New_Topology.xml

La commande illustrée à l’exemple 1 fusionne les informations de topologie et les entrées du service de confiance obtenus auprès de Communications Server 2007 R2 ou Communications Server 2007, avec une nouvelle installation de Lync Server. Le paramètre obligatoire TopologyXmlFileName est utilisé pour indiquer le chemin vers le fichier de sortie généré quand vous exécutez Merge-CsLegacyTopology.

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

Merge-CsLegacyTopology -TopologyXmlFileName C:\New_Topology.xml -UserInputFileName C:\EdgeServers.xml

L’exemple 2 est une variante de la commande illustrée dans l’exemple 1. Dans l’exemple 2 toutefois, le paramètre UserInputFileName est inclus afin de fusionner les informations du serveur Edge dans la topologie. La valeur du paramètre C:\EdgeServers.xml pointe sur un fichier XML personnalisé contenant les informations du serveur Edge pour Office Communications Server.