Condividi tramite

  • Articolo

Set-CsRoutingConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Modifica un elenco di route vocali.

Sintassi

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

Set-CsRoutingConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

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). Con questo cmdlet è possibile modificare le impostazioni di qualsiasi route vocale definita all'interno di una distribuzione di Lync Server 2010.

L'utilizzo di questo cmdlet non è consigliato. Per modificare le configurazioni di routing, modificare le singole route vocali chiamando il cmdlet Set-CsVoiceRoute.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Set-CsRoutingConfiguration i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) 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-CsRoutingConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

L'ambito della configurazione di routing. Questo valore deve essere Global.

Instance

Facoltativo

PstnRoutingSettings

Oggetto di configurazione di routing (Microsoft.Rtc.Management.WritablConfig.Policy.Voice.PstnRoutingSettings). Un oggetto di questo tipo può essere recuperato chiamando Get-CsRoutingConfiguration.

Route

Facoltativo

Route

Elenco di tutte le route vocali (oggetti Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route) definite per la distribuzione di Lync Server.

Per modificare i singoli oggetti route vocale è possibile utilizzare il cmdlet Set-CsVoiceRoute. Questo è il metodo consigliato per la modifica delle route in questo elenco.

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.

Confirm

Facoltativo

Parametro opzionale

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

Tipi di input

Oggetto Microsoft.Rtc.WritableConfig.Management.Policy.Voice.PSTNRoutingSettings. Accetta l'input da pipeline di un oggetto di configurazione di routing.

Tipi restituiti

Set-CsRoutingConfiguration non restituisce alcun oggetto o valore. Il cmdlet piuttosto configura le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings.

Esempio

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

$a = Get-CsRoutingConfiguration
$b = $a.Route | Where-Object {$_.Name -match "LocalRoute"}
$b.SuppressCallerId = $False
Set-CsRoutingConfiguration -Instance $a

Servono diverse operazioni per modificare una route vocale in una configurazione di routing. In questo esempio si inizia con il recupero dell'oggetto configurazione di routing mediante una chiamata a Get-CsRoutingConfiguration. L'oggetto recuperato (sarà solo uno) viene assegnato alla variabile $a.

Nella riga 2 dell'esempio viene recuperato il contenuto della proprietà Route dalla variabile $a, che è una raccolta di oggetti route vocale. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, in cui vengono cercati nella raccolta tutti gli oggetti route vocale la cui proprietà Name corrisponde alla stringa LocalRoute. Tale oggetto viene assegnato alla variabile $b.

Successivamente l'oggetto route vocale LocalRoute viene modificato con l'assegnazione del valore $False alla proprietà SuppressCallerId. Aggiornando l'oggetto viene aggiornato anche l'oggetto nella variabile $a, che tuttavia rimane ancora solo in memoria. Nell'ultimo passaggio è necessario salvare le modifiche passando la variabile $a al parametro Instance di Set-CsRoutingConfiguration.

Questo non è il metodo consigliato per la modifica di una configurazione di routing. Per modificare una configurazione di routing, è sufficiente modificare le singole route vocali con la proprietà Set-CsVoiceRoute, come illustrato di seguito:

Set-CsVoiceRoute -Identity LocalRoute -SuppressCallerId $False

Questa unica riga permette di eseguire le stesse operazioni mostrate nell'esempio 1.