Set-CsVoiceNormalizationRule
Última modificación del tema: 2012-03-27
Modifica 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
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>]]
Descripción detallada
Este cmdlet modifica 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 modifican 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.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-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 "Set-CsVoiceNormalizationRule"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
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. |
Instance |
Opcional |
NormalizationRule |
Permite enviar una referencia a un objeto al cmdlet, en lugar de definir valores de parámetros individuales. Este objeto debe ser de tipo NormalizationRule y se puede recuperar llamando a Get-CsVoiceNormalizationRule. |
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 empresa. 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. |
Priority |
Opcional |
Int32 |
El orden en que se aplican las reglas. Un número puede coincidir con más de una regla. Este parámetro establece el orden en que se prueban las reglas con el número. |
Pattern |
Opcional |
Cadena de caracteres |
Expresión regular con la que debe coincidir el número marcado para que se aplique la regla. |
Translation |
Opcional |
Cadena de caracteres |
El patrón de expresión regular que se aplicará al número para convertirlo al formato E.164. |
Force |
Opcional |
Parámetro modificador |
Suprime las preguntas de confirmación que aparecerían antes de realizar cambios. |
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
Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule. Acepta la entrada transferida de objetos de regla de normalización de voz.
Tipos de valores devueltos
Set-CsVoiceNormalizationRule no devuelve un valor u objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsVoiceNormalizationRule -Identity "site:Redmond/Prefix Redmond" -Description "Add a prefix to all numbers on site Redmond"
Este ejemplo define la descripción de la regla Prefix Redmond en el sitio Redmond: "Add a prefix to all numbers on site Redmond" (Agregar un prefijo a todos los números del sitio Redmond).
-------------------------- Ejemplo 2 --------------------------
Set-CsVoiceNormalizationRule -Identity global/SeattleFourDigit -Description "Translate an internal four-digit extension" -Translation '+1206556$1'
En este ejemplo se modifica la regla de normalización de voz con el parámetro Identity establecido en global/SeattleFourDigit. Se ha especificado una nueva descripción para reflejar las modificaciones realizadas en la regla. Asimismo, se ha especificado un valor Translation que modifica la regla para traducir cualquier número que coincida con el patrón existente de la regla al mismo número pero con el prefijo +1206556. Por ejemplo, si el patrón existente coincidiera con cualquier número de cuatro dígitos y se hubiera introducido el número 1234, la regla traduciría la extensión al número +12065561234.
-------------------------- Ejemplo 3 --------------------------
$a = Get-CsVoiceNormalizationRule -Identity global/RedmondFourDigit
$a.name = "RedmondRule"
Set-CsVoiceNormalizationRule -Instance $a
En el Ejemplo 3, se cambia el nombre de la regla de normalización. Recuerde que al cambiar el nombre, cambia también la parte del nombre de la Identidad. El cmdlet Set-CsVoiceNormalizationRule no tiene un parámetro Name, de modo que para cambiar el nombre primero se llama a Get-CsVoiceNormalizationRule para recuperar la regla con el valor de Identity global/RedmondFourDigit y asignar el objeto devuelto a la variable $a. A continuación, se asigna la cadena de caracteres RedmondRule a la propiedad Name del objeto. A continuación, se envía la variable al parámetro Instance de Set-CsVoiceNormalizationRule para que el cambio sea permanente.