Remove-CsLisSwitch
Letztes Änderungsdatum des Themas: 2012-03-27
Entfernt einen LIS-Netzwerkswitch (Location Information Server).
Syntax
Remove-CsLisSwitch -ChassisID <String> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
9-1-1 (erweitert) (E9-1-1) ermöglicht es einem Notrufoperator, den Standort des Anrufers zu identifizieren, 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. Dieses Cmdlet entfernt einen Switch aus der Standortkonfigurationsdatenbank. Beim Entfernen eines Switches wird nicht der tatsächliche Standort, sondern nur der Switch entfernt. Sie können den Standort mit dem Cmdlet Remove-CsLisLocation entfernen.
Sie können einen Switch nicht entfernen, wenn die "ChassisID" des Switches von einem Port verwendet wird. (Führen Sie den folgenden Befehl aus, um die "ChassisIDs" zu bestimmen, die von Ports verwendet werden: Get-CsLisPort | Select-Object ChassisID.) Sie müssen zuerst alle Ports mit der angegebenen "ChassisID" entfernen, bevor Sie den Switch entfernen können.
Wenn Sie versuchen, einen nicht vorhandenen Switch 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 sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Remove-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 "Remove-CsLisSwitch"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
ChassisID |
Erforderlich |
Zeichenfolge |
Die MAC-Adresse (Media Access Control) des Netzwerkswitches. Der Wert muss im Format "nn-nn-nn-nn-nn-nn" vorliegen, z. B. 12-34-56-78-90-ab. |
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
Dieses Cmdlet gibt keinen Wert zurück. Mit ihm wird ein Objekt vom Typ "System.Management.Automation.PSCustomObject" entfernt.
Beispiel
-------------------------- Beispiel 1 --------------------------
Remove-CsLisSwitch -ChassisID 99-99-99-99-99-99
Beispiel 1 entfernt den LIS-Switch mit der MAC-Adresse (ChassisID) 99-99-99-99-99-99.
Dieser Befehl hat keinen Erfolg, wenn ein Port auf die ChassisID verweist. Wenn dieser Switch außerdem einem Standort zugeordnet war, wird dieser nicht entfernt. Lediglich der Switch wird aus der Standortzuordnung entfernt.
-------------------------- Beispiel 2 --------------------------
Get-CsLisSwitch | Where-Object {$_.City -eq ""} | Remove-CsLisSwitch
Dieses Beispiel entfernt alle Switches, für die kein Ort angegeben ist. Es ruft zunächst das Cmdlet Get-CsLisSwitch auf, das eine Auflistung aller Switches zurückgibt. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet, das die Elemente in dieser Auflistung herausfiltert, deren Eigenschaft "City " leer ist, d. h. bei denen "City" einer leeren Zeichenfolge ("") entspricht (der Vergleichsoperator "-eq" steht für "equal to"). Abschließend wird diese Auflistung von Switches ohne Ortsangabe an das Cmdlet Remove-CsLisSwitch weitergeleitet, das den gesamten Inhalt dieser Auflistung entfernt.
Beachten Sie, dass in Beispiel 1 keine Standorte aus der Standortdatenbank, sondern nur die Switches entfernt werden, die auf diese Standorte verweisen. Dies bedeutet in diesem Fall, dass es in der Standortdatenbank ungültige Standorte gibt (da "City" eine Pflichteigenschaft für einen Standort ist), die auch entfernt werden müssen. Sie können Standorte durch Aufrufen des Cmdlets Remove-CsLisLocation entfernen.