Remove-CsVoiceRoute
Letztes Änderungsdatum des Themas: 2012-03-25
Entfernt eine VoIP-Route. VoIP-Routen umfassen Anweisungen, anhand derer Microsoft Lync Server 2010 ermittelt, wie Anrufe von Enterprise-VoIP-Benutzern bei Telefonnummern im Telefonfestnetz (Public Switched Telephone Network, PSTN) oder in einer Nebenstellenanlage (Private Branch Exchange, PBX) weitergeleitet werden sollen.
Syntax
Remove-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Verwenden Sie dieses Cmdlet, um eine vorhandene VoIP-Route zu entfernen. Da VoIP-Routen über Telefonverwendungen VoIP-Richtlinien zugeordnet sind, werden beim Entfernen von VoIP-Routen keine Werte im Zusammenhang mit einer VoIP-Richtlinie geändert. Lediglich das Routing für die Telefonnummern wird geändert, die mit dem Muster der gelöschten VoIP-Route übereinstimmen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet Remove-CsVoiceRoute 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-CsVoiceRoute"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
XdsGlobalRelativeIdentity |
Eine Zeichenfolge zur eindeutigen Kennzeichnung der VoIP-Route, die gelöscht werden soll. (Wenn der Routenname ein Leerzeichen enthält, z. B. "Route testen", muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden.) |
Force |
Optional |
Switch-Parameter |
Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden. |
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
Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route-Objekt. Akzeptiert eine weitergeleitete Eingabe von VoIP-Routenobjekten.
Rückgabetypen
Entfernt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route".
Beispiel
-------------------------- Beispiel 1 --------------------------
Remove-CsVoiceRoute -Identity Route1
Entfernt die Einstellungen für die VoIP-Route mit der Identität "Route1".
-------------------------- Beispiel 2 --------------------------
Get-CsVoiceRoute | Remove-CsVoiceRoute
Über diesen Befehl werden alle VoIP-Routen aus der Organisation entfernt. Zunächst werden mit dem Cmdlet Get-CsVoiceRoute alle VoIP-Routen abgerufen. Diese VoIP-Routen werden anschließend an das Cmdlet Remove-CsVoiceRoute weitergeleitet, das die einzelnen Routen entfernt.
-------------------------- Beispiel 3 --------------------------
Get-CsVoiceRoute -Filter *Redmond* | Remove-CsVoiceRoute
Über diesen Befehl werden alle VoIP-Routen mit einer Identität entfernt, welche die Zeichenfolge "Redmond" enthält. Zunächst wird das Cmdlet Get-CsVoiceRoute mit dem Parameter "Filter" aufgerufen. Der Wert des Parameters "Filter" ist die Zeichenfolge "Redmond", die in Platzhalterzeichen (*) eingeschlossen wird. Durch diese Zeichen wird angegeben, dass sich die Zeichenfolge an einer beliebigen Stelle innerhalb der Identität befinden kann. Nachdem alle VoIP-Routen abgerufen wurden, deren Identitätswerte die Zeichenfolge "Redmond" enthalten, werden diese VoIP-Routen zum Entfernen an das Cmdlet Remove-CsVoiceRoute weitergeleitet.