• Artigo

Merge-CsLegacyTopology

 

Tópico modificado em: 2012-03-23

Merge-CsLegacyTopology permite transferir informações de topologia do Microsoft Office Communications Server 2007 R2 ou Microsoft Office Communications Server 2007 para o Microsoft Lync Server 2010. Isso ajuda a fornecer a interoperabilidade entre o Lync Server 2010 e as versões anteriores do software.

Sintaxe

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

Descrição Detalhada

O cmdlet Merge-CsLegacyTopology é a primeira ferramenta a ser usada ao efetuar a transferência de uma versão anterior do Office Communications Server (Office Communications Server 2007 R2 ou Office Communications Server 2007) para o Lync Server 2010. Utiliza-se Merge-CsLegacyTopology para transferir entradas de serviço confiável e informações de topologia para os seguintes componentes: domínios, serviços de usuário, Registrador, Servidor de Mediação e Servidor de Borda. Além disso, o cmdlet transfere entradas de serviço confiável para o Aplicativo Atendedor de Conferência, Communicator Web Access e diretórios de conferência. (uma entrada de serviço confiável é um registro do Active Directory que representa um servidor confiável pelo Lync Server.) A mesclagem de informações de topologia permite que os usuários hospedados no Lync Server se comuniquem com os usuários hospedados no Communications Server 2007 ou Communications Server 2007 R2.

Antes de executar Merge-CsLegacyTopology, primeiro instale o pacote de interfaces de Compatibilidade com Versões Anteriores do Windows Management Instrumentation (WMI). Este aplicativo é instalado executando-se o arquivo OCSWMIBC.msi (que pode ser encontrado no DVD de instalação). Depois de instalar o pacote de interfaces de Compatibilidade, pode-se chamar Merge-CsLegacyTopology. Merge-CsLegacyTopology utilizará o WMI para ler dados herdados da versão anterior do Office Communications Server. Em seguida, ele recuperará dados e criará os objetos correspondentes no Lync Server. Por exemplo: para cada domínio SIP encontrado na instalação do Office Communications Server, será criado um domínio SIP correspondente na nova instalação do Lync Server.

Depois de executar Merge-CsLegacyTopology, execute os cmdlets Import-CsLegacyConfiguration e Import-CsLegacyConferenceDirectory.

O cmdlet Merge-CsLegacyTopology precisa ser executado no mínimo duas vezes: uma vez no início da uma transferência (para inserir a topologia do Communications Server 2007 ou Communications Server 2007 R2) e outra vez no final da transferência, quando o ambiente anterior do Office Communications Server tiver sido desativado. Também será necessário executar o cmdlet sempre que for realizada uma alteração no ambiente herdado do Office Communications Server. Por exemplo: se um Servidor de Mediação for adicionado ou um pool for desativado na topologia do Office Communications Server, será necessário executar novamente Merge-CsLegacyTopology, para importar a topologia modificada.

Os cmdlets Import-CsLegacyConfiguration e Import-CsLegacyConferenceDirectory dependem de valores configurados por Merge-CsLegacyTopology. Isso significa que é possível receber mensagens de erro de Import-CsLegacyConfiguration ou Import-CsLegacyConferenceDirectory, que o orientarão a executar Merge-CsLegacyTopology como uma possível solução para o problema ocorrido. Se o cmdlet Merge-CsLegacyTopology não for executado novamente, é possível que ocorram erros adicionais, especialmente se um item for removido do ambiente do Office Communications Server enquanto ainda estiver em uso pelo Lync Server.

Se for necessário mesclar Servidores de borda de uma instalação anterior do Office Communications Server, crie primeiramente um arquivo XML personalizado que contenha o Servidor de Borda; crie o arquivo você mesmo, porque as configurações do Servidor de borda não serão armazenadas no Active Directory e, como resultado, não poderão ser recuperadas por Merge-CsLegacyTopology. Depois de criar este arquivo XML (consulte o Guia de Implantação do Microsoft Lync Server 2010, para obter informações sobre como criar este arquivo), inclua o caminho até o arquivo e o parâmetro UserInputFileName, ao executar Merge-CsLegacyTopology. Do contrário, nenhum Servidor de borda será incluído na topologia mesclada.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Merge-CsLegacyTopology localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

TopologyXmlFileName

Obrigatório

Cadeia de caracteres

Caminho do arquivo de saída a ser criado quando Merge-CsLegacyTopology for executado. Observe que este arquivo difere do arquivo especificado ao se utilizar o parâmetro Report. Este arquivo é utilizado para registrar informações de erro, enquanto o arquivo Topology XML contém a nova topologia do Lync Server recém-criada. Mais tarde, este arquivo será usado para publicar a nova topologia.

Se o arquivo especificado já existir, ele será sobrescrito quando se executar Merge-CsLegacyTopology.

UserInputFileName

Opcional

Cadeia de caracteres

Caminho até o arquivo XML usado para importar dados da Servidor de Borda de uma versão anterior do Office Communications Server. Este arquivo XML (que deve ser criado seguindo as orientações detalhadas no Guia de Implantação do Lync Server 2010) é obrigatório porque as definições do Servidor de Borda não são armazenadas no Serviços de Domínio Active Directory (AD DS). Se não for necessário importar informações do Servidor de Borda, é possível omitir este parâmetro.

Se este parâmetro não for usado, é possível que os recursos de acesso remoto e externo (incluindo federação) não funcionem conforme o esperado em um ambiente onde estejam sendo executados Communications Server 2007 R2 ou Communications Server 2007 R2 e Lync Server.

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

Report

Opcional

Cadeia de caracteres

Permite especificar o caminho do arquivo de log criado ao se executar o cmdlet. Por exemplo: -Report "C:\Logs\MergeTopology.html"

Reserved

Opcional

Objeto de topologia PS

Permite que você mescle a topologia usando um objeto de topologia em vez de um arquivo XML de topologia.

WhatIf

Opcional

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Nenhuma. Merge-CsLegacyTopology não aceita entradas canalizadas.

Tipos de Retorno

Merge-CsLegacyTopology não retorna qualquer objeto ou valor.

Exemplo

-------------------------- Exemplo 1 ------------------------

Merge-CsLegacyTopology -TopologyXmlFileName C:\New_Topology.xml

O comando mostrado no Exemplo 1 mescla informações de topologia e entradas de serviços confiáveis do Communications Server 2007 R2 ou Communications Server 2007 com uma nova instalação do Lync Server. O parâmetro obrigatório TopologyXmlFileName é utilizado para indicar o caminho do arquivo de saída gerado quando se executa Merge-CsLegacyTopology.

-------------------------- Exemplo 2 ------------------------

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

O Exemplo 2 é uma variação do comando usado no Exemplo 1. No Exemplo 2, no entanto, o parâmetro UserInputFileName é incluído para mesclar informações do Servidor de borda na topologia. O valor do parâmetro C:\EdgeServers.xml aponta para um arquivo XML personalizado que contém informações do Servidor de borda correspondente ao Office Communications Server.