New-CsVoiceNormalizationRule
Última modificación del tema: 2012-03-26
Crea una regla de normalización de voz. Las reglas de normalización de voz se usan para convertir un requisito de marcado de teléfono (por ejemplo, marcar 9 para obtener acceso a una línea externa) al formato de número de teléfono E.164 usado por Microsoft Lync Server 2010.
Sintaxis
New-CsVoiceNormalizationRule -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
New-CsVoiceNormalizationRule -Name <String> -Parent <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-IsInternalExtension <$true | $false>] [-Pattern <String>] [-Priority <Int32>] [-Translation <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Este cmdlet crea una regla de normalización de voz con nombre. Estas reglas son un componente necesario de la autorización telefónica y el enrutamiento de llamadas. Definen los requisitos de conversión (o traducción) de números de un formato de Lync Server 2010 interno a un formato estándar (E.164). Conocer las expresiones regulares facilita la definición de los patrones de números que se traducirán.
Las reglas que se crean usando este cmdlet forman parte del plan de marcado y, además de ser accesibles a través del cmdlet Get-CsVoiceNormalizationRule, también puede obtenerse acceso a ellas a través de la propiedad NormalizationRules que se devuelve tras una llamada al cmdlet Get-CsDialPlan. No se puede crear una regla de normalización a no ser que ya exista un plan de marcado con una Identity que coincida con el ámbito especificado en la Identidad de la regla de normalización. Por ejemplo, no se puede crear una regla de normalización con Identity site:Redmond/RedmondNormalizationRule a no ser que ya exista un plan de marcado para site:Redmond.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsVoiceNormalizationRule localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en rol (RBAC), este rol se ha asignado (así como cualquier otro rol RBAC personalizado que haya creado) para ejecutar el siguiente comando desde el símbolo del sistema Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsVoiceNormalizationRule"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único de la regla. El parámetro Identity especificado debe incluir el ámbito seguido de una barra y después el nombre, por ejemplo: site:Redmond/Rule1, donde site:Redmond es el ámbito y Rule1 es el nombre. La parte correspondiente al nombre se guardará automáticamente en la propiedad Name. No se puede especificar un valor para Identity y Name en el mismo comando. Las reglas de normalización de voz se pueden crear en los siguientes ámbitos: global, del sitio, del servicio (solo de registrador y PSTNGateway) y por usuario. Para poder crear una nueva regla, debe existir un plan de marcado con una Identity que coincida con el ámbito de la regla de normalización (para obtener una lista de los planes de marcado, llame al cmdlet Get-CsDialPlan). El parámetro Identity es obligatorio, a menos que se especifique el parámetro Parent. No se puede incluir el parámetro Identity y el parámetro Parent en el mismo comando. |
Name |
Requerido |
Cadena de caracteres |
El nombre de la regla. Este parámetro es obligatorio si se ha especificado un valor para el parámetro Parent. Si no se ha especificado ningún valor para el parámetro Parent, Name se establecerá de forma predeterminada en el nombre especificado en el parámetro Identity. Por ejemplo, si se crea una regla con el valor Identity site:Redmond/RedmondRule, el parámetro Name será, de forma predeterminada, RedmondRule. El parámetro Name y el parámetro Identity no pueden usarse en el mismo comando. |
Parent |
Requerido |
Cadena de caracteres |
El ámbito en el que se creará la regla de normalización. El valor debe ser global; site:<sitename>, donde <sitename> es el nombre del sitio de Lync Server, un servicio de registrador o puerta de enlace RTC (como PSTNGateway:redmond.litwareinc.com) o una cadena de caracteres que designe una regla por usuario. Ya debe existir un plan de marcado con el ámbito especificado o el comando provocará un error. El parámetro Parent es obligatorio, a menos que se especifique el parámetro Identity. No se puede incluir el parámetro Identity y el parámetro Parent en el mismo comando. Si incluye el parámetro Parent, también es necesario el parámetro Name. |
Description |
Opcional |
Cadena de caracteres |
Una descripción sencilla de la regla de normalización. Longitud máxima de la cadena de caracteres: 512 caracteres. |
IsInternalExtension |
Opcional |
Booleano |
Si el valor es True, el resultado de la aplicación de esta regla será un número interno de la organización. Si el valor es False, el resultado de la aplicación de la regla será un número externo. Este valor se omite en caso de que el valor de la propiedad OptimizeDeviceDialing del plan de marcado asociado esté establecido en False. Valor predeterminado: False |
Pattern |
Opcional |
Cadena de caracteres |
Expresión regular con la que debe coincidir el número marcado para que se aplique la regla. Valor predeterminado: ^(\d{11})$ (El valor predeterminado representa un conjunto de números con un máximo de 11 dígitos). |
Priority |
Opcional |
Int32 |
El orden en que se aplican las reglas. Un número de teléfono puede coincidir con más de una regla. Este parámetro establece el orden en que se prueban las reglas con el número. |
Translation |
Opcional |
Cadena de caracteres |
El patrón de expresión regular que se aplicará al número para convertirlo al formato E.164. Valor predeterminado: +$1 (El valor predeterminado añade un prefijo al número con un signo más [+].) |
Force |
Opcional |
Parámetro modificador |
Suprime las preguntas de confirmación que aparecerían antes de realizar cambios. |
InMemory |
Opcional |
Parámetro modificador |
Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Este cmdlet crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
New-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond"
En este ejemplo se crea una regla de normalización de voz para el sitio Redmond cuyo nombre es Prefix Redmond. Como no se han especificado más parámetros, la regla se crea con los valores predeterminados. Tenga en cuenta que el valor enviado al parámetro Identity está inserto entre comillas dobles, ya que el nombre de la regla (Prefix Redmond) contiene un espacio. Si el nombre de la regla no contiene ningún espacio, no es necesario delimitar el parámetro Identity entre comillas dobles.
Recuerde que debe haber un plan de marcado para el sitio Redmond para que el comando se ejecute correctamente. Puede crear un plan de marcado nuevo llamando al cmdlet New-CsDialPlan.
-------------------------- Ejemplo 2 --------------------------
New-CsVoiceNormalizationRule -Parent SeattleUser -Name SeattleFourDigit -Description "Dialing with internal four-digit extension" -Pattern '^(\d{4})$' -Translation '+1206555$1'
En este ejemplo se crear una regla de normalización de voz nueva denominada SeattleFourDigit que se aplica al plan de marcado por usuario con la Identity SeattleUser. (Nota: en lugar de especificar un valor para el parámetro Parent y Name, podríamos haber creado la misma regla mediante la especificación de -Identity SeattleUser/SeattleFourDigit.) Se ha incluido una descripción para explicar que esta regla tiene como objetivo traducir los números marcados de forma interna que tengan una extensión de 4 dígitos. Además, se han especificado los valores de Pattern y Translation. Estos valores traducen un número de cuatro dígitos (especificado por la expresión regular de Pattern) al mismo número de cuatro dígitos, pero con el prefijo del valor Translation (+1206555). Por ejemplo, si se ha introducido la extensión 1234, esta regla la traduciría al número +12065551234.
Observe las comillas simples alrededor de los valores de Pattern y Translation. Estas comillas son necesarias para estos valores. En estos casos, la ausencia de comillas o las comillas dobles no son viables.
Al igual que en el Ejemplo 1, debe haber un plan de marcado con el ámbito indicado. En este caso, eso significa que ya debe haber un plan de marcado con el parámetro Identity establecido en SeattleUser.