• Artigo

Import-CsLegacyConfiguration

 

Tópico modificado em: 2012-03-23

Import-CsLegacyConfiguration permite importar algumas definições de configuração 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 Lync Server 2010 e a instalação anterior do Office Communications Server 2007 R2 ou Office Communications Server 2007.

Sintaxe

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

Descrição Detalhada

Import-CsLegacyConfiguration é usado em conjunto com o cmdlet Merge-CsLegacyTopology para permitir que as organizações atualizem uma versão anterior do Office Communications Server (Office Communications Server 2007 R2 ou Office Communications Server 2007) para o Lync Server 2010. Import-CsLegacyConfiguration é usado para importar políticas de voz, prefis de local (planos de discagem, por exemplo), rotas de voz, regras de normalização de voz, políticas de reuniões, políticas de acesso externo, políticas de arquivamento, políticas de presença, definições de URL do Communicator Web Access e números de acesso de conferência discada.

Antes de executar o Import-CsLegacyConfiguration, é necessário instalar primeiro o pacote de interfaces de Compatibilidade com Versões Anteriores da Instrumentação de Gerenciamento do Windows (WMI). Esse aplicativo é instalado executando o OCSWMIBC.msi. Após a instalação do pacote de interfaces de Compatibilidade, é necessário executar Merge-CsLegacyTopology. Quando Merge-CsLegacyTopology é encerrado, é necessário publicar a topologia mesclada usando Construtor de Topologias. Depois de publicar a topologia mesclada, será possível chamar Import-CsLegacyConfiguration. O cmdlet Import-CsLegacyConfiguration usa o WMI para ler os dados herdados da versão anterior do Office Communications Server. Import-CsLegacyConfiguration utiliza então os dados recuperados e cria objetos correspondentes no Lync Server. Por exemplo: para cada política de voz encontrada na instalação do Office Communications Server, será criada uma política de voz correspondente na nova instalação do Lync Server.

Import-CsLegacyConfiguration deve ser executado novamente, sempre que se fizerem alterações em qualquer um dos itens do Office Communications Server: políticas de voz, prefis de local, rotas de voz, regras de normalização de voz, políticas de reuniões, políticas de acesso externo, políticas de arquivamento, políticas de presença, definições de URL do Communicator Web Access e números de acesso à conferência discada. Por padrão, serão importados apenas os novos itens adicionados à topologia do Office Communications Server ao se executar novamente Import-CsLegacyConfiguration. Para importar objetos modificados, é necessário cumprir duas etapas. Primeiramente, confirme se não foram feitas alterações ao item correspondente (uma política de voz, por exemplo) na cópia do Lync Server da configuração. Em seguida, execute Import-CsLegacyConfiguration, juntamente com o parâmetro ReplaceExisting; isso faz com que Import-CsLegacyConfiguration importe objetos modificados e substitua o objeto correspondente que estiver no Lync Server. Observe que os objetos excluídos da topologia do Communications Server 2007 R2 não ocasionarão exclusões correspondentes no Lync Server. É necessário removê-los manualmente no Lync Server.

É importante saber que o cmdlet Move-CsLegacyUser se baseia em informações importadas pelo Import-CsLegacyConfiguration. Isso significa que, ao se executar Move-CsLegacyUser, é possível que se receba uma menaagem de erro informando que é necessário executar Import-CsLegacyConfiguration antes de prosseguir. Caso isso ocorra, é necessário executar novamente Import-CsLegacyConfiguration antes de transferir o usuário antigo.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Import-CsLegacyConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

ReplaceExisting

Opcional

Parâmetro de opção

Se houver, esse parâmetro instrui o Import-CsLegacyConfiguration a substituir qualquer política ou definição previamente importada que tiver sido alterada desde a última vez em que o cmdlet foi executado.

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 quando o cmdlet for executado. Por exemplo: -Report "C:\Logs\ImportConfiguration.html"

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. Import-CsLegacyConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Import-CsLegacyConfiguration não retorna qualquer objeto ou valor.

Exemplo

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

Import-CsLegacyConfiguration

O comando exibido no Exemplo 1 combina políticas de voz e outras definições do Communications Server 2007 ou Communications Server 2007 R2 com uma instalação do Lync Server.

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

Import-CsLegacyConfiguration -ReplaceExisting

O comando exibido no Exemplo 2 é uma variação do comando exibido no Exemplo 1. No entanto, neste caso, inclui-se o parâmetro ReplaceExisting. Esse parâmetro instrui o cmdlet a usar os dados importados para solucionar conflitos de nome. Por exemplo, suponhamos que se tente importar uma rota de voz denominada LocalRoute, que corresponde a uma rota de voz com o mesmo nome, já existente na instalação do Lync Server. Como já se incluiu o parâmetro ReplaceExisting, a rota do Lync Server será substituída pela rota de voz que estiver sendo importada.