• Artikel

New-CsVoiceRoute

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt eine neue VoIP-Route. VoIP-Routen enthalten 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

New-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]

New-CsVoiceRoute -Name <String> [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Verwenden Sie dieses Cmdlet, um eine neue VoIP-Route zu erstellen. Sämtliche VoIP-Routen werden auf globaler Ebene erstellt. Es können jedoch mehrere globale VoIP-Routen definiert werden. Dazu wird der Parameter "Identity" verwendet, der einen eindeutigen Routennamen erfordert.

VoIP-Routen werden über PSTN-Verwendungen VoIP-Richtlinien zugeordnet. Eine VoIP-Route umfasst einen regulären Ausdruck, der festlegt, welche Telefonnummern über eine vorgegebene VoIP-Route weitergeleitet werden: Alle Telefonnummern, die mit dem regulären Ausdruck übereinstimmen, werden über diese Route weitergeleitet.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

XdsIdentity

Ein Name zur eindeutigen Kennzeichnung der VoIP-Route. VoIP-Routen können ausschließlich für den globalen Gültigkeitsbereich definiert werden, daher geben Sie über "Identity" einfach nur den gewünschten Namen der Route an. (Der Routenname kann Leerzeichen enthalten, z. B. "Test Route", beim Aufruf von New-CsVoiceRoute muss jedoch die gesamte Zeichenfolge in doppelte Anführungszeichen eingeschlossen werden.)

Ist für den Parameter "Identity" ein Wert angegeben, muss der Parameter "Name" leer bleiben. Der Wert des Parameters "Identity" wird dem Parameter "Name" zugewiesen.

Name

Erforderlich

Zeichenfolge

Der eindeutige Name der VoIP-Route. Ist dieser Parameter festgelegt, wird der Wert automatisch auf den Parameter "Identity" der VoIP-Route angewendet. Sie können nur einen der beiden Parameter "Identity" und "Name" festlegen.

AlternateCallerId

Optional

Zeichenfolge

Wenn der Parameter "SuppressCallerId" auf "True" festgelegt ist, wird den Empfängern anstelle der tatsächlichen Nummer des Anrufers der Wert des Parameters "AlternateCallerId" angezeigt. Diese Nummer muss eine gültige Nummer sein, die für eine Abteilung innerhalb der Organisation steht, z. B. die Support- oder Personalabteilung.

Wenn der Parameter "SuppressCallerId" auf "False" festgelegt ist, wird der Parameter "AlternateCallerId" ignoriert.

Dieser Wert muss mit dem regulären Ausdruck "(\+)?[1-9]\d*(;ext=[1-9]\d*)?" übereinstimmen. Anders ausgedrückt, der Wert kann mit einem Pluszeichen (+) beginnen, dies ist jedoch nicht erforderlich. Der Wert muss sich aus einer beliebigen Anzahl von Ziffern zusammensetzen, ggf. gefolgt von einer Durchwahlnummer, die mit ";ext=" beginnt, gefolgt von einer beliebigen Anzahl von Ziffern. (Beachten Sie, dass die Zeichenfolge bei Angabe einer Durchwahlnummer in doppelte Anführungszeichen gesetzt werden muss.)

Description

Optional

Zeichenfolge

Eine Beschreibung des Zwecks der VoIP-Route.

NumberPattern

Optional

Zeichenfolge

Ein regulärer Ausdruck, der die Telefonnummern angibt, auf die diese Route angewendet wird. Nummern, die diesem Muster entsprechen, werden gemäß der weiteren Routingeinstellungen weitergeleitet.

Standard: [0-9]{10}

Priority

Optional

Int32

Eine Nummer kann in mehrere VoIP-Routen aufgelöst werden. Die Priorität bestimmt die Reihenfolge, in der die Routen angewendet werden, wenn mehr als eine Route möglich ist.

PstnGatewayList

Optional

PSListModifier

In Lync Server 2010 können einem Vermittlungsserver mehrere Gateways zugeordnet werden. Dieser Parameter enthält eine Liste der Gateways, die dieser VoIP-Route zugeordnet sind. Bei den Mitgliedern dieser Liste muss es sich um die Dienstidentität des PSTN-Gateways oder Vermittlungsservers handeln. Der Wert kann nur auf einen Vermittlungsserver verweisen, wenn der Vermittlungsserver für Microsoft Office Communications Server 2007 oder Microsoft Office Communications Server 2007 R2 konfiguriert ist. Für Lync Server 2010 muss ein PSTN-Gateway verwendet werden. Die Dienstidentität ist eine Zeichenfolge im Format <Dienstrolle>:<FQDN>, wobei "Dienstrolle" für den Namen der Dienstrolle (PSTNGateway) und "FQDN" für den vollqualifizierten Domänennamen (FQDN) des Pools oder für die IP-Adresse des Servers steht. Beispiel: PSTNGateway:redmondpool.litwareinc.com. Dienstidentitäten können abgerufen werden, indem der Befehl "Get-CsService | Select-Object Identity" aufgerufen wird.

Diese Liste ist standardmäßig leer. Wenn Sie diesen Parameter jedoch beim Erstellen einer neuen VoIP-Route leer lassen, wird eine Warnmeldung ausgegeben.

PstnUsages

Optional

PSListModifier

Eine Liste der PSTN-Verwendungen (z. B. "Local", "Long Distance" usw.), die auf diese VoIP-Route angewendet werden können. Die PSTN-Verwendung muss vorhanden sein. (PSTN-Verwendungen können mit dem Cmdlet Get-CsPstnUsage abgerufen werden.)

Diese Liste ist standardmäßig leer. Wenn Sie diesen Parameter jedoch beim Erstellen einer neuen VoIP-Route leer lassen, wird eine Warnmeldung ausgegeben.

SuppressCallerId

Optional

Boolescher Wert

Legt fest, ob bei ausgehenden Anrufen eine Anrufer-ID offengelegt wird. Ist dieser Parameter auf "True" festgelegt, wird die Anrufer-ID unterdrückt. Anstelle der tatsächlichen ID wird der Wert des Parameters "AlternateCallerId" angezeigt. Wenn "SuppressCallerId" auf "True" festgelegt ist, muss für "AlternateCallerId" ein Wert angegeben werden.

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

Zeichenfolge

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Keine.

Rückgabetypen

Erstellt ein Objekt vom Typ "Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route".

Beispiel

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

New-CsVoiceRoute -Identity Route1

Der Befehl in diesem Beispiel erstellt eine neue VoIP-Route mit dem Identitätswert "Route1". Alle weiteren Eigenschaften werden auf die Standardwerte festgelegt.

-------------------------- Beispiel 2 --------------------------

New-CsVoiceRoute -Identity Route1 -PstnUsages @{add="Long Distance"} -PstnGatewayList @{add="PstnGateway:redmondpool.litwareinc.com"}

Der Befehl in diesem Beispiel erstellt eine neue VoIP-Route mit dem Identitätswert "Route1". Es wird außerdem die PSTN-Verwendung "Long Distance" zur Liste der Verwendungen und die Dienst-ID "PstnGateway:redmondpool.litwareinc.com" wird zur Liste der PSTN-Gateways hinzugefügt.

-------------------------- Beispiel 3 --------------------------

$x = (Get-CsPstnUsage).Usage
New-CsVoiceRoute -Identity Route1 -PstnUsages @{add=$x}

In diesem Beispiel wird eine neue VoIP-Route mit dem Namen "Route1" erstellt, und die Liste der PSTN-Verwendungen für diese Route wird mit allen vorhandenen Verwendungen für die Organisation aufgefüllt. Mit dem ersten Befehl in diesem Beispiel wird die Liste der globalen PSTN-Verwendungen abgerufen. Beachten Sie, dass der Aufruf von Get-CsPstnUsage in Klammern aufgeführt wird. Dies bedeutet, dass zuerst ein Objekt mit den PSTN-Verwendungsinformationen abgerufen wird. (Da nur eine [globale] PSTN-Verwendung vorhanden ist, wird nur ein Objekt abgerufen.) Mit dem Befehl wird dann die Eigenschaft "Usage" dieses Objekts abgerufen. Diese Eigenschaft, die eine Liste der Verwendungen enthält, wird der Variablen "$x" zugewiesen. In der zweiten Zeile dieses Beispiels wird New-CsVoiceRoute aufgerufen, um eine neue VoIP-Route zu erstellen. Diese VoIP-Route weist den Identitätswert "Route1" auf. Beachten Sie den Wert, der an den Parameter "PstnUsages" übergeben wird: @{add=$x}. Dieser Wert bedeutet, dass der Inhalt der Variablen "$x", die die in Zeile 1 abgerufene Liste der Telefonverwendungen enthält, der Liste mit PSTN-Verwendungen für diese Route hinzugefügt wird.