Condividi tramite

  • Articolo

Set-CsVoiceNormalizationRule

 

Ultima modifica dell'argomento: 2012-03-27

Modifica una regola di normalizzazione vocale. Le regole di normalizzazione vocali sono utilizzate per convertire un requisito di composizione telefonica (ad esempio la composizione di 9 per l'accesso a una linea esterna) nel formato per numeri di telefono E.164 utilizzato da Microsoft Lync Server 2010.

Sintassi

Set-CsVoiceNormalizationRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Set-CsVoiceNormalizationRule [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Questo cmdlet consente di modificare una regola di normalizzazione vocale specificata. Queste regole sono una parte obbligatoria dell'autorizzazione telefonica e del routing delle chiamate. Definiscono i requisiti per la conversione dei numeri dal formato Lync Server 2010 interno a un formato standard (E.164). Per definire i modelli numerici da convertire si rivela utile la comprensione delle espressioni regolari.

Le regole modificate utilizzando questo cmdlet sono parte del dial plan e, oltre ad essere accessibili tramite il cmdlet Get-CsVoiceNormalizationRule, possono essere recuperate attraverso la proprietà NormalizationRules restituita da una chiamata al cmdlet Get-CsDialPlan.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsVoiceNormalizationRule in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Un identificatore univoco per la regola. Il parametro Identity specificato deve includere l'ambito seguito da una barra e quindi dal nome, come in site:Redmond/Rule1, dove site:Redmond è l'ambito e Rule1 è il nome.

Instance

Facoltativo

NormalizationRule

Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. Questo oggetto deve essere di tipo NormalizationRule e può essere recuperato chiamando Get-CsVoiceNormalizationRule.

Description

Facoltativo

Stringa

Una descrizione della regola di normalizzazione.

Lunghezza massima della stringa: 512 caratteri.

IsInternalExtension

Facoltativo

Booleano

Se impostato su True, il risultato dell'applicazione di questa regola è un numero interno all'organizzazione. Se impostato su False, l'applicazione della regola produce un numero esterno. Questo valore viene ignorato se il valore della proprietà OptimizeDeviceDialing del dial plan associato è impostato su False.

Priority

Facoltativo

Int32

L'ordine di applicazione delle regole. Un numero potrebbe rispondere a più regole. Questo parametro stabilisce l'ordine di test delle regole sul numero.

Pattern

Facoltativo

Stringa

Un'espressione regolare a cui il numero composto deve corrispondere affinché sia applicata questa regola.

Translation

Facoltativo

Stringa

Il modello di espressione regolare che sarà applicato al numero per convertirlo nel formato E.164.

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.Management.WritableConfig.Policy.Voice.NormalizationRule. Consente di accettare l'input da pipeline di oggetti regola di normalizzazione vocale.

Tipi restituiti

Set-CsVoiceNormalizationRule non restituisce alcun oggetto o valore. Il cmdlet, invece, consente di configurare le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule.

Esempio

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

Set-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond" -Description "Add a prefix to all numbers on site Redmond"

Con questo esempio la descrizione della regola Prefix Redmond per il sito Redmond viene impostata su "Add a prefix to all numbers on site Redmond".

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

Set-CsVoiceNormalizationRule -Identity global/SeattleFourDigit -Description "Translate an internal four-digit extension" -Translation '+1206556$1'

Con questo esempio viene modificata la regola di normalizzazione vocale con identità global/SeattleFourDigit. È stata specificata una nuova descrizione per riflettere le modifiche alla regola. Inoltre, è stato specificato un valore di conversione che modifica la regola per convertire qualsiasi numero corrispondente al modello esistente di questa regola nello stesso numero ma con il prefisso +1206556. Ad esempio, se il modello esistente corrispondeva a qualsiasi numero di quattro cifre e veniva immesso il numero 1234, la regola converte tale numero di interno nel numero +12065561234.

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

$a = Get-CsVoiceNormalizationRule -Identity global/RedmondFourDigit
$a.name = "RedmondRule"
Set-CsVoiceNormalizationRule -Instance $a

Con l'esempio 3 viene modificato il nome della regola di normalizzazione. La modifica del nome comporta anche la modifica della parte del nome nell'identità. Il cmdlet Set-CsVoiceNormalizationRule non dispone di un parametro Name, quindi per cambiare il nome è necessario chiamare prima Get-CsVoiceNormalizationRule per recuperare la regola con Identity global/RedmondFourDigit e assegnare l'oggetto restituito alla variabile $a. A questo punto è possibile assegnare la stringa RedmondRule alla proprietà Name dell'oggetto. Successivamente si passa la variabile al parametro Instance di Set-CsVoiceNormalizationRule per rendere definitiva la modifica.