Set-CsVoiceConfiguration
Última modificación del tema: 2012-03-26
Modifica una lista de configuraciones de prueba de voz.
Sintaxis
Set-CsVoiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Las configuraciones de prueba de voz se usan para probar un número de teléfono con una directiva de voz, una ruta y un plan de marcado específicos. Este cmdlet se puede usar para modificar configuraciones de prueba de voz de una lista que contenga todas las configuraciones de prueba de voz de una instalación de Microsoft Lync Server 2010.
Este cmdlet modifica un objeto del tipo VoiceConfiguration. Este objeto es simplemente un objeto contenedor para las configuraciones de prueba de voz. Por tanto, no se recomienda el uso de este cmdlet. Para modificar las configuraciones de voz, modifique las configuraciones de prueba de voz por separado llamando al cmdlet Set-CsVoiceTestConfiguration.
Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Set-CsVoiceConfiguration: 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 "Set-CsVoiceConfiguration"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Cadena de caracteres |
El ámbito de este objeto. El único valor posible para este parámetro es Global. |
Instance |
Opcional |
VoiceConfiguration |
Una referencia a un objeto de configuración de voz (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration). Un objeto de este tipo puede recuperarse llamando al cmdlet Get-CsVoiceConfiguration. |
VoiceTestConfigurations |
Opcional |
Modificador de lista PS |
Una lista de todas las configuraciones de prueba de voz (objetos Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration) definidas para la instalación de Lync Server 2010. Para modificar los objetos de configuración de prueba de voz uno a uno, use el cmdlet Set-CsVoiceTestConfiguration. Se trata del método recomendado para modificar configuraciones de esta lista. |
Force |
Opcional |
Parámetro modificador |
Suprime los mensajes 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.VoiceConfiguration. Acepta la entrada transferida de un objeto de configuración de voz.
Tipos de valores devueltos
Set-CsVoiceConfiguration no devuelve un valor u objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
$a = Get-CsVoiceConfiguration
$b = $a.VoiceTestConfigurations | Where-Object {$_.Name -eq "TestConfig2"}
$b.DialedNumber = 5551212
$b.ExpectedTranslatedNumber = +5551212
Set-CsVoiceConfiguration -Instance $a
Para modificar una configuración de voz de prueba en una configuración de voz, se deben seguir varios pasos. En este ejemplo, se empieza recuperando el objeto de configuración de voz llamando a Get-CsVoiceConfiguration. A continuación, se asigna el objeto recuperado (sólo habrá uno) a la variable $a.
En la línea 2 de este ejemplo, recuperamos el contenido de la propiedad VoiceTestConfigurations, que es una colección de objetos de configuración de pruebas de voz, de la variable $a. A continuación, transferimos esa colección al cmdlet Where-Object, donde buscamos la colección del objeto de configuración de prueba de voz cuyo nombre sea igual a la cadena de caracteres TestConfig2. El objeto se asigna a la variable $b.
A continuación, se modifica el objeto de configuración de prueba de voz TestConfig2 asignando valores nuevos a las propiedades DialedNumber y ExpectedTranslatedNumber. Al actualizar el objeto, también se actualiza el objeto que se encuentra en la variable $a. Sin embargo, dicho objeto sigue estando únicamente en la memoria. El último paso consiste en guardar los cambios enviando la variable $a al parámetro Instance de Set-CsVoiceConfiguration.
Éste no es el método recomendado para modificar una configuración de voz. Para modificar una configuración de voz, cambie cada una de las configuraciones de prueba de voz mediante la propiedad Set-CsVoiceTestConfiguration, como se muestra a continuación:
Set-CsVoiceTestConfiguration -Identity TestConfig2 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212
Esta línea llevará a cabo la misma acción que se ha explicado en el Ejemplo 1.