Freigeben über


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.