Set-CsAudioTestServiceApplication
Última modificación del tema: 2012-03-27
Permite modificar los valores de propiedad de cualquiera de los contactos de la aplicación de servicio de prueba de audio que están en uso en la organización.
Sintaxis
Set-CsAudioTestServiceApplication -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-CSEnabled <$true | $false>] [-DisplayName <String>] [-DisplayNumber <String>] [-EnabledForFederation <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Type <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El servicio de prueba de audio permite a los usuarios de Microsoft Lync 2010 probar sus conexiones de voz antes de realizar una llamada de voz. Para ello, los usuarios deben hacer clic en el botón Comprobar calidad de llamada de la pestaña Dispositivo de audio del cuadro de diálogo Opciones de Lync 2010. Cuando un usuario hace clic en este botón, se realiza una llamada al servicio de prueba de audio automatizado. La llamada recibe una respuesta y, tras la reproducción de una grabación introductoria, se pide al autor de la llamada que grabe un mensaje breve (de 10 segundos como máximo). Se volverá a reproducir la grabación, y el autor de la llamada podrá oír su grabación en la conexión actual.
El servicio de prueba de audio usa, entre otros, objetos de contacto de Active Directory. Estos objetos se crean automáticamente cuando se instala Bot para audio; no hay forma alguna de crearlos manualmente. Sin embargo, los administradores pueden usar el cmdlet Get-CsAudioTestServiceApplication para recuperar información acerca de los diversos contactos de servicio de prueba que actualmente se usan en la organización. Los administradores también pueden usar Set-CsAudioTestServiceApplication para modificar las propiedades de estos contactos.
Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Set-CsAudioTestServiceApplication: 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-CsAudioTestServiceApplication"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Parámetro UserID |
Dirección SIP del contacto del servicio de prueba de audio que se va a modificar. |
Enabled |
Opcional |
Booleano |
Indica si el objeto de contacto se ha habilitado para Lync Server 2010. Si se define este valor como falso ($False), el contacto no podrá iniciar sesión en Lync Server; si se define como verdadero ($True), se volverán a habilitar los privilegios de inicio de sesión del contacto. |
DisplayName |
Opcional |
Cadena de caracteres |
Nombre para mostrar de Active Directory del objeto de contacto. |
DisplayNumber |
Opcional |
Cadena de caracteres |
A pesar de ser una propiedad válida, DisplayNumber no se utiliza realmente con el servicio de prueba de audio. |
EnabledForFederation |
Opcional |
Booleano |
Indica si el contacto está disponible para los usuarios de un dominio federado. Si se establece en False, solo tendrán acceso al contacto los usuarios de la organización. |
EnterpriseVoiceEnabled |
Opcional |
Booleano |
Indica si el objeto de contacto se ha habilitado para Enterprise Voice, que es la implementación del protocolo Voz sobre IP (VoIP) de Microsoft. Con Enterprise Voice, los usuarios pueden hacer llamadas telefónicas a través de Internet, en lugar de usar la red telefónica estándar. |
LineUri |
Opcional |
Cadena de caracteres |
A pesar de ser una propiedad válida, LineUri no se utiliza realmente con el servicio de prueba de audio. |
PrimaryLanguage |
Opcional |
Cadena de caracteres |
Idioma principal usado para el servicio de prueba de audio. El idioma debe configurarse con uno de los códigos de idioma disponibles; por ejemplo, en-US para inglés de EE.UU., fr-FR para francés, etc. Para devolver una lista de los códigos de idioma disponibles, escriba el comando siguiente en el símbolo del sistema de Windows PowerShell: Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages. |
SecondaryLanguages |
Opcional |
Matriz de cadenas |
A pesar de ser una propiedad válida, SecondaryLanguages no se utiliza realmente con el servicio de prueba de audio. |
SipAddress |
Opcional |
Dirección SIP |
Identificador único que permite al objeto de contacto comunicarse usando dispositivos SIP como Lync 2010. La dirección SIP debe tener el prefijo "sip:". Por ejemplo: -SipAddress "sip:kenmyer@litwareinc.com". |
Type |
Opcional |
Cadena de caracteres |
Indica el tipo de contacto de prueba que se está implementando. De modo predeterminado, los contactos se enumeran como Automation, lo cual significa que pueden interactuar con los autores de las llamadas. |
PassThru |
Opcional |
Parámetro modificador |
Permite enviar un objeto de usuario a través de la canalización que representa el usuario al que se está asignando la directiva. De forma predeterminada, el cmdlet Set-CsAudioTestServiceApplication no envía objetos a través de la canalización. |
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
Set-CsAudioTestServiceApplication acepta instancias transferidas del objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Tipos de valores devueltos
Set-CsAudioTestServiceApplication no devuelve ningún objeto ni valor.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Set-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com" -PrimaryLanguage "en-US"
En el Ejemplo 1, el idioma principal del contacto de servicio de prueba de audio sip:RedmondAudioTest@litwareinc.com está establecido en inglés de EE.UU. (en-US).
-------------------------- Ejemplo 2 ------------------------
Set-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com" -PrimaryLanguage $Null
El ejemplo anterior borra el valor de la propiedad PrimaryLanguage del contacto de servicio de prueba de audio sip:RedmondAudioTest@litwareinc.com. Para ello, se incluye el parámetro PrimaryLanguage y se establece el valor del parámetro en $Null.
-------------------------- Ejemplo 3 ------------------------
Get-CsAudioTestServiceApplication | Set-CsAudioTestServiceApplication -PrimaryLanguage "en-US"
En el Ejemplo 3, todos los contactos de servicio de prueba de audio en uso en la organización se configuran para usar el inglés de EE.UU. como idioma principal. Para ello, primero se llama a Get-CsAudioTestServiceApplication sin ningún parámetro para devolver una colección de todos los contactos del servicio de prueba de audio. Esta colección se transfiere, a continuación, a Set-CsAudioTestServiceApplication, que asigna el inglés de EE.UU. (en-Us) a la propiedad PrimaryLanguage de cada uno de los contactos de la colección.