Set-CsLisSubnet
Letztes Änderungsdatum des Themas: 2012-03-27
Erstellt ein LIS-Subnetz (Location Information Server) und eine Zuordnung zwischen einem Subnetz und einem Standort (erstellt einen neuen Standort, wenn dieser Standort nicht vorhanden ist), oder ändert ein vorhandenes Subnetz und den zugeordneten Standort. Diese Zuordnung zwischen einem Subnetz und einem Standort wird in einer Enterprise-VoIP-Implementierung für 9-1-1 (erweitert) (E9-1-1) verwendet, um einen Notrufoperator über den Standort des Anrufers zu informieren.
Syntax
Set-CsLisSubnet -Subnet <String> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-Description <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSubnet -Subnet <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSubnet -City <String> -CompanyName <String> -Country <String> -HouseNumber <String> -HouseNumberSuffix <String> -Location <String> -PostalCode <String> -PostDirectional <String> -PreDirectional <String> -State <String> -StreetName <String> -StreetSuffix <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
E9-1-1 ermöglicht es einem Notrufoperator, den Standort des Anrufers zu ermitteln, ohne dass der Anrufer diese Informationen angeben muss. Wenn ein Anrufer über eine VoIP-Verbindung anruft, müssen diese Informationen anhand verschiedener Verbindungsmerkmale extrahiert werden. Der VoIP-Administrator muss eine Standortzuordnung (auch: Wiremap) konfigurieren, die den Standort des Anrufers ermittelt. Mit diesem Cmdlet kann der Administrator dem Subnetz, über das der Client verbunden ist, physische Standorte zuordnen.
Der Parameter "Subnet" ist der einzige Parameter, der für dieses Cmdlet erforderlich ist. Wenn Sie einen bereits vorhandenen Wert für "Subnet" eingeben, wird mit diesem Cmdlet der Standort für dieses Subnetz anhand der bereitgestellten Standortparameter aktualisiert. Wenn der Wert "Subnet" nicht vorhanden ist, wird ein neuer Subnetzstandort erstellt.
Wenn in der Standortdatenbank keine Adresse vorhanden ist, die den hier eingegebenen Adressparametern (einschließlich der Nullwerte) genau entspricht, wird anhand der mit diesem Cmdlet eingegebenen Parameter eine neue Adresse erstellt. (Sie können eine Liste von Standorten durch Aufrufen des Cmdlets Get-CsLisLocation abrufen.) Für das Cmdlet Set-CsLisSubnet sind keine Standortparameter erforderlich, und es müssen keine Standortparameter eingegeben werden. Sie können einen Eintrag für Subnetze ohne Zuordnung zu einem Standort erstellen. Es ist auch möglich, einen ungültigen Standort mit diesem Cmdlet zu erstellen. Für einen gültigen Standort müssen mindestens Werte für "Location", "HouseNumber", "StreetName", "City", "State" und "Country" angegeben werden. Wenn Sie diese Parameter nicht angeben, enthalten die Anrufe, die aus dem angegebenen Subnetz stammen, möglicherweise nicht die Informationen, die der Notrufoperator benötigt (abhängig davon, ob gültige Einstellungen für einen Switch, einen Port oder den drahtlosen Zugriffspunkt vorhanden sind, die anstelle der Subnetzeinstellungen verwendet werden können). Es wird empfohlen, dass Sie die Standortparameter möglichst genau und möglichst vollständig angeben.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-CsLisSubnet 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 "Set-CsLisSubnet"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Subnet |
Erforderlich |
Zeichenfolge |
Die IP-Adresse (IP = Internet Protocol) des Protokolls. Dieser Wert sollte als IPv4-Adresse (bei der Ziffern durch Punkte getrennt sind, z. B. 192.0.2.0) eingegeben werden. |
City |
Optional |
Zeichenfolge |
Der Ortsname des Standorts. Maximale Länge: 64 Zeichen. |
CompanyName |
Optional |
Zeichenfolge |
Der Name des Unternehmens an diesem Standort. Maximale Länge: 60 Zeichen. |
Country |
Optional |
Zeichenfolge |
Das Land bzw. die Region, in dem bzw. der der Standort liegt. Maximale Länge: 2 Zeichen. |
Description |
Optional |
Zeichenfolge |
Eine ausführliche Beschreibung des Subnetzstandorts. |
HouseNumber |
Optional |
Zeichenfolge |
Die Hausnummer dieses Standorts. Bei einem Unternehmen ist dies die Hausnummer des Unternehmens. Maximale Länge: 10 Zeichen. |
HouseNumberSuffix |
Optional |
Zeichenfolge |
Zusätzliche Informationen für die Hausnummer wie "1/2" oder "A". Beispiel: "1234 1/2 Oak Street" oder "1234 A Elm Street". Hinweis: Um eine Apartmentnummer oder eine Büroetage anzugeben, müssen Sie den Parameter "Location" verwenden. Beispiel: -Location "Suite 100/Office 150". Maximale Länge: 5 Zeichen. |
Location |
Optional |
Zeichenfolge |
Der Name des Standorts. Dieser Wert ist in der Regel der Name des Standorts, der genauer ist als die allgemeine Adresse wie z. B. die Büronummer. Der Wert kann aber auch ein beliebiger Zeichenfolgenwert sein. Maximale Länge: 20 Zeichen. |
PostalCode |
Optional |
Zeichenfolge |
Die Postleitzahl des Standorts. Maximale Länge: 10 Zeichen. |
PostDirectional |
Optional |
Zeichenfolge |
Angaben zur Himmelsrichtung als Teil des Straßennamens. Beispiel: NE oder NW für "Main Street NE" oder "7th Avenue NW". Maximale Länge: 2 Zeichen. |
PreDirectional |
Optional |
Zeichenfolge |
Angabe der Himmelsrichtung als Teil des Straßennamens, die vor dem Straßennamen steht. Beispiel: NE oder NW für "NE Main Street" oder "NW 7th Avenue". Maximale Länge: 2 Zeichen. |
State |
Optional |
Zeichenfolge |
Das Bundesland oder der Kanton, in dem sich der Standort befindet. Maximale Länge: 2 Zeichen. |
StreetName |
Optional |
Zeichenfolge |
Der Straßenname für den Standort. Maximale Länge: 60 Zeichen. |
StreetSuffix |
Optional |
Zeichenfolge |
Der Straßentyp als Teil des Straßennamens, z. B. "Street", "Avenue" oder "Court". Maximale Länge: 10 Zeichen. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Akzeptiert eine weitergeleitete Eingabe von LIS-Subnetzobjekten.
Rückgabetypen
Mit diesem Cmdlet wird ein Objekt vom Typ "System.Management.Automation.PSCustomObject" abgerufen oder geändert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsLisSubnet -Subnet 192.10.10.0
In Beispiel 1 wird ein Eintrag für einen LIS-Subnetzstandort erstellt oder aktualisiert. Der Befehl in diesem Beispiel enthält nur einen (erforderlichen) Parameter: "Subnet". Der Wert von "Subnet" ist in diesem Beispiel eine IPv4-Adresse, 192.10.10.0.
Beachten Sie, dass in diesem Beispiel keine Adressinformationen enthalten sind. Es ist möglich, einen Eintrag für Subnetze auf dem Location Information Server ohne Zuordnung zu einer Adresse zu erstellen. Allerdings enthalten Notrufe, die (abhängig von den definierten Port- oder Switchstandorten) über dieses Subnetz weitergeleitet werden, möglicherweise nicht genügend Informationen, sodass der Notrufoperator den Standort nicht identifizieren kann.
WICHTIG: Wenn bereits ein LIS-Subnetzstandort mit diesem Subnetzwert vorhanden ist, wird er durch die Werte in diesem Befehl ersetzt. Wenn also diesem Subnetz eine Adresse (ein physischer Standort) zugeordnet wäre, wäre diese Zuordnung nicht mehr vorhanden, da keine Standortinformationen in diesen Befehl eingeschlossen wurden. Der Standort ist weiterhin in der Standortdatenbank vorhanden, wird diesem Subnetz aber nicht zugeordnet.