Set-CsVoiceRoute

Syntax

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

Set-CsVoiceRoute [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Verwenden Sie dieses Cmdlet, um eine vorhandene VoIP-Route zu ändern. VoIP-Routen werden VoIP-Richtlinien über die Verwendung eines Telefonfestnetzes (Public Switched Telephone Network, PSTN) 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 Set-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 "Set-CsVoiceRoute"}

Parameter

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route-Objekt. Akzeptiert eine weitergeleitete Eingabe von VoIP-Routenobjekten.

Rückgabetypen

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

Beispiel

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

Set-CsVoiceRoute -Identity Route1 -Description "Test Route"

Mit diesem Befehl wird die Beschreibung der VoIP-Route "Route1" auf "Test Route" festgelegt.

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

Set-CsVoiceRoute -Identity Route1 -PstnUsages @{add="Long Distance"}

In diesem Beispiel wird die VoIP-Route mit dem Identitätswert "Route1" geändert, um die PSTN-Verwendung "Long Distance" zur Liste der Verwendungen für diese VoIP-Route hinzuzufügen. "Long Distance" muss sich in der Liste der globalen PSTN-Verwendungen befinden (die mit dem Aufruf von Get-CsPstnUsage abgerufen werden kann).

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

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

In diesem Beispiel wird die VoIP-Route "Route1" geändert, um die Liste der PSTN-Verwendungen für diese Route mit allen vorhandenen Verwendungen für die Organisation aufzufüllen. 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 PSTN-Verwendungen enthält, wird der Variablen "$x" zugewiesen. In der zweiten Zeile dieses Beispiels wird Set-CsVoiceRoute aufgerufen, um die VoIP-Route mit dem Identitätswert "Route1" zu ändern. Beachten Sie den Wert, der an den Parameter "PstnUsages" übergeben wird: @{replace=$x}. Dieser Wert ersetzt alle Einträge in der Liste "PstnUsages" für diese Route durch die Inhalte der Variablen "$x", die die PSTN-Verwendungen enthält, die in Zeile 1 abgerufen wurden.

-------------------------- Beispiel 4 --------------------------

$x = Get-CsVoiceRoute -Identity Route1
$x.Name = "RouteA"
Set-CsVoiceRoute -Instance $x

Mit diesem Befehlssatz wird die Eigenschaft "Name" der VoIP-Route mit dem Identitätswert "Route1" zu "RouteA" geändert. Durch die Änderung der Eigenschaft "Name" wird automatisch auch die Eigenschaft "Identity" geändert, in diesem Fall zu "RouteA".

In der ersten Zeile wird Get-CsVoiceRoute aufgerufen, um die VoIP-Route mit dem Identitätswert "Route1" abzurufen. Das zurückgegebene Objekt wird in der Variablen "$x" gespeichert. Als Nächstes wird der Eigenschaft "Name" dieses Objekts der Zeichenfolgenwert "RouteA" zugewiesen. Schließlich wird das Objekt (in Variable "$x") an den Parameter "Instance" des Cmdlets Set-CsVoiceRoute übergeben, um die Änderung durchzuführen.

-------------------------- Beispiel 5 --------------------------

$y = Get-CsVoiceRoute -Identity Route1
$y.PstnGatewayList.Add("PstnGateway:192.168.0.100")
Set-CsVoiceRoute -Instance $y

In diesem Beispiel wird die VoIP-Route "Route1" geändert, und die Liste der PSTN-Gateways (PstnGatewayList) wird mit der Serverrolle des Gateways mit dem Identitätswert "PstnGateway:192.168.0.100" aufgefüllt. In der ersten Zeile des Befehls wird Get-CsVoiceRoute aufgerufen, um die VoIP-Route abzurufen, die geändert werden soll, in diesem Fall "Route1". Als Nächstes wird die Add-Methode für die Eigenschaft "PstnGatewayList" von "Route1" aufgerufen. Dann wird die Add-Methode an die Identität des Diensts übergeben, der hinzugefügt werden soll. Abschließend wird Set-CsVoiceRoute aufgerufen, und der Parameter "Instance" wird an die Variable "$y" übergeben, sodass "Route1" (gespeichert in "$y") mit dem neu hinzugefügten PSTN-Gateway aktualisiert wird.

Siehe auch

Weitere Ressourcen

New-CsVoiceRoute
Remove-CsVoiceRoute
Get-CsVoiceRoute
Test-CsVoiceRoute
Get-CsPstnUsage
Get-CsService