Condividi tramite

  • Articolo

Set-CsVoiceRoute

 

Ultima modifica dell'argomento: 2012-03-25

Modifica una route vocale. Le route vocali contengono istruzioni che comunicano a Microsoft Lync Server 2010 come instradare le chiamate effettuate da utenti di VoIP aziendale ai numeri di telefono della rete PSTN (Public Switched Telephone Network) o di un centralino (PBX, Private Branch Exchange).

Sintassi

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>]]

Descrizione dettagliata

Utilizzare questo cmdlet per modificare una route vocale esistente. Le route vocali sono associate ai criteri vocali attraverso la rete PSTN (Public switched telephone network). Una route vocale include un'espressione regolare che identifica quali numeri di telefono saranno instradati attraverso una data route vocale: i numeri di telefono corrispondenti all'espressione regolare saranno instradati attraverso questa route.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsVoiceRoute i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsVoiceRoute"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

L'identità univoca della route vocale. (Se il nome della route contiene uno spazio come ad esempio Test Route, è necessario chiudere la stringa tra due parentesi).

Instance

Facoltativo

Route

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. L'oggetto deve essere di tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route e può essere recuperato chiamando Get-CsVoiceRoute.

AlternateCallerId

Facoltativo

Stringa

Se il parametro SuppressCallerId è impostato su True, i destinatari vedranno il valore del parametro AlternateCallerId al posto del numero effettivo del chiamante. Questo numero deve essere valido e può essere utilizzato per rappresentare una divisione all'interno di un'organizzazione, ad esempio l'assistenza tecnica o l'ufficio delle risorse umane.

Se il parametro SuppressCallerId è impostato su False, il parametro AlternateCallerId viene ignorato.

Questo valore deve corrispondere all'espressione regolare (\+)?[1-9]\d*(;ext=[1-9]\d*)?. In altre parole, il valore può, ma non deve, iniziare con un segno più (+), deve essere costituito da un qualsiasi numero di cifre e può essere seguito da un interno che inizia con ;ext= seguito da un qualsiasi numero di cifre. Se si include un interno, la stringa deve essere racchiusa tra virgolette doppie.

Description

Facoltativo

Stringa

Una descrizione dello scopo della route telefonica.

NumberPattern

Facoltativo

Stringa

Un'espressione regolare che specifica i numeri di telefono a cui si applica questa route. I numeri che corrispondono a questo modello saranno instradati in base alle rimanenti impostazioni di routing. Il modello dei numeri predefinito [0-9]{10} ad esempio specifica un numero a 10 cifre contenente cifre comprese tra 0 e 9.

Priority

Facoltativo

Int32

Un numero potrebbe essere risolto in più route vocali. La priorità determina l'ordine di applicazione delle route nel caso sia possibile utilizzare più di una route.

PstnGatewayList

Facoltativo

PSListModifier

Un Mediation Server può essere associato a più gateway. Questo parametro include un elenco di gateway associati a questa route vocale. Ciascun membro dell'elenco deve corrispondere all'identità di servizio del gateway PSTN o del Mediation Server. Il valore può fare riferimento a Mediation Server solo se Mediation Server è configurato per Microsoft Office Communications Server 2007 o Microsoft Office Communications Server 2007 R2. Per Lync Server 2010 è necessario utilizzare un gateway PSTN. L'identità di servizio è una stringa nel formato ServiceRole:FQDN, dove ServiceRole è il nome del ruolo del servizio (PSTNGateway) e FQDN è il nome di dominio completo del pool o l'indirizzo IP del server, ad esempio PSTNGateway:redmondpool.litwareinc.com. Le identità di servizio possono essere recuperate chiamando il comando Get-CsService | Select-Object Identity.

Se si apportano modifiche a una route vocale e si lascia l'elenco PstnGatewayList vuoto o se la modifica introdotta rimuove tutti le voci in elenco, gli utenti riceveranno un messaggio di avviso che notificherà l'impossibilità di effettuare chiamate PSTN.

PstnUsages

Facoltativo

A questa route vocale è possibile applicare un elenco di utilizzi PSTN (ad esempio Locali o Internazionali). L'utilizzo PSTN deve essere già esistente. Per recuperare gli utilizzi PSTN è possibile chiamare il cmdlet Get-CsPstnUsage.

Se si apportano modifiche a una route vocale e si lascia l'elenco PstnUsages vuoto o se la modifica introdotta rimuove tutti gli utilizzi PSTN nell'elenco, gli utenti riceveranno un messaggio di avviso che notificherà l'impossibilità di effettuare chiamate PSTN.

SuppressCallerId

Facoltativo

Booleano

Consente di determinare se durante le chiamate in uscita sarà visualizzato l'ID del chiamante. Se questo parametro è impostato su True, l'ID del chiamante non viene visualizzato. Al posto dell'ID vero e proprio, viene visualizzato il valore di AlternateCallerId. Se SuppressCallerId è impostato su True, deve essere fornito un valore per AlternateCallerId.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route. Accetta l'input da pipeline di oggetti route vocale.

Tipi restituiti

Set-CsVoiceRoute non restituisce un valore o un oggetto. Il cmdlet configura invece istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route.

Esempio

-------------------------- Esempio 1 --------------------------

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

Questo comando imposta la descrizione della route vocale Route1 su "Test Route."

-------------------------- Esempio 2 --------------------------

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

Il comando riportato in questo esempio modifica la route vocale con identità Route1 per aggiungere l'utilizzo PSTN Internazionale all'elenco di utilizzi della route vocale. Interurbane deve figurare nell'elenco di utilizzi PSTN globali (che è possibile recuperare chiamando il cmdlet Get-CsPstnUsage).

-------------------------- Esempio 3 --------------------------

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

In questo esempio viene modificata una route vocale denominata Route1 per popolare l'elenco di utilizzi PSTN di quella route con tutti gli utilizzi esistenti per l'organizzazione. Il primo comando in questo esempio consente di recuperare l'elenco di utilizzi PSTN globali. La chiamata a Get-CsPstnUsage è tra parentesi, perché occorre per prima cosa recuperare un oggetto contenente le informazioni sugli utilizzi PSTN. (Dal momento che esiste un solo utilizzo PSTN globale, sarà recuperato un solo oggetto). Il comando consente quindi di recuperare la proprietà Usage di questo oggetto. Tale proprietà, che contiene un elenco di utilizzi PSTN, viene assegnata alla variabile $x. Nella seconda riga di questo esempio, viene chiamato il cmdlet Set-CsVoiceRoute per modificare la route vocale con identità Route1. Si noti il valore passato al parametro PstnUsages: @{replace=$x}. Questo valore indica la necessità di sostituire ogni elemento nell'elenco PstnUsages della route con il contenuto di $x, che include l'elenco di utilizzi PSTN recuperati nella riga 1.

-------------------------- Esempio 4 --------------------------

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

Questo set di comandi modifica la proprietà Name della route vocale con identità Route1 in RouteA. La modifica della proprietà Name modificherà automaticamente la proprietà Identity, in questo caso in RouteA.

Nella prima riga, si chiama il cmdlet Get-CsVoiceRoute per recuperare la route vocale con identità Route1. L'oggetto restituito viene memorizzato nella variabile $x. In seguito, alla proprietà Name dell'oggetto viene assegnato il valore stringa "RouteA". L'oggetto contenuto nella variabile $x viene infine passato al parametro Instance di Set-CsVoiceRoute per la modifica.

-------------------------- Esempio 5 --------------------------

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

In questo esempio viene modificata la route vocale denominata Route1 e nell'elenco di gateway PSTN della route (PstnGatewayList) viene inserito il ruolo del server del gateway con valore Identity PstnGateway:192.168.0.100. Nella prima riga dell'esempio viene chiamato Get-CsVoiceRoute per recuperare la route vocale che si desidera modificare, in questo caso Route1. Viene quindi chiamato il metodo Add nella proprietà PstnGatewayList della Route1. Al metodo Add viene passata l'identità del servizio che si intende aggiungere. Viene chiamato infine il cmdlet Set-CsVoiceRoute, passando al parametro Instance la variabile $y, che aggiornerà Route1 (archiviata in $y) con il gateway PSTN appena aggiunto.