• Artikel

Export-CsLisConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-23

Exportiert eine Enterprise-VoIP-Konfiguration für 9-1-1 (erweitert) (E9-1-1) zu Sicherungszwecken in eine komprimierte Datei.

Syntax

Export-CsLisConfiguration -FileName <String>

Export-CsLisConfiguration [-AsBytes <SwitchParameter>]

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 zu Webdiensten, die vom E9-1-1-Netzwerkroutinganbieter bereitgestellt werden, 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 empfohlen, die gesamte Konfiguration regelmäßig zu sichern. Mit diesem Cmdlet kann die gesamte E9-1-1-Konfiguration in einer Datei gesichert und in einem komprimierten Format gespeichert werden. Zur Wiederherstellung der Konfiguration rufen Sie das Cmdlet Import-CsLisConfiguration auf.

Dieses Cmdlet erstellt eine neue Sicherungsdatei, vorhandene Dateien werden nicht überschrieben. Das bedeutet, dass der beim Aufruf dieses Cmdlets angegebene Dateiname nicht mit dem Namen einer vorhandenen Datei übereinstimmen kann.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Export-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 "Export-CsLisConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

FileName

Erforderlich

Zeichenfolge

Der Pfad und Name der Datei, in der die Konfiguration gespeichert werden soll. Der Name darf nicht mit dem Namen einer vorhandenen Datei übereinstimmen.

Wenn Sie einen Wert für den Parameter "AsBytes" bereitstellen, können Sie keinen Wert für den Parameter "FileName" angeben. Beim Remotezugriff auf dieses Cmdlet muss anstelle von "FileName" der Parameter "AsBytes" verwendet werden.

AsBytes

Optional

Switch-Parameter

Gibt die Konfiguration als Bytearray zurück. Die Ausgabe des Befehls sollte für den späteren Import einer Variablen zugewiesen werden. (Wenn Sie die Ausgabe keiner Variablen zuweisen, wird das Bytearray, das die Konfiguration darstellt, im Lync Server-Verwaltungsshell-Fenster angezeigt.) Die Parameter "AsBytes" und "FileName" können nicht gemeinsam angegeben werden. Bei einem Aufruf dieses Cmdlets kann nur jeweils einer dieser Parameter verwendet werden.

Eingabetypen

Keine.

Rückgabetypen

Gibt bei Verwendung des Parameters "AsBytes" ein Bytearray (Byte[]) zurück.

Beispiel

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

Export-CsLisConfiguration -FileName C:\E911Config.bak

In diesem Beispiel wird die gesamte E9-1-1-Konfiguration vom Location Information Server (LIS) in die Sicherungsdatei "E911Config.bak" exportiert.

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

$lisconfig = Export-CsLisConfiguration -AsBytes

In diesem Beispiel wird die LIS-Konfiguration als Bytearray in der Variablen "$lisconfig" gespeichert.

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

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.