Remove-CsLisPort
Letztes Änderungsdatum des Themas: 2012-03-27
Entfernt eine Zuordnung zwischen einem LIS-Port (Location Information Server) und einem Standort. Diese Zuordnung 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
Remove-CsLisPort -ChassisID <String> -PortID <String> -PortIDSubType <InterfaceAlias | InterfaceName | LocallyAssigned> [-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 wird eine Zuordnung zwischen einem physischen Standort und einem Port entfernt, über den Anrufe geleitet werden, indem der Port aus der Standortkonfigurationsdatenbank entfernt wird.
Beim Entfernen einer Portadresse wird nicht die tatsächliche Adresse des Ports entfernt, sondern nur der Port. Sie können den Standort mit dem Cmdlet Remove-CsLisLocation entfernen. Beim Entfernen des Ports wird auch nicht der Switch mit der entsprechenden Chassis-ID entfernt; rufen Sie das Cmdlet Remove-CsLisSwitch auf, um den Switch zu entfernen.
Wenn Sie versuchen, einen nicht vorhandenen Port zu entfernen, werden keine Maßnahmen ergriffen und weder eine Fehler- noch eine Warnmeldung angezeigt.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-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 "Remove-CsLisPort"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
ChassisID |
Erforderlich |
Zeichenfolge |
Die MAC-Adresse (Media Access Control) des Switches für den Port. Der Wert muss im Format "nn-nn-nn-nn-nn-nn" vorliegen, z. B. 12-34-56-78-90-ab. |
PortID |
Erforderlich |
Zeichenfolge |
Die ID des Ports, den Sie abrufen möchten. |
PortIDSubType |
Erforderlich |
PortIDSubType |
Der Untertyp des Ports, den Sie abrufen möchten. Dieser Wert kann als numerischer Wert oder als Zeichenfolge eingegeben werden, es muss sich jedoch um einen gültigen Untertyp handeln. Gültige Untertypen: 1: InterfaceAlias 5: InterfaceName 7: LocallyAssigned |
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-Port-Objekten.
Rückgabetypen
Dieses Cmdlet gibt keinen Wert zurück. Mit ihm wird ein Objekt vom Typ "System.Management.Automation.PSCustomObject" entfernt.
Beispiel
-------------------------- Beispiel 1 --------------------------
Remove-CsLisPort -ChassisID 99-99-99-99-99-99 -PortID 4200 -PortIDSubType 1
In Beispiel 1 werden der LIS-Port mit der MAC-Adresse (ChassisID) 99-99-99-99-99-99, der Port-ID 4200 und dem "PortIDSubType"-Wert 1 entfernt. (Beachten Sie, dass der Wert 1 für "PortIDSubType" in einen Wert für "InterfaceAlias" übersetzt wird. Dieser Parameter und -wert könnte auch so eingegeben werden: -PortIDSubType InterfaceAlias)
Wenn diesem Port ein Standort zugeordnet war, wird dieser nicht entfernt. Lediglich der Port wird aus der Standortzuordnung entfernt.
-------------------------- Beispiel 2 --------------------------
Get-CsLisPort | Where-Object {$_.HouseNumber -eq ""} | Remove-CsLisPort
In diesem Beispiel werden alle Portadressen entfernt, für die keine Hausnummer angegeben ist. Zunächst wird das Cmdlet Get-CsLisPort aufgerufen, das eine Auflistung aller LIS-Ports zurückgibt. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet, das die Elemente in dieser Auflistung herausfiltert, deren Eigenschaft "HouseNumber" leer ist, d. h. bei denen "HouseNumber" eine leere Zeichenfolge ("") aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Abschließend wird diese Auflistung von Portadressen ohne Hausnummern an das Cmdlet Remove-CsLisPort weitergeleitet, das den gesamten Inhalt dieser Auflistung entfernt.
Beachten Sie, dass in Beispiel 1 keine Standorte aus der Standortkonfigurationsdatenbank entfernt werden, sondern nur die Ports, die auf diese Standorte verweisen. Dies bedeutet in diesem Fall, dass es in der Standortdatenbank ungültige Standorte gibt (da "HouseNumber" eine Pflichteigenschaft für einen Standort ist), die auch entfernt werden müssen. Sie können Standorte durch Aufrufen des Cmdlets Remove-CsLisLocation entfernen.