Import-CsConfiguration
Tópico modificado em: 2012-03-23
Importa sua topologia do Microsoft Lync Server 2010, diretivas e configurações para o Repositório de Gerenciamento Central ou para o computador local.
Sintaxe
Import-CsConfiguration -ByteInput <Byte[]> [-Force <SwitchParameter>] [-LocalStore <SwitchParameter>]
Import-CsConfiguration -FileName <String> [-Force <SwitchParameter>] [-LocalStore <SwitchParameter>]
Descrição Detalhada
Computadores executando serviços do Lync Server 2010 ou funções de servidor precisam ter uma cópia da topologia atual, das configurações atuais, das diretivas atuais e assim por diante para que funcionem nas funções designadas. O Lync Server é responsável por garantir que essas informações sejam passadas para todos os computadores que precisarem delas.
Os cmdlets Import-CsConfiguration e Export-CsConfiguration são usados para fazer backup e restaurar sua topologia do Lync Server, suas configurações e diretivas durante uma atualização do Repositório de Gerenciamento Central. Os cmdlets Export-CsConfiguration permitem exportar dados para um arquivo .ZIP; o cmdlet Import-CsConfiguration pode ser usado para ler esse arquivo .ZIP e restaurar a topologia, as configurações e as diretivas para o Repositório de Gerenciamento Central. Depois disso, os serviços de replicação do Lync Server irão replicar as informações restauradas para outros computadores executando serviços.
A capacidade de exportar e importar dados de configuração também é usada na configuração inicial de computadores localizados em sua rede de perímetro (por exemplo, Servidor de Borda). Ao configurar um computador localizado na rede de perímetro, primeiro é necessário realizar uma replicação manual com os cmdlets CsConfiguration: exporte os dados de configuração usando Export-CsConfiguration e em seguida copie o arquivo .ZIP para o computador na rede de perímetro. Depois disso, use Import-CsConfiguration e o parâmetro LocalStore para importar os dados. Você só precisará fazer isso uma vez; desse momento em diante, a replicação vai acontecer automaticamente.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Import-CsConfiguration localmente: RTCUniversalServerAdmins. Além de ser membro de RTCUniversalServerAdmins, você também deve ser um administrador local ou ter permissões de replicador de configurações locais para executar este cmdlet. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
ByteInput |
Opcional |
Matriz de byte |
Lê informações de topologia de uma matriz de byte armazenada em uma variável. Essa matriz de byte é criada com o parâmetro ByteInput ao chamar Export-CsConfiguration. Não é possível usar os parâmetros ByteInput e FileName no mesmo comando. |
FileName |
Opcional |
Cadeia de caracteres |
Caminho para o arquivo .ZIP criado por Export-CsConfiguration. Por exemplo: -FileName "C:\Config.zip". Observe que é necessário incluir o parâmetro FileName ou o parâmetro ByteInput, mas não ambos, ao chamar Import-CsConfiguration. |
Force |
Opcional |
Parâmetros de opção |
Ignora quaisquer prompts que seriam exibidos na ocorrência de um erro não fatal ao executar o comando. Para definir o parâmetro Force como True, use esta sintaxe: -Force:$True |
LocalStore |
Opcional |
Parâmetros de opção |
Copia os dados de configuração para o computador local em vez do Repositório de Gerenciamento Central. |
Tipos de Entrada
Nenhuma. Import-CsConfiguration não aceita entrada em pipeline.
Tipos de Retorno
Import-CsConfiguration não retorna nenhum valor ou objeto.
Exemplo
-------------------------- Exemplo 1 ------------------------
Import-CsConfiguration -FileName "C:\Config.zip"
O comando anterior importa a topologia atual, as configurações e diretivas de um arquivo chamado C:\Config.zip para o Repositório de Gerenciamento Central.
-------------------------- Exemplo 2 ------------------------
Import-CsConfiguration -FileName "C:\Config.zip" -LocalStore
O Exemplo 2 mostra como os dados podem ser inicialmente replicados para um computador localizado na rede do perímetro. Neste exemplo, os dados de configuração foram exportados para um arquivo chamado Config.zip; esse arquivo foi copiado para a pasta C:\ no computador localizado na rede do perímetro. Em seguida, Import-CsConfiguration é usado para importar esses dados, com o parâmetro LocalStore fazendo esses dados serem importados para o computador local em vez do Repositório de Gerenciamento Central.
-------------------------- Exemplo 3 ------------------------
$x = Export-CsConfiguration -AsBytes
Import-CsConfiguration -ByteInput $x -LocalStore
Os dois comandos mostrados no Exemplo 3 exportam a topologia atual, configurações e diretivas, e importam esses dados para o computador local, tudo isso sem usar um arquivo .ZIP. Para isso, o primeiro comando usa Export-CsConfiguration e o parâmetro AsBytes para exportar a topologia atual, configurações e diretivas como matriz de byte; essa matriz de byte é armazenada em uma variável chamada $x. No segundo comando, Import-CsConfiguration e o parâmetro ByteInput são usados para importar as informações armazenadas em $x. O parâmetro LocalStore faz os dados serem importados para o computador local, em vez do Repositório de Gerenciamento Central. O resultado final é a cópia dos dados do Repositório de Gerenciamento Central para o computador local.