Share via

  • Articolo

Merge-CsLegacyTopology

 

Ultima modifica dell'argomento: 2012-03-23

Merge-CsLegacyTopology consente di eseguire la migrazione delle informazioni sulla topologia da Microsoft Office Communications Server 2007 R2 o Microsoft Office Communications Server 2007 a Microsoft Lync Server 2010. In questo modo si ottiene l'interoperabilità tra Lync Server 2010 e le versioni precedenti del software.

Sintassi

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

Descrizione dettagliata

Il cmdlet Merge-CsLegacyTopology è il primo strumento da utilizzare per eseguire la migrazione da una versione precedente di Office Communications Server (Office Communications Server 2007 R2 o Office Communications Server 2007) a Lync Server 2010. Merge-CsLegacyTopology viene utilizzato per eseguire la migrazione delle voci dei servizi trusted e delle informazioni sulla topologia per i seguenti componenti: domini, servizi utente, servizio di registrazione, Mediation Server e Edge Server. Inoltre, il cmdlet consente di eseguire la migrazione delle voci dei servizi trusted per applicazione Operatore Conferenza, Communicator Web Access e le directory delle conferenze. Una voce di servizio trusted è un record di Active Directory che rappresenta un server ritenuto attendibile da Lync Server. L'unione delle informazioni sulla topologia consente agli utenti residenti in Lync Server di comunicare con gli utenti residenti in Communications Server 2007 o Communications Server 2007 R2.

Prima di eseguire Merge-CsLegacyTopology, è necessario installare il pacchetto di interfacce di compatibilità con le versioni precedenti di Strumentazione gestione Windows (WMI). Questa applicazione viene installata eseguendo OCSWMIBC.msi, presente nel DVD di installazione. Dopo avere installato il pacchetto di interfacce di compatibilità, è possibile chiamare Merge-CsLegacyTopology. Merge-CsLegacyTopology utilizza WMI per leggere i dati legacy dalla versione precedente di Office Communications Server. Recupera quindi i dati e crea oggetti corrispondenti in Lync Server. Per ogni dominio SIP individuato nell'installazione di Office Communications Server, viene ad esempio creato un dominio SIP corrispondente nella nuova installazione di Lync Server.

Dopo aver eseguito Merge-CsLegacyTopology è opportuno eseguire i cmdlet Import-CsLegacyConfiguration e Import-CsLegacyConferenceDirectory.

Il cmdlet Merge-CsLegacyTopology deve essere eseguito almeno due volte: una volta all'inizio di una migrazione (per introdurre la topologia di Communications Server 2007 o Communications Server 2007 R2) e una volta alla fine della migrazione, quando per il precedente ambiente Office Communications Server sono state rimosse le autorizzazioni. È inoltre necessario eseguire il cmdlet ogni volta che si apporta una modifica all'ambiente Office Communications Server legacy. Ad esempio, se si aggiunge un Mediation Server o si rimuovono le autorizzazioni per un pool dalla topologia Office Communications Server, è necessario eseguire di nuovo Merge-CsLegacyTopology per importare la topologia modificata.

I cmdlet Import-CsLegacyConfiguration e Import-CsLegacyConferenceDirectory dipendono dai valori configurati da Merge-CsLegacyTopology. Di conseguenza si potrebbero ricevere messaggi di errore da Import-CsLegacyConfiguration o da Import-CsLegacyConferenceDirectory che invitano a eseguire Merge-CsLegacyTopology come possibile soluzione al problema verificatosi. Se non si esegue di nuovo Merge-CsLegacyTopology potrebbero verificarsi ulteriori errori, soprattutto se si rimuove dall'ambiente Office Communications Server un elemento che è ancora in uso in Lync Server.

Per unire Edge Server da una precedente installazione di Office Communications Server è necessario per prima cosa creare un file XML personalizzato contenente l'Edge Server; il file deve essere creato autonomamente perché le impostazioni di Edge Server non sono archiviate in Active Directory e di conseguenza non possono essere recuperate da Merge-CsLegacyTopology. Dopo aver creato questo file XML (vedere la guida alla distribuzione di Microsoft Lync Server 2010 per informazioni sulla creazione del file) è necessario includere il percorso del file e il parametro UserInputFileName durante l'esecuzione di Merge-CsLegacyTopology. Se non si esegue questa operazione, gli Edge Server non saranno inclusi nella topologia unita.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Merge-CsLegacyTopology in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

TopologyXmlFileName

Obbligatorio

Stringa

Percorso del file di output da creare durante l'esecuzione di Merge-CsLegacyTopology. Questo file non corrisponde al file specificato utilizzando il parametro Report; quest'ultimo è utilizzato per la registrazione delle informazioni di errore, mentre il file XML della topologia contiene la topologia di Lync Server appena creata. Questo file sarà utilizzato in seguito per pubblicare la nuova topologia.

Se il file specificato esiste, viene sovrascritto durante l'esecuzione di Merge-CsLegacyTopology.

UserInputFileName

Facoltativo

Stringa

Percorso del file XML utilizzato per importare i dati di Edge Server da una precedente versione di Office Communications Server. Questo file XML (che deve essere creato attenendosi alle linee guida disponibili nella guida alla distribuzione di Lync Server 2010) è necessario in quanto le impostazioni di Edge Server non sono archiviate in Servizi di dominio Active Directory. Se non è necessario importare le informazioni di Edge Server, questo parametro può essere omesso.

Se questo parametro non viene utilizzato, le funzionalità di accesso remoto ed esterno (compresa la federazione) potrebbero non funzionare come previsto in un ambiente in cui sono in esecuzione sia Communications Server 2007 R2 sia Communications Server 2007 R2 e Lync Server.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

Report

Facoltativo

Stringa

Consente di specificare un percorso per il file di registro creato durante l'esecuzione del cmdlet. Ad esempio: -Report "C:\Logs\MergeTopology.html"

Reserved

Facoltativo

Oggetto topologia PS

Consente di unire la topologia utilizzando un oggetto topologia anziché un file XML della topologia.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Nessuno. Merge-CsLegacyTopology non accetta l'input da pipeline.

Tipi restituiti

Merge-CsLegacyTopology non restituisce alcun oggetto o valore.

Esempio

-------------------------- Esempio 1 ------------------------

Merge-CsLegacyTopology -TopologyXmlFileName C:\New_Topology.xml

Con il comando mostrato nell'esempio 1 le informazioni sulla topologia e le voci dei servizi trusted di Communications Server 2007 R2 o Communications Server 2007 vengono unite a una nuova installazione di Lync Server. Il parametro obbligatorio TopologyXmlFileName consente di indicare il percorso del file di output generato durante l'esecuzione di Merge-CsLegacyTopology.

-------------------------- Esempio 2 ------------------------

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

L'esempio 2 rappresenta una variazione del comando utilizzato nell'esempio 1. Con l'esempio 2, viene incluso il parametro UserInputFileName per unire le informazioni degli Edge Server nella topologia. Il valore del parametro C:\EdgeServers.xml punta a un file XML personalizzato contenente le informazioni di Edge Server per Office Communications Server.