Get-CsVoiceNormalizationRule
Última modificación del tema: 2012-03-23
Devuelve información sobre las reglas de normalización de voz usadas en la organización. Las reglas de normalización convierten requisitos 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
Get-CsVoiceNormalizationRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsVoiceNormalizationRule [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
Este cmdlet devuelve una regla o una recopilación de reglas de normalización de voz. 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 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.
Puede obtener acceso a las mismas reglas a las que se tiene acceso con este cmdlet mediante la propiedad NormalizationRules devuelta por una llamada al cmdlet Get-CsDialPlan.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsVoiceNormalizationRule localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsVoiceNormalizationRule"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Identificador único de la regla. Si se especifica un valor para este parámetro, debe tener el formato ámbito/nombre; por ejemplo, site:Redmond/Rule1, site:Redmond es el ámbito y Rule1 es el nombre. |
Filter |
Opcional |
XdsIdentityFilter |
Usa cadenas comodín para devolver una recopilación de reglas de normalización basadas en Identity. Tenga en cuenta que el filtro solamente afecta a la sección de ámbito de la Identidad, no al nombre. Por ejemplo, el valor de filtro *lob* devolverá todas las reglas que tengan el ámbito global en su identidad (ámbitos que contienen las letras "lob"), pero no una regla con la identidad site:Redmond/lobby, en la que lob es solamente una parte del nombre de la identidad, no el ámbito. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera la regla de normalización de voz de la réplica local de la Almacén de administración central, en lugar de la Almacén de administración central en sí. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Get-CsVoiceNormalizationRule devuelve instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.NormalizationRule.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsVoiceNormalizationRule
En este ejemplo, se recuperan todas las reglas de normalización de voz definidas en la organización.
-------------------------- Ejemplo 2 --------------------------
Get-CsVoiceNormalizationRule -Filter site*
En el Ejemplo 2 se recuperan todas las reglas de normalización de voz especificadas para todos los sitios.
-------------------------- Ejemplo 3 --------------------------
Get-CsVoiceNormalizationRule -Filter *s*
El Ejemplo 3 recupera todas las reglas de normalización de voz con la letra s en el ámbito. Por ejemplo, esto devolverá todas las reglas en el nivel del sitio y de servicio, y las reglas por usuario con una s en el nombre del ámbito, tal como RedmondEastUsers.
-------------------------- Ejemplo 4 --------------------------
Get-CsVoiceNormalizationRule | Where-Object {$_.Name -match "seattle"}
El parámetro Filter de los ejemplos 2 y 3 solamente afecta a la sección de ámbito de Identity. En este ejemplo, se usa la sección de nombre para devolver todas las reglas cuyo nombre contenga la cadena de caracteres "seattle". Para ello, primero se llama a Get-CsVoiceNormalizationRule para recuperar todas las reglas de normalización de la organización. A continuación, se transfiere esta recopilación al cmdlet Where-Object para encontrar todos los elementos de la recopilación en los que la propiedad Name coincida con la cadena de caracteres "seattle".