Compartilhar via

  • Artigo

Import-CsLisConfiguration

 

Tópico modificado em: 2012-03-23

Importa uma configuração do Enterprise Voice Enhanced 9-1-1 (E9-1-1) de um arquivo de backup.

Sintaxe

Import-CsLisConfiguration -FileName <String>

Import-CsLisConfiguration -ByteInput <Byte[]>

Descrição Detalhada

A implementação do E9-1-1 em uma organização pode, dependendo do seu tamanho, envolver o mapeamento de milhares de sub-redes, portas, comutadores e pontos de acesso sem fio aos locais. Uma configuração do E9-1-1 também inclui informações sobre o Servidor de informações de localização (LIS) fornecidas 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, é altamente recomendável que se faça backups frequentes de toda a configuração. É possível fazer backup de toda a configuração do E9-1-1 em um arquivo, chamando-se o cmdlet Export-CsLisConfiguration. A chamada a Import-CsLisConfiguration restaurará a configuração a partir do arquivo.

A restauração da configuração ao se chamar esse cmdlet não sobrescreverá a configuração existente. Ela inserirá informações que foram removidas, mas não removerá os registros que tiverem sido adicionados após a criação do arquivo de backup.

IMPORTANTE: Como a importação do backup não substituirá os registros existentes, quaisquer registros que tiverem sido alterados serão restaurados e é possível que restem localizações órfãs. Por exemplo: suponha que um ponto de acesso sem fio (WAP) tenha sido definido com o valor de Location igual a Building30/Room10. É possível chamar Export-CsLisConfiguration para fazer o backup da configuração. Mais tarde, modifique a propriedade Location deste ponto de acesso sem fio para Building30/Rooms20-40. Se o cmdlet Import-CsLisConfiguration for chamado para restaurar a configuração do backup, a localização deste WAP será Building30/Room10 (a localização antes do backup), mas a localização Building30/Rooms20-40 permanecerá no banco de dados de configuração de localizações.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Import-CsLisConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

ByteInput

Obrigatório

Byte[]

O valor passado para esse parâmetro é uma variável contendo uma matriz de bytes da configuração LIS que tiver sido criada pelo cmdlet Export-CsLisConfiguration, com o parâmetro AsBytes.

FileName

Obrigatório

Cadeia de caracteres

O nome do arquivo de backup do qual será importada a configuração. É possível especificar FileName e ByteInput. Apenas um desses dois parâmetros pode ser utilizado em cada chamada a este cmdlet.

Tipos de Entrada

Byte[]. Aceita uma matriz de bytes de uma configuração LIS exportada. A matriz de bytes deve ser canalizada como um único registro. Veja o Exemplo 3.

Tipos de Retorno

Este cmdlet não retorna um valor.

Exemplo

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

Import-CsLisConfiguration -FileName C:\E911Config.bak

Este exemplo importa a configuração do E9-1-1 do arquivo de backup denominado E911Config.back para o banco de dados de configuração de localizações.

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

$lisconfig = Export-CsLisConfiguration -AsBytes 
Import-CsLisConfiguration -ByteInput $lisconfig

O Exemplo 2 mostra como utilizar o parâmetro ByteInput do cmdlet Import-CsLisConfiguration. A linha 1 mostra uma chamada para o cmdlet Export-CsLisConfiguration com o parâmetro AsBytes. A saída do comando é uma matriz de bytes contendo a configuração do LIS. Esta matriz é atribuída à variável $lisconfig. Na linha 2, chama-se o cmdlet Import-CsLisConfiguration. O parâmetro ByteInput recebe um valor de $lisconfig, que é a variável contendo a matriz de bytes exportada. Isso importará a matriz de bytes de volta ao banco de dados de configuração de localizações.

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

$lisconfig = Export-CsLisConfiguration -AsBytes
$listconfig | 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. Chama-se o cmdlet Export-CsLisConfiguration, juntamente com o parâmetro AsBytes, para armazenar a configuração LIS como uma matriz de bytes na variável $lisconfig. O restante deste exemplo mostra como salvar a configuração em um arquivo e importá-la de volta para o banco de dados de configuração de localizações.

Na linha 2, o conteúdo de $lisconfig, que é a matriz de bytes representando a configuração LIS, é canalizado para o cmdlet Set-Content do Windows PowerShell. Atribuem-se 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ção de localizações. Primeiramente, chama-se Get-Content, para recuperar o conteúdo do arquivo. Passa-se o valor 0 à propriedade ReadCount, que informa a 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 o Get-Content será canalizado para o cmdlet Import-CsLisConfiguration, que importará a configuração salva do banco de dados de configuração de localizações.