Get-CsAudioTestServiceApplication
Última modificación del tema: 2012-03-23
Permite devolver información acerca de los contactos de la aplicación del servicio de prueba de audio que se usa en la organización.
Sintaxis
Get-CsAudioTestServiceApplication [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
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 ficha 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 a un contacto de la aplicación del servicio de prueba de audio. Se responderá la llamada y, después de reproducir una indicación introductoria, se solicitará a la persona que llama que grabe un breve mensaje. Se volverá a reproducir la grabación, y el autor de la llamada podrá oír su grabación en la conexión actual.
En parte, el servicio de prueba de audio depende de los objetos de contacto de Active Directory. Estos objetos se crean automáticamente al instalar Bot para audio; no existe un modo de crear estos objetos 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 pueden usar el cmdlet Set-CsAudioTestServiceApplication para modificar las propiedades de estos contactos.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Get-CsAudioTestServiceApplication de forma local: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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-CsAudioTestServiceApplication"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Parámetro de Id. de usuario |
Dirección SIP del contacto de servicio de prueba de audio. |
Credential |
Opcional |
Objeto PSCredential |
Permite ejecutar el cmdlet con credenciales alternativas. Esto puede ser necesario si la cuenta usada para iniciar sesión en Windows no tiene los privilegios necesarios para trabajar con objetos de contacto. Para usar el parámetro Credential, primero debe crear un objeto PSCredential con el cmdlet Get-Credential. Si necesita información detallada, consulte el tema de ayuda del cmdlet Get-Credential. |
DomainController |
Opcional |
FQDN |
Permite conectarse al controlador de dominio especificado para recuperar información de contactos. Para conectarse a un controlador de dominio específico, debe incluir el parámetro DomainController seguido del nombre del equipo (por ejemplo, atl-cs-001) o su nombre de dominio completo (FQDN) (por ejemplo, atl-cs-001.litwareinc.com). |
Filter |
Opcional |
Cadena de caracteres |
Permite limitar los datos que se devuelven filtrando los atributos específicos de Lync Server 2010. Por ejemplo, puede limitar los datos devueltos a objetos de contacto de prueba de audio que tienen un nombre para mostrar específico o usan un lenguaje determinado. El parámetro Filter usa la misma sintaxis de filtrado de Windows PowerShell que usa el cmdlet Where-Object. Por ejemplo, un filtro que solo devuelva contactos con el nombre para mostrar Contactos del servicio de prueba de audio tendrá la apariencia siguiente, donde DisplayName representa el atributo de Active Directory, -eq representa el operador de comparación (igual a) y "Audio Test Service Contact" representa el valor del filtro: -Filter {DisplayName -eq "Audio Test Service Contact"} No se pueden usar los parámetros –Identity y –Filter en el mismo comando. |
OU |
Opcional |
Nombre distintivo de Active Directory |
Permite devolver los contactos de una unidad organizativa (OU) de Active Directory específica. El parámetro OU devuelve datos de la unidad organizativa principal especificada y cualquier otra OU que contenga. Por ejemplo, si la OU Finance contiene dos unidades organizativas (por ejemplo, AccountsPayable y AccountsReceivable), se devolverán usuarios de las tres unidades organizativas. Al especificar una OU, use el nombre distintivo (DN) del contenedor; por ejemplo: -OU "OU=Finance,dc=litwareinc,dc=com". |
ResultSize |
Opcional |
Entero |
Permite restringir el número de registros que devuelve un comando. Por ejemplo, para devolver siete usuarios (al margen de la cantidad de usuarios que haya en el bosque), incluya el parámetro ResultSize y configure el valor de parámetro como 7. Tenga en cuenta que no es posible especificar qué siete usuarios se devolverán. Si se define ResultSize como 7, pero solo tiene tres usuarios en el bosque, el comando devolverá esos tres usuarios y luego se completará sin errores. El tamaño del resultado puede definirse en cualquier número entero entre 0 y 2147483647, ambos incluidos. Si se establece en 0, el comando se ejecutará pero no devolverá datos. |
Tipos de entrada
Ninguno.
Tipos de valores devueltos
Get-CsAudioTestServiceApplication devuelve instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsAudioTestServiceApplication
En el ejemplo anterior, se llama a Get-CsAudioTestServiceApplication sin parámetros adicionales para devolver una recopilación de todos los contactos de servicio de prueba de audio que, actualmente, se usan en la organización.
-------------------------- Ejemplo 2 ------------------------
Get-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com"
En el Ejemplo 2, se devuelve un solo contacto de servicio de prueba de audio: el contacto que tiene la Identity sip:RedmondAudioTest@litwareinc.com.
-------------------------- Ejemplo 3 ------------------------
Get-CsAudioTestServiceApplication -Filter {DisplayName -like "*Redmond*"}
En el Ejemplo 3, se devuelven todos los contactos del servicio de prueba de audio que tienen un nombre para mostrar que incluye el valor de cadena "Redmond". Para ello, el comando usa el parámetro Filter y el valor de filtro {DisplayName –like "*Redmond*"}; ese valor de filtro limita los datos devueltos a los contactos que tienen un nombre para mostrar que incluye el valor de cadena "Redmond". Este comando devuelve los contactos con nombres para mostrar como "Contacto de servicio de prueba de audio Redmond", "Audio Bot de Redmond" y "Contacto de prueba para Redmond".