Compartilhar via

  • Artigo

Export-CsLisConfiguration

 

Tópico modificado em: 2012-03-23

Exporta uma configuração do Enterprise Voice Enhance 9-1-1 (E9-1-1) para um arquivo em formato compactado para fins de backup.

Sintaxe

Export-CsLisConfiguration -FileName <String>

Export-CsLisConfiguration [-AsBytes <SwitchParameter>]

Descrição Detalhada

A implementação do E9-1-1 em uma organização pode, dependendo do seu tamanho, envolver milhares de mapeamentos de sub-redes, portas, comutadores e pontos de acesso sem fio aos locais. Uma configuração de E9-1-1 também inclui informações sobre os serviços web fornecidos pelo Provedor de roteamento de rede E9-1-1, além dos locais e endereços residenciais, e se foram validados ou não. Dado o volume de informações e definições necessárias para implementar o E9-1-1, é recomendável que se faça backups frequentes de toda a configuração. É possível utilizar esse cmdlet para fazer backups da configuração do E9-1-1 em um arquivo, em que será salva toda a configuração em um formato compactado. Para recuperar a configuração, chame o cmdlet Import-CsLisConfiguration.

Este cmdlet cria um novo arquivo de backup. Ele não irá substituir um arquivo existente. Isto significa que o nome de arquivo que é especificado na chamada do cmdlet não pode ser idêntico ao de um arquivo existente.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Export-CsLisConfiguration 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 "Export-CsLisConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

FileName

Obrigatório

Cadeia de caracteres

O caminho e o nome do arquivo no qual se deseja salvar a configuração. Este não pode ter o nome de um arquivo existente.

Se for fornecido um valor para o parâmetro AsBytes, não será possível fornecer um valor para o parâmetro FileName. Se se estiver acessando este cmdlet remotamente, deve-se utilizar AsBytes em vez de FileName.

AsBytes

Opcional

SwitchParameter

Retorna a configuração como uma matriz de bytes. A saída do comando deve ser atribuída a uma variável para importação futura. (se não se atribuir a saída a uma variável, a matriz de bytes representando a configuração irá rolar para baixo a janela do Shell de Gerenciamento do Lync Server). Não é possível especificar os parâmetros AsBytes e FileName. Em cada chamada a este cmdlet, só é possível utilizar um ou outro.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Quando se utilizar o parâmetro AsBytes, uma matriz de bytes (Byte[]) é retornada.

Exemplo

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

Export-CsLisConfiguration -FileName C:\E911Config.bak

Este exemplo exporta toda a configuração do E9-1-1, do servidor de informações de local (LIS) para o arquivo de backup denominado E911Config.bak.

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

$lisconfig = Export-CsLisConfiguration -AsBytes

Neste exemplo, a configuração LIS é armazenada como uma matriz de bytes em uma variável, $lisconfig.

-------------------------- Exemplo 3 --------------------------

$lisconfig = Export-CsLisConfiguration -AsBytes
$lisconfig | Set-Content -Path C:\E911Config.bak -Encoding byte
Get-Content -ReadCount 0 -Encoding byte -Path C:\E911Config.bak  | Import-CsLisConfiguration

O Exemplo 3 é uma versão mais completa do Exemplo 2. A primeira linha é a mesma. Export-CsLisConfiguration é chamado com o parâmetro AsBytes para armazenar a configuração LIS como uma matriz de bytes na variável $lisconfig. O restante deste exemplo apresenta como salvar a configuração em um arquivo e importá-la de volta para o banco de dados de configurações de local.

Na linha 2, canalizamos o conteúdo de $lisconfig, que é a matriz de bytes representando a configuração LIS, para o cmdlet Windows PowerShell Set-Content Atribuimos valores aos dois parâmetros de Set-Content: Caminho e codificação. Atribuem-se ao parâmetro Path o caminho completo e o nome do arquivo no qual se deseja salvar a configuração. Utiliza-se o parâmetro Encoding com um valor de bytes, para garantir que a configuração seja armazenada como uma matriz de bytes.

Finalmente, na linha 3, a configuração é importada de volta para o banco de dados de configurações de local. Primeiramente, chama-se Get-Content para recuperar o conteúdo do arquivo. Passa-se o valor 0 à propriedade ReadCount, que informa ao Get-Content que leia todo o conteúdo do arquivo de uma vez, em vez de uma linha por vez. Utiliza-se novamente o parâmetro Encoding com um valor de bytes, para especificar que tipo de dados se está lendo no arquivo. Finalmente, passa-se o nome de arquivo ao parâmetro Path. O conteúdo do arquivo que foi lido com Get-Content será canalizado para o cmdlet Import-CsLisConfiguration, que importará a configuração salva no banco de dados de locais.