Condividi tramite

  • Articolo

New-CsVoiceRegex

 

Ultima modifica dell'argomento: 2012-03-26

Crea il formato e la conversione di un'espressione regolare per convertire i numeri telefonici in diversi formati.

Sintassi

New-CsVoiceRegex -AtLeastLength <Int32> [-DigitsToPrepend <String>] [-DigitsToStrip <Int32>] [-StartsWith <String>]

New-CsVoiceRegex -ExactLength <Int32> [-DigitsToPrepend <String>] [-DigitsToStrip <Int32>] [-StartsWith <String>]

Descrizione dettagliata

Le espressioni regolari vengono utilizzate per la corrispondenza con i formati di caratteri. In Microsoft Lync Server 2010 vengono utilizzate le espressioni regolari per convertire i numeri di telefono in e da diversi formati, inclusi i numeri composti, E.164 e i formati del centralino locale (PBX) e della rete PSTN (Public Switched Telephone Network). Se non si conoscono le regole di sintassi e di formato delle espressioni regolari, la definizione di queste regole di conversione può risultare complessa. Il cmdlet New-CsVoiceRegex fornisce i parametri che consentono di specificare alcuni criteri, quindi genera automaticamente l'espressione regolare.

Utilizzare questo cmdlet per facilitare la generazione di espressioni regolari da utilizzare come valori Pattern e Translation per le regole di normalizzazione (New-CsVoiceNormalizationRule) e le regole di conversione delle chiamate in uscita (New-CsOutboundTranslationRule) e come valori NumberPattern per le route vocali (New-CsVoiceRoute).

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsVoiceRegex 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 "New-CsVoiceRegex"}

Parametri

Parametro Obbligatorio Tipo Descrizione

AtLeastLength

Obbligatorio

Int32

Lunghezza minima richiesta affinché la stringa, ossia il numero di telefono, corrisponda all'espressione. Ad esempio, se si definisce una regola di normalizzazione che coinvolge solo i numeri di almeno 7 cifre, o caratteri, specificare il valore 7 per questo parametro.

È necessario specificare un valore per questo parametro o per il parametro ExactLength. Non è possibile inserire un valore per entrambi.

ExactLength

Obbligatorio

Int32

La lunghezza della stringa, del numero di telefono, deve corrispondere all'espressione regolare. Ad esempio, se si desidera che la regola di normalizzazione coinvolga unicamente i numeri a 10 cifre, specificare il valore 10 per questo parametro.

È necessario specificare un valore per questo parametro o per il parametro AtLeastLength. Non è possibile inserire un valore per entrambi.

DigitsToPrepend

Facoltativo

Stringa

Una stringa in cui sono specificati i caratteri o i numeri da aggiungere all'inizio del numero telefonico. Il valore immesso per questo parametro influisce sul valore Translation, ponendo i caratteri all'inizio del numero corrispondente all'espressione regolare Pattern. Ad esempio, se il numero corrispondente al formato è 5551212 e il valore DigitsToPrepend è 425, il numero convertito sarà 4255551212 (purché non siano state applicate altre conversioni).

DigitsToStrip

Facoltativo

Int32

La quantità di caratteri da eliminare dall'inizio della stringa, o del numero di telefono. Ad esempio, se viene immesso il numero 2065551212 e il valore DigitsToStrip è 3, il numero verrà convertito in 5551212.

StartsWith

Facoltativo

Stringa

Il primo carattere della stringa, o numero di telefono. La stringa non corrisponderà all'espressione regolare a meno che non inizi con la stringa specificata nel parametro StartsWith. Ad esempio, se per StartsWith viene specificato il valore "+1", solo i numeri che iniziano con +1 corrisponderanno a questo formato e verranno, pertanto, convertiti. Il numero di caratteri presenti nella stringa StartsWith verrà incluso nel totale di ExactLength e AtLeastLenght. Se ad esempio sono stati specificati una lunghezza esatta (ExactLength) pari a 10 e una stringa valore iniziale (StartWith) pari a +1, il numero di telefono corrispondente sarà costituito da 8 caratteri preceduti da +1, per un totale di 10 cifre.

Tipi di input

Nessuno.

Tipi restituiti

Consente di creare un oggetto di tipo Microsoft.Rtc.Management.Voice.OcsVoiceRegex.

Esempio

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

$regex = New-CsVoiceRegex -ExactLength 7 -DigitsToStrip 3

In questo esempio vengono creati il formato e la conversione di una nuova espressione regolare. Questa espressione include un formato la cui lunghezza esatta è di 7 cifre (-ExactLength 7) e rimuove le prime tre cifre del numero corrispondente (-DigitsToStrip 3). Il valore Pattern creato da questa espressione regolare è ^\d{3}(\d{4})$, mentre il valore Translation è $1. Ad esempio, il numero 5551212 corrisponderebbe al formato e la conversione risultante sarebbe 1212: il numero a 7 cifre senza le prime 3 cifre.

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

$regex = New-CsVoiceRegex -AtLeastLength 7 -StartsWith "1"
New-CsVoiceNormalizationRule "global/internal rule" -Pattern $regex.Pattern -Translation $regex.Translation

Anche in questo esempio vengono creati il formato e la conversione di una nuova espressione regolare, ma, successivamente, questi valori vengono utilizzati per creare una nuova regola di normalizzazione vocale. Nella prima riga viene chiamato New-CsVoiceRegEx per creare un'espressione regolare il cui numero corrispondente deve contenere almeno 7 caratteri (-AtLeastLength 7) e deve iniziare con 1 (-StartsWith "1"). Quel che risulta dall'esecuzione del comando viene assegnato alla variabile $regex.

Nella seconda riga viene chiamato il cmdlet New-CsVoiceNormalizationRule. Alla nuova regola viene assegnato un nome univoco, in questo caso, regola globale/interna. Come formato per la regola di normalizzazione viene quindi assegnato il valore Pattern creato tramite la chiamata a New-CsVoiceRegex: -Pattern $regex.Pattern. Viene eseguita la stessa operazione per la conversione, assegnando il valore Translation creato tramite la chiamata a New-CsVoiceRegex: -Translation $regex.Translation.

Nota: Il valore Pattern creato in questo esempio è ^(1\d{5}\d+)$. Questo valore può essere decifrato come un numero che inizia con 1 (1), seguito da cinque cifre (\d{5}), che a loro volta sono seguite da un numero qualsiasi di cifre (\d+). Questo numero si somma a un numero di almeno 7 cifre (1 più 5 più 1 o più) che inizia con 1, ovvero esattamente il numero richiesto.