• Articolo

Export-CsLisConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Consente di esportare una configurazione per il servizio chiamate di emergenza di VoIP aziendale in un file in formato compresso a fini di backup.

Sintassi

Export-CsLisConfiguration -FileName <String>

Export-CsLisConfiguration [-AsBytes <SwitchParameter>]

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 sui servizi Web forniti dal provider di routing di rete del servizio chiamate di emergenza, e 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, è consigliabile eseguire regolarmente il backup dell'intera configurazione. È possibile utilizzare questo cmdlet per eseguire il backup della configurazione del servizio chiamate di emergenza in un file, salvando l'intera configurazione in formato compresso. Per ripristinare la configurazione, chiamare il cmdlet Import-CsLisConfiguration.

Con questo cmdlet viene creato un nuovo file di backup, senza sovrascrivere un file esistente. Di conseguenza, il nome file specificato nella chiamata a questo cmdlet non può corrispondere al nome di un file esistente.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Export-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 "Export-CsLisConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

FileName

Obbligatorio

Stringa

Il percorso e il nome del file in cui si desidera salvare la configurazione. Non può corrispondere al nome di un file esistente.

Se si specifica un valore per il parametro AsBytes, non è possibile specificare un valore anche per il parametro FileName. Se si accede a questo cmdlet in remoto è necessario utilizzare AsBytes al posto di FileName.

AsBytes

Facoltativo

Parametro opzionale

Consente di restituire la configurazione come array di byte. L'output del comando dovrebbe essere assegnato a una variabile per una successiva importazione. Se non si assegna l'output a una variabile, l'array di byte che rappresenta la configurazione scorrerà nella finestra di Lync Server Management Shell. Non è possibile specificare entrambi i parametri AsBytes e FileName; è possibile utilizzarne solo uno in ogni chiamata a questo cmdlet.

Tipi di input

Nessuno.

Tipi restituiti

Consente di restituire un array di byte (Byte[]) se viene utilizzato il parametro AsBytes.

Esempio

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

Export-CsLisConfiguration -FileName C:\E911Config.bak

Con questo esempio viene esportata l'intera configurazione del servizio chiamate di emergenza da Location Information Server (LIS) al file di backup denominato E911Config.bak.

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

$lisconfig = Export-CsLisConfiguration -AsBytes

Con questo esempio la configurazione LIS viene archiviata come array di byte in una variabile, $lisconfig.

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

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 delle posizioni.