Condividi tramite

  • Articolo

Import-CsLegacyConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Import-CsLegacyConfiguration consente di importare numerose impostazioni di configurazione da Microsoft Office Communications Server 2007 R2 o Microsoft Office Communications Server 2007 in Microsoft Lync Server 2010. In questo modo viene garantita l'interoperabilità tra Lync Server 2010 e l'installazione precedente di Office Communications Server 2007 R2 o Office Communications Server 2007.

Sintassi

Import-CsLegacyConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-ReplaceExisting <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Import-CsLegacyConfiguration viene utilizzato insieme al cmdlet Merge-CsLegacyTopology per consentire alle organizzazioni di 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. Import-CsLegacyConfiguration viene utilizzato per importare i criteri vocali, i profili località (ad esempio i dial plan), le route vocali, le regole di normalizzazione vocale, i criteri riunione, i criteri di accesso esterno, i criteri di archiviazione, i criteri di presenza, le impostazioni degli URL di Communicator Web Access e i numeri di accesso alle conferenze telefoniche con accesso esterno.

Prima di eseguire Import-CsLegacyConfiguration, è necessario installare il pacchetto di interfacce per la compatibilità con le versioni precedenti di Strumentazione gestione Windows (WMI). Questa applicazione viene installata eseguendo OCSWMIBC.msi. Dopo aver installato il pacchetto di interfacce per la compatibilità, eseguire Merge-CsLegacyTopology. Dopo aver eseguito Merge-CsLegacyTopology, utilizzare Generatore di topologie per pubblicare la topologia unita. Una volta pubblicata la topologia unita, è possibile chiamare Import-CsLegacyConfiguration. Il cmdlet Import-CsLegacyConfiguration utilizza WMI per leggere i dati legacy dalla versione precedente di Office Communications Server. Import-CsLegacyConfiguration utilizza quindi i dati recuperati e crea gli oggetti corrispondenti in Lync Server. Per ciascuno dei criteri vocali rilevati nell'installazione di Office Communications Server, viene ad esempio creato un criterio vocale corrispondente nella nuova installazione di Lync Server.

È consigliabile rieseguire Import-CsLegacyConfiguration ogni volta che si apportano modifiche a uno dei seguenti elementi di Office Communications Server: criteri vocali, profili località, route vocali, regole di normalizzazione vocale, criteri riunione, criteri di accesso esterno, criteri di archiviazione, criteri di presenza, impostazioni degli URL di Communicator Web Access e numeri di accesso alle conferenze telefoniche con accesso esterno. Per impostazione predefinita, quando si riesegue Import-CsLegacyConfiguration vengono importati solo i nuovi elementi aggiunti alla topologia di Office Communications Server. Per importare gli oggetti modificati, è necessario effettuare due operazioni. Verificare innanzitutto che non siano state apportate modifiche nell'elemento corrispondente, ad esempio un criterio vocale, nella copia di Lync Server della configurazione. Eseguire quindi Import-CsLegacyConfiguration con il parametro ReplaceExisting. In questo modo Import-CsLegacyConfiguration importerà gli oggetti modificati e sovrascriverà l'oggetto corrispondente attualmente presente in Lync Server. Gli oggetti eliminati dalla topologia di Communications Server 2007 R2 non risultano nelle eliminazioni corrispondenti in Lync Server. Sarà necessario pertanto rimuoverli manualmente in Lync Server.

È importante sapere che Move-CsLegacyUser si basa sulle informazioni importate da Import-CsLegacyConfiguration. Quando si esegue Move-CsLegacyUser, è possibile pertanto che venga visualizzato un messaggio di errore in cui viene indicato che è necessario eseguire Import-CsLegacyConfiguration prima di continuare. In questo caso, sarà necessario rieseguire Import-CsLegacyConfiguration per poter spostare l'utente legacy.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Import-CsLegacyConfiguration i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsLegacyConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

ReplaceExisting

Facoltativo

Parametro opzionale

Se presente, questo parametro indica a Import-CsLegacyConfiguration di sovrascrivere eventuali impostazioni o criteri precedentemente importati che sono stati modificati rispetto all'ultima volta che è stato eseguito il cmdlet.

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\ImportConfiguration.html"

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. Import-CsLegacyConfiguration non accetta l'input da pipeline.

Tipi restituiti

Import-CsLegacyConfiguration non restituisce alcun oggetto o valore.

Esempio

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

Import-CsLegacyConfiguration

Il comando riportato nell'esempio 1 unisce i criteri vocali e altre impostazioni di Communications Server 2007 o Communications Server 2007 R2 con un'installazione di Lync Server.

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

Import-CsLegacyConfiguration -ReplaceExisting

Il comando riportato nell'esempio 2 è una variante del comando illustrato nell'esempio 1. In questo caso tuttavia è incluso il parametro ReplaceExisting. Questo parametro indica al cmdlet di utilizzare i dati importati per risolvere conflitti di nomi. Ad esempio, si supponga di provare a importare una route vocale denominata LocalRoute e che nell'installazione Lync Server in uso esista già una route vocale con lo stesso nome. Poiché si è incluso il parametro ReplaceExisting, la route di Lync Server verrà sostituita dalla route vocale importata.