Compartir a través de

  • Artículo

Merge-CsLegacyTopology

 

Última modificación del tema: 2012-03-23

Merge-CsLegacyTopology permite migrar la información de topología de Microsoft Office Communications Server 2007 R2 o Microsoft Office Communications Server 2007 a Microsoft Lync Server 2010, lo cual contribuye a proporcionar interoperabilidad entre Lync Server 2010 y las versiones anteriores del software.

Sintaxis

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>]]

Descripción detallada

El cmdlet Merge-CsLegacyTopology es la primera herramienta que se usa al migrar de una versión anterior de Office Communications Server (ya sea Office Communications Server 2007 R2 o Office Communications Server 2007) a Lync Server 2010. Merge-CsLegacyTopology sirve para migrar entradas de servicio de confianza e información de topología relativa a los siguientes componentes: dominios, servicios de usuario, registrador, servidor de mediación y Servidor perimetral. Asimismo, el cmdlet migra entradas de servicio de confianza para el Aplicación de operador de conferencia, Communicator Web Access y los directorios de conferencia. (Una entrada de servicio de confianza es un registro de Active Directory que representa un servidor en el que Lync Server confía). La combinación de la información de topología permite que los usuarios ubicados de Lync Server puedan comunicarse con los usuarios de Communications Server 2007 o Communications Server 2007 R2.

Para poder ejecutar Merge-CsLegacyTopology, primero debe instalar el paquete de interfaces de compatibilidad con versiones anteriores de Windows Management Instrumentation (WMI). Esta aplicación se instala ejecutando OCSWMIBC.msi. (archivo que encontrará en el DVD de instalación). Cuando haya instalado el paquete de interfaces de compatibilidad, podrá llamar a Merge-CsLegacyTopology. Merge-CsLegacyTopology usará WMI para leer datos heredados de la versión anterior de Office Communications Server y, después, tomará los datos recuperados y creará los objetos correspondientes en Lync Server. Por ejemplo, para cada dominio SIP encontrado en su instalación de Office Communications Server se creará un dominio SIP correspondiente en la nueva instalación de Lync Server.

Después de ejecutar Merge-CsLegacyTopology, debería ejecutar los cmdlet Import-CsLegacyConfiguration e Import-CsLegacyConferenceDirectory.

El cmdlet Merge-CsLegacyTopology se debe ejecutar dos veces como mínimo: una al inicio de una migración (a fin de presentar la topología de Communications Server 2007 o Communications Server 2007 R2) y otra al final de la migración, cuando el entorno de Office Communications Server anterior se haya retirado. También será necesario ejecutarlo cada vez que realice un cambio en el entorno de Office Communications Server heredado. Por ejemplo, si agrega un servidor de mediación a la topología de Office Communications Server o bien retira un grupo de ésta, deberá volver a ejecutar Merge-CsLegacyTopology para importar la topología modificada.

Los cmdlet Import-CsLegacyConfiguration e Import-CsLegacyConferenceDirectory dependen de los valores que Merge-CsLegacyTopology haya configurado. Esto quiere decir que es posible que aparezcan mensajes de error de Import-CsLegacyConfiguration o Import-CsLegacyConferenceDirectory en los que se le pide que ejecute Merge-CsLegacyTopology como posible medida para solucionar el problema que acaba de producirse. Si no ejecuta Merge-CsLegacyTopology de nuevo, es probable que surjan más errores, sobre todo si se elimina un elemento del entorno de Office Communications Server cuando todavía está en uso en Lync Server.

Si necesita combinar servidores perimetrales de una instalación anterior de Office Communications Server, deberá crear antes un archivo XML personalizado que contenga el servidor perimetral en cuestión. Deberá crear este archivo usted mismo, debido a que la configuración de servidor perimetral no se almacena en Active Directory y, por lo tanto, Merge-CsLegacyTopology no podrá recuperarlo. Una vez creado este archivo (vea la Guía de implementación de Microsoft Lync Server 2010 para obtener más información al respecto), debe incluir la ruta de acceso a éste en el parámetro UserInputFileName cuando ejecute Merge-CsLegacyTopology. Si no lo hace, no se incluirá ningún servidor perimetral en la topología combinada.

Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Merge-CsLegacyTopology localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Merge-CsLegacyTopology"}

Parámetros

Parámetro Requerido Tipo Descripción

TopologyXmlFileName

Requerido

Cadena de caracteres

Ruta de acceso al archivo de salida que se creará al ejecutar Merge-CsLegacyTopology. Tenga en cuenta que este archivo es diferente del archivo que se especifica con el parámetro Report; éste último se usa para registrar información de errores, mientras que el archivo XML de topología contiene la topología de Lync Server recién creada. A continuación, se usará para publicar la nueva topología.

Si el archivo especificado ya existe, se sobrescribirá al ejecutar Merge-CsLegacyTopology.

UserInputFileName

Opcional

Cadena de caracteres

Ruta de acceso al archivo XML que se usa para importar los datos del Servidor perimetral de una versión anterior de Office Communications Server. El archivo XML (que deberá crear usted mismo siguiendo las indicaciones de la Guía de implementación de Lync Server 2010) es necesario, ya que la configuración del Servidor perimetral no se almacena en Active Directory Domain Services (AD DS). Si no necesita importar información de Servidor perimetral, puede omitir este parámetro.

Si este parámetro no se usa, es probable que las características de acceso externo y remoto (federación incluida) no funcionen del modo previsto en un entorno donde se ejecuten tanto Communications Server 2007 R2 o Communications Server 2007 R2 como Lync Server.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no son graves y que pueden surgir al ejecutar el comando.

Report

Opcional

Cadena de caracteres

Permite especificar la ruta de acceso del archivo de registro que se crea al ejecutarse el cmdlet. Por ejemplo: -Report "C:\Registros\CombinarTopología.html"

Reserved

Opcional

Objeto de topología PS

Le permite combinar la topología usando un objeto de topología en vez de un archivo de topología XML.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Parámetro modificador

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Ninguno. Merge-CsLegacyTopology no acepta entradas transferidas.

Tipos de valores devueltos

Merge-CsLegacyTopology no devuelve ningún objeto ni valor.

Ejemplo

-------------------------- Ejemplo 1 ------------------------

Merge-CsLegacyTopology -TopologyXmlFileName C:\New_Topology.xml

El comando que aparece en el ejemplo 1 combina información de topología y entradas de servicio de confianza de Communications Server 2007 R2 o Communications Server 2007 con una instalación de Lync Server nueva. El parámetro TopologyXmlFileName necesario se usa para indicar la ruta de acceso al archivo de salida que se genera al ejecutar Merge-CsLegacyTopology.

-------------------------- Ejemplo 2 ------------------------

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

El ejemplo 2 es una variante del comando del ejemplo 1. Sin embargo, en el ejemplo 2 se incluye el parámetro UserInputFileName con el propósito de combinar información de servidor perimetral en la topología. El valor de parámetro C:\EdgeServers.xml apunta a un archivo XML personalizado que contiene información de servidor perimetral relativa a Office Communications Server.