Set-CsRoutingConfiguration
Letztes Änderungsdatum des Themas: 2012-03-26
Ändert eine Liste von VoIP-Routen.
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
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Optional |
XdsIdentity |
Der Gültigkeitsbereich der Routingkonfiguration. Dieser muss "Global" lauten. |
Instance |
Optional |
PstnRoutingSettings |
Ein Routingkonfigurationsobjekt (Microsoft.Rtc.Management.WritablConfig.Policy.Voice.PstnRoutingSettings). Ein Objekt dieses Typs kann durch den Aufruf von Get-CsRoutingConfiguration abgerufen werden. |
Route |
Optional |
Route |
Eine Liste aller VoIP-Routen (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route-Objekte), die für die Lync Server-Bereitstellung definiert sind. Sie sollten einzelne VoIP-Routenobjekte über das Cmdlet Set-CsVoiceRoute ändern. Dies ist die empfohlene Methode zum Ändern von Routen in dieser Liste. |
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.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