Import-CsLisConfiguration

Sintassi

Import-CsLisConfiguration -FileName <String>

Import-CsLisConfiguration -ByteInput <Byte[]>

Descrizione dettagliata

L'implementazione del servizio chiamate di emergenza in un'organizzazione può, a seconda delle dimensioni dell'organizzazione stessa, coinvolgere il mapping di migliaia di subnet, porte, switch e punti di accesso wireless alle posizioni. Una configurazione del servizio chiamate di emergenza include anche informazioni sul server LIS (Location Information Server) fornite dal provider di routing di rete del servizio chiamate di emergenza, sulle posizioni e sugli indirizzi civici e sulla relativa convalida. Dato il volume di informazioni e impostazioni richieste per implementare il servizio chiamate di emergenza, è fortemente consigliabile eseguire regolarmente il backup dell'intera configurazione. È possibile eseguire il backup dell'intera configurazione del servizio chiamate di emergenza in un file chiamando il cmdlet Export-CsLisConfiguration. Con la chiamata a Import-CsLisConfiguration è possibile ripristinare la configurazione da quel file.

Il ripristino della configurazione con una chiamata a questo cmdlet non sovrascrive la configurazione esistente. Inserisce le informazioni che sono state rimosse, ma non rimuove i record esistenti aggiunti dopo la creazione del file di backup.

IMPORTANTE: poiché l'importazione dal backup non sostituisce i record esistenti, gli eventuali record modificati saranno ripristinati e potrebbero risultare delle posizioni orfane. Ad esempio, si supponga di aver definito un punto di accesso wireless (WAP) con un valore Location pari a Building30/Room10. È stato poi chiamato Export-CsLisConfiguration per eseguire il backup della configurazione. In un secondo momento, la proprietà Location di tale punto di accesso wireless viene modificata in Building30/Rooms20-40. Se si chiama Import-CsLisConfiguration per ripristinare la configurazione di backup, la posizione del punto di accesso wireless sarà Building30/Room10 (quella precedente al backup), ma nel database di configurazione delle posizioni rimarrà la posizione per Building30/Rooms20-40.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Import-CsLisConfiguration in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Tipi di input

Byte[]. Accetta un array di byte da una configurazione LIS esportata. L'array di byte deve essere inviato tramite pipe come record singolo. Vedere l'esempio 3.

Tipi restituiti

Questo cmdlet non restituisce un valore.

Esempio

-------------------------- Esempio 1 --------------------------

Import-CsLisConfiguration -FileName C:\E911Config.bak

Con questo esempio la configurazione del servizio chiamate di emergenza viene importata dal file di backup denominato E911Config.back al database di configurazione delle posizioni.

-------------------------- Esempio 2 --------------------------

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

Con l'esempio 2 viene dimostrato come utilizzare il parametro ByteInput del cmdlet Import-CsLisConfiguration. Nella riga 1 è mostrata una chiamata al cmdlet Export-CsLisConfiguration con il parametro AsBytes. L'output del comando è un array di byte contenente la configurazione LIS. L'array viene assegnato alla variabile $lisconfig. Nella riga 2 viene chiamato il cmdlet Import-CsLisConfiguration. Il parametro ByteInput riceve il valore di $lisconfig, vale a dire la variabile contenente l'array di byte esportato. Tale array di byte sarà reimportato nel database di configurazione delle posizioni.

-------------------------- Esempio 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

L'esempio 3 è una versione più completa dell'esempio 2. La prima riga è la stessa e chiama Export-CsLisConfiguration con il parametro AsBytes per archiviare la configurazione LIS come array di byte nella variabile $lisconfig. Nella parte rimanente dell'esempio viene mostrato come salvare tale configurazione in un file per importarla successivamente nel database di configurazione delle posizioni.

Nella riga 2 il contenuto di $lisconfig, vale a dire l'array di byte che rappresenta la configurazione LIS, viene inviato tramite pipe al cmdlet Set-Content di Windows PowerShell. Si assegnano i valori ai due parametri di Set-Content, Path ed Encoding. Si assegna il percorso completo e il nome del file in cui si desidera salvare la configurazione al parametro Path. Si utilizza il parametro Encoding con un valore byte per garantire che la configurazione venga archiviata come array di byte.

Per finire, nella riga 3, si importa di nuovo la configurazione nel database di configurazione delle posizioni. Per prima cosa, occorre chiamare Get-Content per recuperare il contenuto dal file. Viene passato il valore 0 alla proprietà ReadCount, che comunica a Get-Content di leggere tutto il contenuto del file in una sola operazione, invece che una riga per volta. Ancora una volta si utilizza il parametro Encoding con un valore byte per specificare il tipo di dati da leggere dal file. Per finire, si passa il nome del file al parametro Path. Il contenuto del file letto con Get-Content viene inviato tramite pipe al cmdlet Import-CsLisConfiguration, che importa la configurazione salvata nel database di configurazione delle posizioni.

Vedere anche

Ulteriori risorse

Export-CsLisConfiguration
Publish-CsLisConfiguration
Unpublish-CsLisConfiguration
Debug-CsLisConfiguration
Test-CsLisConfiguration