Condividi tramite

  • Articolo

Get-CsVoiceNormalizationRule

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce le informazioni sulle regole di normalizzazione vocale in uso nell'organizzazione. Le regole di normalizzazione vocale consentono di convertire i requisiti 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

Get-CsVoiceNormalizationRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsVoiceNormalizationRule [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Questo cmdlet restituisce una regola di normalizzazione vocale o una raccolta di regole di normalizzazione vocale. 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.

È possibile accedere alle stesse regole recuperate dal cmdlet attraverso la proprietà NormalizationRules restituita dall'utilizzo del cmdlet Get-CsDialPlan.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsVoiceNormalizationRule può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

Un identificatore univoco per la regola. Se viene specificato un valore per questo parametro, il valore deve essere nel formato ambito/nome, come in site:co1/Rule1, dove site:co1 è l'ambito e Rule1 è il nome.

Filter

Facoltativo

XdsIdentityFilter

Consente di utilizzare stringhe con caratteri jolly per ottenere una raccolta di regole di normalizzazione basate sul parametro Identity. Filter è utilizzabile solamente sulla parte dell'ambito dell'identità, non sul nome. Ad esempio, il valore di filtro *lob* restituisce tutte le regole in ambito globale (gli ambiti che contengono le lettere lob), ma non una regola con identità site:Redmond/lobby, dove lob si trova solo nel nome dell'identità e non nell'ambito.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare la regola di normalizzazione vocale dalla replica locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno.

Tipi restituiti

Get-CsVoiceNormalizationRule restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule.

Esempio

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

Get-CsVoiceNormalizationRule

Con questo esempio vengono recuperate tutte le regole di normalizzazione vocale definite per l'organizzazione.

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

Get-CsVoiceNormalizationRule -Filter site*

Con l'esempio 2 vengono recuperate tutte le regole di normalizzazione vocale specificate per tutti i siti.

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

Get-CsVoiceNormalizationRule -Filter *s*

L'Esempio 3 consente di recuperare le regole di normalizzazione vocale che contengono la lettera s in qualunque punto dell'ambito. Ad esempio, questo comando restituirà tutte le regole a livello di sito e servizio nonché tutte le regole per utente che contengono una s nel nome dell'ambito, come, ad esempio, RedmondEastUsers.

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

Get-CsVoiceNormalizationRule | Where-Object {$_.Name -match "seattle"}

Il parametro Filter utilizzato negli esempi 2 e 3 permette la corrispondenza solo con la parte dell'ambito del parametro Identity. Con questo esempio viene ottenuta una corrispondenza sulla parte del nome, in modo da ottenere tutte le regole il cui nome contiene la stringa "seattle". Per ottenere questo risultato, è necessario utilizzare per prima cosa il cmdlet Get-CsVoiceNormalizationRule per recuperare tutte le regole di normalizzazione dell'organizzazione. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object per trovare tutti gli elementi nella raccolta la cui proprietà Name corrisponde alla stringa "seattle".