Freigeben über


Import-CsLisConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Importiert eine Enterprise-VoIP-Konfiguration für 9-1-1 (erweitert) (E9-1-1) aus einer Sicherungsdatei.

Syntax

Import-CsLisConfiguration -FileName <String>

Import-CsLisConfiguration -ByteInput <Byte[]>

Detaillierte Beschreibung

Bei der Implementierung von E9-1-1 in einer Organisation müssen den Standorten, je nach Größe der Organisation, möglicherweise Tausende Subnetze, Ports, Switches und drahtlose Zugriffspunkte zugeordnet werden. Eine E9-1-1-Konfiguration umfasst auch Informationen zum LIS (Location Information Server), der vom E9-1-1-Netzwerkroutinganbieter bereitgestellt wird, und zu Standorten und allgemeinen Adressen sowie dazu, ob diese auf Gültigkeit überprüft wurden. Angesichts des Umfangs von Informationen und Einstellungen bei der Implementierung von E9-1-1 wird ausdrücklich empfohlen, die gesamte Konfiguration regelmäßig zu sichern. Durch Aufrufen des Cmdlets Export-CsLisConfiguration können Sie die gesamte E9-1-1-Konfiguration in einer Datei sichern. Durch Aufrufen von Import-CsLisConfiguration wird die Konfiguration aus dieser Datei wiederhergestellt.

Durch Wiederherstellen der Konfiguration durch Aufruf dieses Cmdlets wird die vorhandene Konfiguration nicht überschrieben. Bei diesem Vorgang werden entfernte Informationen eingefügt, aber keine vorhandenen Datensätze entfernt, die nach Erstellen der Sicherungsdatei hinzugefügt wurden.

WICHTIG: Da vorhandene Datensätze durch den Import aus der Sicherung nicht ersetzt werden, werden geänderte Datensätze wiederhergestellt, und es könnten verwaiste Standorte übrig bleiben. Angenommen, Sie haben einen drahtlosen Zugriffspunkt (Wireless Access Point, WAP) mit dem Wert "Gebäude30/Raum10" für den Parameter "Location" eingerichtet. Sie rufen Export-CsLisConfiguration auf, um Ihre Konfiguration zu sichern. Später ändern Sie die Eigenschaft "Location" dieses drahtlosen Zugriffspunkts in "Gebäude30/Räume20-40". Wenn Sie anschließend Import-CsLisConfiguration aufrufen, um die gesicherte Konfiguration wiederherzustellen, lautet der Standort für diesen WAP "Gebäude30/Raum10" (Standort vor der Sicherung), der Standort für "Gebäude30/Räume20-40" verbleibt jedoch in der Standortkonfigurationsdatenbank.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Import-CsLisConfiguration lokal ausführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

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

Parameter

Parameter Erforderlich Typ Beschreibung

ByteInput

Erforderlich

Byte[]

Der an diesen Parameter übergebene Wert ist eine Variable mit einem Bytearray der LIS-Konfiguration, die mithilfe des Cmdlets Export-CsLisConfiguration unter Angabe des Parameters "AsBytes" erstellt wurde.

FileName

Erforderlich

Zeichenfolge

Der Name der Sicherungsdatei, aus der die Konfiguration importiert werden soll. Die Parameter "FileName" und "ByteInput" können nicht zusammen angegeben werden. Nur einer dieser beiden Parameter kann beim Aufruf dieses Cmdlets verwendet werden.

Eingabetypen

Byte[]. Akzeptiert ein Bytearray aus einer exportierten LIS-Konfiguration. Das Bytearray muss als einzelner Datensatz weitergeleitet werden. Siehe Beispiel 3.

Rückgabetypen

Dieses Cmdlet gibt keinen Wert zurück.

Beispiel

-------------------------- Beispiel 1 --------------------------

Import-CsLisConfiguration -FileName C:\E911Config.bak

In diesem Beispiel wird die E9-1-1-Konfiguration aus der Sicherungsdatei "E911Config.back" in die Standortkonfigurationsdatenbank importiert.

-------------------------- Beispiel 2 --------------------------

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

Beispiel 2 veranschaulicht die Verwendung des Parameters "ByteInput" des Cmdlets Import-CsLisConfiguration. Zeile 1 enthält einen Aufruf des Cmdlets Export-CsLisConfiguration mit dem Parameter "AsBytes". Die Ausgabe des Befehls ist ein Bytearray mit der LIS-Konfiguration. Dieses Array wird der Variablen "$lisconfig" zugewiesen. In Zeile 2 wird das Cmdlet Import-CsLisConfiguration aufgerufen. Der Parameter "ByteInput" empfängt einen Wert von "$lisconfig", der Variablen mit dem exportierten Bytearray. Hiermit wird dieses Bytearray wieder zurück in die LIS-Konfigurationsdatenbank importiert.

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

Beispiel 3 ist eine erweiterte Version von Beispiel 2. In der ersten Zeile wird ebenfalls Export-CsLisConfiguration mit dem Parameter "AsBytes" aufgerufen, um die LIS-Konfiguration als Bytearray in der Variablen "$lisconfig" zu speichern. Anschließend wird diese Konfiguration in einer Datei gespeichert und erneut in die Standortkonfigurationsdatenbank importiert.

In Zeile 2 wird der Inhalt von "$lisconfig" (das Bytearray zur Darstellung der LIS-Konfiguration) an das Windows PowerShell-Cmdlet Set-Content weitergeleitet. Den folgenden zwei Parametern von Set-Content werden Werte zugewiesen: "Path" und "Encoding". Dem Parameter "Path" wird der vollständige Pfad und der Name der Datei zugewiesen, in der die Konfiguration gespeichert werden soll. Der Parameter "Encoding" wird mit einem Bytewert verwendet, um sicherzustellen, dass die Konfiguration als Bytearray gespeichert wird.

In Zeile 3 wird die Konfiguration schließlich erneut in die Standortkonfigurationsdatenbank importiert. Zunächst wird zum Abrufen der Dateiinhalte das Cmdlet Get-Content aufgerufen. Für die Eigenschaft "ReadCount" wird der Wert 0 übergeben, sodass Get-Content den Inhalt der Datei nicht zeilenweise, sondern vollständig in einem Lesevorgang liest. Es wird erneut der Parameter "Encoding" mit einem Bytewert verwendet, um die Art der Daten anzugeben, die eingelesen werden sollen. Abschließend wird der Dateiname an den Parameter "Path" übergeben. Die mit Get-Content gelesenen Dateiinhalte werden an das Cmdlet Import-CsLisConfiguration weitergeleitet, das die gespeicherte Konfiguration in die Standortdatenbank importiert.