Set-CsVoiceTestConfiguration
Última modificación del tema: 2012-03-27
Modifica una situación de prueba que puede usar para probar números de teléfono con rutas y reglas especificadas.
Sintaxis
Set-CsVoiceTestConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceTestConfiguration [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Antes de implementar rutas y directivas de voz, es recomendable probarlas en varios números de teléfono para garantizar los resultados esperados. Puede hacerlo modificando situaciones de prueba con este cmdlet.
El cmdlet Set-CsVoiceTestConfiguration modifica la ruta de voz, el uso,el plan de marcado y la directiva de voz usados para probar un número de teléfono especificado. Toda esta información puede definirse y recuperarse mediante otros cmdlets, según se especifica en las descripciones de parámetros de este tema.
Las configuraciones modificadas con este cmdlet se prueban con el cmdlet Test-CsVoiceTestConfiguration.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsVoiceTestConfiguration localmente: 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 "Set-CsVoiceTestConfiguration"}
Parámetros
Parámetro | Requerido | Tipo | Descripción |
---|---|---|---|
Identity |
Opcional |
Cadena de caracteres |
Una cadena de caracteres que identifica de manera única la situación de prueba que se quiere modificar. El valor de este parámetro no incluye el ámbito, porque este objeto solo puede crearse en el ámbito global. Por lo tanto, solo se necesita un nombre. |
Instance |
Opcional |
TestConfiguration |
Un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration que contiene una configuración de prueba de voz con los cambios que quiere realizar en ella. Se puede recuperar un objeto de este tipo al llamar al cmdlet Get-CsVoiceTestConfiguraton. |
DialedNumber |
Opcional |
Cadena de caracteres |
El número de teléfono que quiere usar para probar directivas, usos, etc. Debe tener 512 caracteres o menos. |
ExpectedRoute |
Opcional |
Cadena de caracteres |
El nombre de la ruta de voz que debe usarse durante la prueba de configuración. Si se usa otra ruta, basada en el plan de marcado de destino y la directiva de voz, la prueba fallará. Puede recuperar rutas de voz disponibles llamando al cmdlet Get-CsVoiceRoute. Debe tener 256 caracteres o menos. |
ExpectedTranslatedNumber |
Opcional |
Cadena de caracteres |
El número de teléfono en el formato con el que debe verse después de la traducción. Es el valor del parámetro DialedNumber después de la normalización. Si se ejecuta Test-CsVoiceTestConfiguration y DialedNumber no da como resultado el valor de ExpectedTranslatedNumber, la prueba será fallida. Debe tener 512 caracteres o menos. |
ExpectedUsage |
Opcional |
Cadena de caracteres |
El nombre del uso de PSTN que se espera usar durante la prueba de configuración. Si se usa otro PSTN, basado en el plan de marcado de destino y la directiva de voz, la prueba fallará. Puede recuperar los usos disponibles si llama a Get-CsPstnUsage. Debe tener 256 caracteres o menos. |
TargetDialplan |
Opcional |
Cadena de caracteres |
La identidad del plan de marcado que se usará para la prueba. Los planes de marcado pueden recuperarse llamando al cmdlet Get-CsDialPlan. Debe tener 40 caracteres o menos. |
TargetVoicePolicy |
Opcional |
Cadena de caracteres |
La identidad de la directiva de voz con la que realizar la prueba. Las directivas de voz pueden recuperarse llamando a Get-CsVoicePolicy. Debe tener 40 caracteres o menos. |
Force |
Opcional |
Parámetro modificador |
Suprime las solicitudes de confirmación que, de lo contrario, se mostrarí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.TestConfiguration. Acepta entradas canalizadas de objetos de configuración de prueba de voz.
Tipos de valores devueltos
Este cmdlet devuelve un objeto del tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 14255551212
En este ejemplo, se define el número marcado de la configuración de prueba de voz TestConfig1 como 14255551212. Este es el número que se comprobará con la directiva de voz y la ruta para garantizar que la normalización se realiza correctamente y asegurar que se usan las rutas y planes de marcado correctos.
-------------------------- Ejemplo 2 --------------------------
Set-CsVoiceTestConfiguration -Identity TestConfig1 -TargetDialplan site:Redmond1 -ExpectedTranslatedNumber "+912065551212"
En este ejemplo, se modifican los parámetros de la configuración de prueba de voz TestConfig1. El comando define el valor de TargetDialplan como el plan de marcado de site:Redmond1. Como un cambio en el plan de marcado podría suponer un cambio en las reglas de normalización, también se ha cambiado el valor ExpectedTranslationNumber para reflejar lo que se espera de las reglas de normalización del plan de marcado.