Merge-CsLegacyTopology

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

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.

Consulte Também

Outros Recursos

Import-CsLegacyConfiguration
Import-CsLegacyConferenceDirectory
Move-CsLegacyUser