Set-CsLisPort

Syntax

Set-CsLisPort -ChassisID <String> -PortID <String> [-City <String>] [-CompanyName <String>] [-Confirm [<SwitchParameter>]] [-Country <String>] [-Description <String>] [-HouseNumber <String>] [-HouseNumberSuffix <String>] [-Location <String>] [-PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-PostalCode <String>] [-PostDirectional <String>] [-PreDirectional <String>] [-State <String>] [-StreetName <String>] [-StreetSuffix <String>] [-WhatIf [<SwitchParameter>]]

Set-CsLisPort -ChassisID <String> -PortID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-WhatIf [<SwitchParameter>]]

Set-CsLisPort -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 Port, über den der Client verbunden ist, physische Standorte zuordnen.

Die Kombination der Werte von "ChassisID", "PortID" und "PortIDSubType" ergibt eine eindeutige Portadresse. Wenn Sie einen bereits vorhandenen Wert für "ChassisID"/"PortID"/"PortIDSubType" eingeben, wird mit diesem Cmdlet der Standort für diesen Port anhand der bereitgestellten Standortparameter aktualisiert. Ist die Kombination nicht vorhanden, wird eine neue Portadresse 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-CsLisPort sind keine Standortparameter erforderlich, und es müssen keine Standortparameter eingegeben werden. Sie können einen Eintrag für einen Port 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 dieser Parameter angeben, enthalten die Anrufe, die vom referenzierten Port empfangen werden, möglicherweise nicht die Informationen, die der Notrufoperator benötigt (abhängig davon, ob gültige Einstellungen für einen Switch, ein Subnetz oder den drahtlosen Zugriffspunkt vorhanden sind, die anstelle der Porteinstellungen verwendet werden können). Es wird empfohlen, dass Sie die Standortparameter möglichst genau und möglichst vollständig angeben.

Einer der erforderlichen Parameter dieses Cmdlets ist "ChassisID". "ChassisID" gibt die MAC-Adresse (Media Access Control) für den Netzwerkswitch des Ports an. Wenn dieser Switch nicht in der Standortdatenbank vorhanden ist, wird er mit diesem Cmdlet erstellt. Sie können vorhandene Switches durch Aufruf des Cmdlets Get-CsLisSwitch abrufen. Beachten Sie, dass zwar ein neuer Switcheintrag erstellt wird, dieser jedoch nicht automatisch den Standortinformationen zugeordnet wird, die Sie mit dem Cmdlet Set-CsLisPort eingegeben haben. Sie müssen mit dem Cmdlet Set-CsLisSwitch den Switchstandort festlegen.

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

Parameter

Eingabetypen

Akzeptiert eine weitergeleitete Eingabe von LIS-Portobjekten.

Rückgabetypen

Mit diesem Cmdlet wird ein Objekt vom Typ "System.Management.Automation.PSCustomObject" abgerufen oder geändert.

Beispiel

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

Set-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1

In Beispiel 1 wird ein Eintrag für eine LIS-Portadresse erstellt oder aktualisiert. Der Befehl in diesem Beispiel umfasst drei Parameter: "ChassisID", "PortID" und "PortIDSubtype". Der Wert von "ChassisID" ist die MAC-Adresse "99-99-99-99-99-99", der Wert für "PortID" lautet 4200, und der Wert von "PortIDSubType" wird auf 1 festgelegt. (Beachten Sie, dass der Wert 1 für "PortIDSubType" in "InterfaceAlias" übersetzt wird. Dieser Parameter und -wert könnte auch so eingegeben werden: -PortIDSubType InterfaceAlias.) Diese drei Parameter sind erforderlich, um eine eindeutige Instanz einer Portadresse zu erstellen.

Beachten Sie, dass in diesem Beispiel keine Adressinformationen enthalten sind. Es ist möglich, einen Porteintrag auf dem LIS (Location Information Server) ohne Zuordnung zu einer Adresse zu erstellen. Jedoch enthalten Notrufe, die (abhängig von den definierten Subnetz- oder Switchstandorten) über diesen Port weitergeleitet werden, möglicherweise nicht genügend Informationen, sodass der Notrufoperator den Standort nicht identifizieren kann.

WICHTIG: Wenn bereits eine LIS-Portadresse mit dieser Wertekombination vorhanden ist, wird diese durch die Werte in diesem Befehl ersetzt. Falls diesem Port eine Adresse (ein physischer Standort) zugeordnet wurde, wäre diese Zuordnung nicht länger vorhanden, da im Befehl keine Standortinformationen eingeschlossen wurden. Der Standort ist weiterhin in der Standortdatenbank vorhanden, wird aber diesem Port nicht zugeordnet.

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

Set-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIdSubType 1 -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 Port durch das Hinzufügen von Adressinformationen aktualisiert. Wenn die Adresse nicht in der Standortdatenbank vorhanden ist, wird sie mit diesem Cmdlet erstellt.

-------------------------- Beispiel 3 --------------------------

$a = Get-CsLisPort | Where-Object {$_.ChassisID -eq "99-99-99-99-99-88"}
$a | Set-CsLisPort -Location "30/1000" -HouseNumber 1234 -StreetName First -StreetSuffix Avenue -City Redmond -State WA -Country US -PostalCode 99999

In diesem Beispiel werden alle Standorte aktualisiert, die für Ports mit der MAC-Adresse (ChassisID) "99-99-99-99-99-88" definiert wurden. In der ersten Zeile des Beispiels wird das Cmdlet Get-CsLisPort aufgerufen, um alle Ports abzurufen, die im LIS-Dienst definiert sind. Diese Auflistung von Ports wird an das Cmdlet Where-Object weitergeleitet, mit dem alle Elemente in der Auflistung ermittelt werden, bei denen "ChassisID" den Wert "99-99-99-99-99-88" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Diese Auflistung von Ports mit dem Wert "99-99-99-99-99-88" für "ChassisID" wird der Variablen "$a" zugewiesen.

In der zweiten Zeile dieses Beispiels werden die Inhalte von Variable "$a" (der Auflistung von LIS-Ports mit dem Wert "99-99-99-99-99-88" für "ChassisID") an das Cmdlet Set-CsLisPort weitergeleitet. Dieses Cmdlet aktualisiert jedes Element in der Auflistung mit den Werten der angegebenen Parameter (Location, HouseNumber, StreetName, StreetSuffix, City, State, Country, PostalCode).

Siehe auch

Weitere Ressourcen

Remove-CsLisPort
Get-CsLisPort
Get-CsLisLocation
Get-CsLisSwitch