New-CsVoiceTestConfiguration
Última modificación del tema: 2012-03-27
Crea una situación de prueba que puede usar para probar números de teléfono con rutas y reglas especificadas.
Sintaxis
New-CsVoiceTestConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
New-CsVoiceTestConfiguration -Name <String> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 resultados óptimos. Puede hacerlo creando situaciones de prueba con este cmdlet.
El cmdlet New-CsVoiceTestConfiguration define la ruta de voz, el uso, el plan de marcado y la directiva de voz con los que se probará un número de teléfono específico. Toda esta información puede definirse y recuperarse usando otros cmdlet. Consulte las descripciones de parámetros de este tema si desea más información.
Las configuraciones creadas con este cmdlet se prueban con el cmdlet Test-CsVoiceTestConfiguration.
Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet New-CsVoiceTestConfiguration: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsVoiceTestConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
XdsGlobalRelativeIdentity |
Una cadena que identifica de manera única esta situación de prueba. La cadena puede tener una longitud de hasta 32 caracteres y contener caracteres alfanuméricos, además de barras diagonales inversas (\), puntos (.) o caracteres de subrayado (_). El valor de este parámetro no incluye el ámbito, porque este objeto sólo puede crearse en el ámbito global. Por lo tanto, sólo se necesita un nombre único. |
Name |
Requerido |
Cadena de caracteres |
Este parámetro contiene el mismo valor que Identity. Si se ha especificado el parámetro Identity, no podrá incluir el parámetro Name en el comando. De la misma forma, si se ha especificado el parámetro Name, no podrá especificar el parámetro Identity. |
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. Valor predeterminado: 1234 |
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 generará un error. 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. Valor predeterminado: +1234 |
ExpectedUsage |
Opcional |
Cadena de caracteres |
El nombre del uso de RCT que se va a usar durante la prueba de configuración. Si se usa otra PSTN, basada en el plan de marcado de destino y la directiva de voz, la prueba generará un error. Puede recuperar los usos disponibles llamando 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 mediante una llamada al cmdlet Get-CsDialPlan. Debe tener 40 caracteres o menos. Valor predeterminado: Global |
TargetVoicePolicy |
Opcional |
Cadena de caracteres |
La identidad de la directiva de voz con la que se realiza la prueba. Las directivas de voz pueden recuperarse llamando a Get-CsVoicePolicy. Debe tener 40 caracteres o menos. Valor predeterminado: Global |
Force |
Opcional |
Parámetro modificador |
Suprime los mensajes de confirmación que, de lo contrario, se mostrarí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.TestConfiguration.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1
En este ejemplo se crea una configuración de prueba de voz con los valores predeterminados con la identidad TestConfig1.
-------------------------- Ejemplo 2 --------------------------
New-CsVoiceTestConfiguration TestConfig1 -TargetDialplan site:Redmond1
En este ejemplo se crea una configuración de prueba de voz denominada TestConfig1 y se define el parámetro TargetDialplan como site:Redmond1. Como resultado, el número, el uso y la ruta esperados se probarán con la configuración del plan de marcado del sitio de Redmond1.
En este ejemplo, se ha declarado TestConfig1 sin especificar el parámetro Identity. Identity es un parámetro de posición, de modo que el cmdlet reconoce como identidad el primer valor del comando que sigue al nombre de cmdlet.
-------------------------- Ejemplo 3 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212
En este ejemplo se crea una configuración de prueba de voz denominada TestConfig1. Esta configuración usará los valores predeterminados para probar el valor de DialedNumber 5551212 con un resultado esperado (ExpectedTranslatedNumber) de +5551212. Esta expectativa se basa en las reglas de normalización asociadas al plan de marcado que se usará para realizar pruebas con este objeto. La prueba debe realizarse usando el cmdlet Test-CsVoiceTestConfiguration.