Export-CsConfiguration
Tópico modificado em: 2012-03-23
Exporta sua topologia do Microsoft Lync Server 2010, diretivas e configurações para um arquivo. Dentre outras coisas, o arquivo pode ser usado para restaurar essas informações para o Repositório de Gerenciamento Central após uma atualização, uma falha de hardware ou outro problema que resulte em perda de dados.
Sintaxe
Export-CsConfiguration -FileName <String> [-Force <SwitchParameter>] [-LocalStore <SwitchParameter>]
Export-CsConfiguration [-AsBytes <SwitchParameter>] [-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 e das diretivas atuais 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 Export-CsConfiguration e Import-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 os serviços do Lync Server.
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, Servidores de Borda). Ao configurar um computador 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 Export-CsConfiguration localmente: RTCUniversalServerAdmins. 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 "Export-CsConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
FileName |
Opcional |
Cadeia de caracteres |
Caminho para o arquivo .ZIP a ser criado na execução de Export-CsConfiguration. Por exemplo: -FileName "C:\Config.zip". Observe que é necessário incluir o parâmetro FileName ou os parâmetros AsBytes, mas não ambos, ao chamar Export-CsConfiguration. |
AsBytes |
Opcional |
Parâmetros de opção |
Retorna informações de topologia como uma matriz de byte; os dados retornados devem ser armazenados em uma variável para serem usados pelo cmdlet Import-CsConfiguration. Não é possível usar AsBytes e FileName no mesmo comando. |
Force |
Opcional |
Parâmetros de opção |
Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando. Para definir o parâmetro Force como True, use esta sintaxe: -Force:$True |
LocalStore |
Opcional |
Parâmetros de Opção |
Obtém os dados de configuração a partir do computador local, e não do Repositório de Gerenciamento Central em si. |
Tipos de Entrada
Nenhuma. Export-CsConfiguration não aceita entrada em pipeline.
Tipos de Retorno
Se chamado com o parâmetro AsBytes, Export-CsConfiguration retorna informações de configuração na forma de uma matriz de byte.
Exemplo
-------------------------- Exemplo 1 --------------------------
Export-CsConfiguration -FileName "C:\Config.zip"
O comando mostrado no Exemplo 1 exporta os dados do Lync Server a partir do Repositório de Gerenciamento Central para um arquivo chamado C:\Config.zip.