Set-CsLisSwitch
Letztes Änderungsdatum des Themas: 2012-04-23
Erstellt einen LIS-Switch (Location Information Server) und eine Zuordnung zwischen einem Switch und einem Standort (erstellt einen neuen Standort, wenn dieser Standort nicht vorhanden ist), oder ändert einen vorhanden Switch und den zugeordneten Standort. Diese Zuordnung zwischen einem Switch und einem Standort wird in einer Enterprise-VoIP-Implementierung von 9-1-1 (erweitert) (E9-1-1) verwendet, um einen Notrufoperator über den Standort des Anrufers zu informieren.
Syntax
Set-CsLisSwitch -ChassisID <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-CsLisSwitch -ChassisID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]
Set-CsLisSwitch -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 Netzwerkswitch, über den der Client verbunden ist, physische Standorte zuordnen.
Der Parameter "ChassisID" ist der einzige Parameter, der für dieses Cmdlet erforderlich ist. Wenn Sie einen bereits vorhandenen Wert für "ChassisID" eingeben, wird mit diesem Cmdlet der Standort für diesen Switch anhand der bereitgestellten Standortparameter aktualisiert. Wenn der Wert "ChassisID" nicht vorhanden ist, wird ein neuer Standort für einen Switch 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-CsLisSwitch sind keine Standortparameter erforderlich, und es werden keine Standortparameter angefordert. Sie können einen Eintrag für Switches 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 nicht alle diese Parameter angeben, enthalten die Anrufe, die vom referenzierten Switch empfangen werden, möglicherweise nicht die Informationen, die der Notrufoperator benötigt (abhängig davon, ob gültige Einstellungen für ein Subnetz oder den drahtlosen Zugriffspunkt vorhanden sind, die anstelle der Switcheinstellungen verwendet werden können). Es wird empfohlen, dass Sie die Standortparameter möglichst genau und möglichst vollständig angeben.
Beachten Sie, dass Einträge für Switches auch durch Aufruf des Cmdlets Set-CsLisPort erstellt werden können. Wenn Set-CsLisPort mit einem Wert für "ChassisID" aufgerufen wird und kein vorhandener Eintrag für Switches vorhanden ist, wird dieser Switch erstellt.
Wichtig ist der Hinweis, dass diese Änderungen nur wirksam werden, wenn Sie die "MACResolverUrl"-Eigenschaft mit dem Cmdlet New-CsWebServiceConfiguration oder Set-CsWebServiceConfiguration konfiguriert haben. Die "MACResolverUrl"-Eigenschaft gibt die URL eines Webdiensts an, der anhand einer IP-Adresse die MAC-Adresse (Media Access Control) der Netzwerkkarte bestimmen kann, die dieser IP-Adresse zugeordnet ist.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Set-CsLisSwitch lokal auszufü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-CsLisSwitch"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
ChassisID |
Erforderlich |
Zeichenfolge |
Die MAC-Adresse (Media Access Control) des Netzwerkswitches. Der Wert muss in der Form nn-nn-nn-nn-nn-nn (z. B. 12-34-56-78-90-ab) oder in der Form einer IP-Adresse vorliegen. Wenn ein Eintrag mit dem angegebenen Wert "ChassisID" nicht vorhanden ist, wird ein neuer Standort für den Switch erstellt. Wenn ein Eintrag mit dem angegebenen Wert "ChassisID" nicht vorhanden ist, wird der Eintrag ersetzt. |
City |
Erforderlich |
Zeichenfolge |
Der Ortsname des Standorts. Maximale Länge: 64 Zeichen. |
CompanyName |
Erforderlich |
Zeichenfolge |
Der Name des Unternehmens an diesem Standort. Maximale Länge: 60 Zeichen. |
Country |
Erforderlich |
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 Standorts für den Netzwerkswitch. |
HouseNumber |
Erforderlich |
Zeichenfolge |
Die Hausnummer dieses Standorts. Bei einem Unternehmen ist dies die Hausnummer des Unternehmens. Maximale Länge: 10 Zeichen. |
HouseNumberSuffix |
Erforderlich |
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 |
Erforderlich |
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 |
Erforderlich |
Zeichenfolge |
Die Postleitzahl des Standorts. Maximale Länge: 10 Zeichen. |
PostDirectional |
Erforderlich |
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 |
Erforderlich |
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 |
Erforderlich |
Zeichenfolge |
Das Bundesland oder der Kanton, in dem sich der Standort befindet. Maximale Länge: 2 Zeichen. |
StreetName |
Erforderlich |
Zeichenfolge |
Der Straßenname für den Standort. Maximale Länge: 60 Zeichen. |
StreetSuffix |
Erforderlich |
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-Switch-Objekten.
Rückgabetypen
Mit diesem Cmdlet wird ein Objekt vom Typ "System.Management.Automation.PSCustomObject" abgerufen oder geändert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Set-CsLisSwitch -ChassisID 99-99-99-99-99-99
In Beispiel 1 wird einen Eintrag für den Standort des Switches für den Location Information Server (LIS) erstellt oder aktualisiert. Der Befehl in diesem Beispiel enthält nur einen (erforderlichen) Parameter: ChassisID. Der Wert von "ChassisID" ist die MAC-Adresse des Switches, in diesem Fall 99-99-99-99-99-99.
Beachten Sie, dass in diesem Beispiel keine Adressinformationen enthalten sind. Es ist möglich, einen Eintrag für Switches auf dem Location Information Server ohne Zuordnung zu einer Adresse zu erstellen. Jedoch enthalten Notrufe, die (abhängig von den definierten Subnetzstandorten oder Portadressen) über diesen drahtlosen Zugriffspunkt weitergeleitet werden, möglicherweise nicht genügend Informationen, sodass der Notrufoperator den Standort nicht ermitteln kann.
WICHTIG: Wenn ein Standort eines Switches für den Location Information Server (LIS) mit dieser "ChassisID" bereits vorhanden ist, wird er durch die Werte in diesem Befehl ersetzt. Dies bedeutet, wenn diesem Switch eine Adresse (ein physischer Standort) zugeordnet ist, ist diese Zuordnung nicht mehr vorhanden, da keine Standortinformationen in diesem Befehl vorhanden sind. Der Standort ist weiterhin in der Standortdatenbank vorhanden, wird aber diesem Switch nicht zugeordnet.
-------------------------- Beispiel 2 --------------------------
Set-CsLisSwitch -ChassisID 99-99-99-99-99-99 -Location "30/1000" -HouseNumber 1234 -PreDirectional NE -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999
In Beispiel 2 wird der in Beispiel 1 erstellte Switch aktualisiert, indem Adressinformationen hinzugefügt werden. (Dadurch wird der vorhandene Eintrag gelöscht und durch diesen neuen Eintrag ersetzt.) Wenn die Adresse nicht in der Standortdatenbank vorhanden ist, wird sie mit diesem Cmdlet erstellt.
Siehe auch
Weitere Ressourcen
Remove-CsLisSwitch
Get-CsLisSwitch
Get-CsLisLocation
Set-CsLisPort
Get-CsLisPort