Set-CsRoutingConfiguration

Syntax

Set-CsRoutingConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsRoutingConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

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. Mit diesem Cmdlet können Sie die Einstellungen einer beliebigen Route ändern, die in einer Lync Server 2010-Bereitstellung definiert ist.

Die Verwendung dieses Cmdlets wird nicht empfohlen. Ändern Sie zum Bearbeiten der Routingkonfigurationen die einzelnen VoIP-Routen über das Cmdlet Set-CsVoiceRoute.

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

Parameter

Eingabetypen

Microsoft.Rtc.WritableConfig.Management.Policy.Voice.PSTNRoutingSettings-Objekt. Akzeptiert eine weitergeleitete Eingabe von Routingkonfigurationsobjekten.

Rückgabetypen

Set-CsRoutingConfiguration gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings" konfiguriert.

Beispiel

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

$a = Get-CsRoutingConfiguration
$b = $a.Route | Where-Object {$_.Name -match "LocalRoute"}
$b.SuppressCallerId = $False
Set-CsRoutingConfiguration -Instance $a

Zum Ändern einer VoIP-Route innerhalb einer Routingkonfiguration sind mehrere Schritte erforderlich. In diesem Beispiel wird zunächst das Routingkonfigurationsobjekt abgerufen, indem Get-CsRoutingConfiguration aufgerufen wird. Anschließend wird das abgerufene Objekt (es wird nur ein Objekt zurückgegeben) der Variablen "$a" zugewiesen.

In Zeile 2 des vorliegenden Beispiels werden die Inhalte der Eigenschaft "Route" aus der Variablen "$a" abgerufen, bei der es sich um eine Auflistung von VoIP-Routenobjekten handelt. Anschließend wird die Auflistung an das Cmdlet Where-Object übergeben, und die Auflistung wird nach allen VoIP-Routenobjekten durchsucht, deren Name mit der Zeichenfolge "LocalRoute" übereinstimmt. Dieses Objekt wird der Variablen "$b" zugewiesen.

Als Nächstes wird das VoIP-Routenobjekt "LocalRoute" geändert, indem der Eigenschaft "SuppressCallerId" der Wert "$False" zugewiesen wird. Durch eine Aktualisierung des Objekts wird das Objekt in der Variablen "$a" aktualisiert. Das Objekt befindet sich jedoch weiterhin nur im Arbeitsspeicher. Im letzten Schritt müssen die vorgenommenen Änderungen gespeichert werden, indem "$a" an den Parameter "Instance" des CmdletsSet-CsRoutingConfiguration übergeben wird.

Hierbei handelt es sich nicht um die empfohlene Vorgehensweise zum Ändern einer Routingkonfiguration. Ändern Sie zum Bearbeiten einer Routingkonfiguration die einzelnen VoIP-Routen über die Eigenschaft Set-CsVoiceRoute, wie nachfolgend gezeigt:

Set-CsVoiceRoute -Identity LocalRoute -SuppressCallerId $False

Diese eine Zeile führt dieselbe Aufgabe aus wie Beispiel 1.

Siehe auch

Weitere Ressourcen

New-CsRoutingConfiguration
Remove-CsRoutingConfiguration
Get-CsRoutingConfiguration
Set-CsVoiceRoute
Get-CsVoiceRoute