Freigeben über


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.