• Artikel

New-CsRoutingConfiguration

 

Letztes Änderungsdatum des Themas: 2012-03-26

Über dieses Cmdlet kann ein Objekt mit den Standardeinstellungen für ein Routingkonfigurationsobjekt zurückgegeben werden.

Syntax

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

Detaillierte Beschreibung

Bei einer Routingkonfiguration handelt es sich um einen Container für sämtliche VoIP-Routen, die innerhalb einer Microsoft Lync Server 2010-Bereitstellung definiert sind. Zum Erstellen einer neuen VoIP-Route verwenden Sie das Cmdlet New-CsVoiceRoute.

Eine Routingkonfiguration kann nur auf globaler Ebene definiert werden. Zudem sind keine individuell benannten Routingkonfigurationen zulässig; für die gesamte Lync Server 2010-Bereitstellung gibt es nur eine Liste mit VoIP-Routen. Beim Versuch, in der Lync Server 2010-Implementierung von Windows PowerShell durch den Aufruf eines Cmdlets, dessen Name mit der Zeichenfolge "New" beginnt, ein bereits vorhandenes Objekt zu erstellen, wird eine Fehlermeldung angezeigt. Sämtliche Implementierungen von Lync Server 2010 umfassen ein standardmäßiges Routingkonfigurationsobjekt mit der Identität "Global". Das bedeutet, dass die einzige Liste mit VoIP-Routen, die erstellt werden könnte, bereits vorhanden ist. Beim Aufruf von New-CsRoutingConfiguration wird daher stets eine Fehlermeldung zurückgegeben, und es wird keine neue Routingkonfiguration erstellt.

Die einzige Ausnahme stellt die Angabe des Parameters "InMemory" beim Aufruf dieses Cmdlets dar. Über diesen Befehl wird ein Objekt, das eine Standardliste mit VoIP-Routen enthält, lediglich im Arbeitsspeicher erstellt.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet New-CsRoutingConfiguration lokal auszufü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 "New-CsRoutingConfiguration"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Der Gültigkeitsbereich der Routingkonfiguration. Dieser Wert muss "Global" lauten.

Route

Optional

PSListModifier

Eine Liste aller VoIP-Routen (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route-Objekte), die für die Lync Server 2010-Bereitstellung definiert sind.

VoIP-Routenobjekte können über das Cmdlet New-CsVoiceRoute erstellt werden. Dies ist die empfohlene Methode zum Hinzufügen von VoIP-Routen zu dieser Liste.

Force

Optional

Switch-Parameter

Unterdrückt alle Bestätigungsaufforderungen, die andernfalls vor der Durchführung von Änderungen angezeigt würden.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

Keine.

Rückgabetypen

Ermöglicht die Erstellung eines Objekts vom Typ "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings" im Arbeitsspeicher.

Beispiel

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

$x = New-CsRoutingConfiguration -Identity global -InMemory

Über diesen Befehl wird ein Objekt mit den standardmäßigen Routingkonfigurationswerten erstellt, und dieses Objekt wird der Variablen "$x" zugewiesen. Bei Verwendung dieses Cmdlets für andere Aufgaben wird ein Fehler zurückgegeben.