Get-CsAudioTestServiceApplication
Tópico modificado em: 2012-03-23
Permite retornar informações sobre o aplicativo de serviço de Teste de Áudio em uso na sua organização.
Sintaxe
Get-CsAudioTestServiceApplication [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
Descrição Detalhada
O serviço de Teste de Áudio permite que os usuários do Microsoft Lync 2010 testem suas conexões de voz antes de realizar uma chamada. Para fazer isso, os usuários clicam no botão Verificar qualidade da chamada localizado na guia Dispositivo de áudio da caixa de diálogo Opções do Lync 2010. Quando um usuário clica nesse botão, é realizada uma chamada para o serviço automatizado de teste de áudio. A chamada será atendida e, após um aviso introdutório ser reproduzido, a pessoa que chamou será solicitada a gravar uma mensagem breve. Essa gravação será então reproduzida, permitindo que a pessoa que chamou verifique o som de sua voz na conexão atual.
O serviço de Teste de Áudio depende, em parte, dos objetos de contato do Active Directory. Esses objetos são criados automaticamente quando você instala o Bot de Áudio; não há necessidade de criar manualmente esses objetos. Entretanto, os administradores podem usar o cmdlet Get-CsAudioTestServiceApplication para recuperar informações sobre os vários contatos do serviço de teste em uso na organização. Os administradores também podem usar Set-CsAudioTestServiceApplication para modificar as propriedades desses contatos.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsAudioTestServiceApplication localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAudioTestServiceApplication"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Parâmetro User ID |
Endereço SIP do contato do serviço de teste de áudio. |
Credential |
Opcional |
Objeto PS Credential |
Permite que você execute o cmdlet usando credenciais alternativas. Isto poderia ser necessário se a conta que você usou para fazer logon no Windows não tiver os privilégios necessários para trabalhar com objetos de contato. Para usar o parâmetro de Credencial, você deve criar primeiro um objeto PSCredential usando o cmdlet Get-Credential. Para obter detalhes, consulte o tópico de Ajuda do cmdlet Get-Credential. |
DomainController |
Opcional |
FQDN |
Permite que você se conecte a um controlador de domínio especificado para recuperar informações de contato. Para conectar a um determinado controlador de domínio, inclua o parâmetro DomainController seguido pelo nome de computador (por exemplo, atl-cs-001) ou o seu FQDN (nome de domínio totalmente qualificado); por exemplo, atl-cs-001.litwareinc.com. |
Filter |
Opcional |
Cadeia de caracteres |
Permite limitar os dados retornados filtrando em atributos específicos do Lync Server 2010. Por exemplo, você pode limitar os dados retornados a objetos de contato de teste de áudio que possuam um nome para exibição específico ou que usem um idioma específico. O parâmetro com Filtro usa o mesmo filtro de sintaxe Windows PowerShell usado pelo cmdlet Where-Object. Por exemplo, um filtro para retornar somente contatos com nome para exibição Audio Test Service Contacts seria parecido com o que veremos a seguir, com DisplayName representando o atributo do Active Directory, -eq representando o operador de comparação (igual a) e "Audio Test Service Contact" representando o valor do filtro: -Filter {DisplayName -eq "Audio Test Service Contact"} Você não pode usar ambos os parâmetros Filter e Identity no mesmo comando. |
OU |
Opcional |
Nome diferenciado do Active Directory |
Permite retornar contatos de uma OU (unidade organizacional) do Active Directory específica. O parâmetro OU retorna dados da OU especificada e de qualquer de suas OUs filhas. Por exemplo, se a OU Finance tiver duas OUs filhas, AccountsPayable e AccountsReceivable, os dados retornados incluirão usuários de cada uma dessas três OUs. Ao especificar uma OU, use o DN (nome diferenciado) do contêiner em questão; por exemplo: -OU "OU=Finance,dc=litwareinc,dc=com". |
ResultSize |
Opcional |
Inteiro |
Permite limitar o número de registros retornados por um comando. Por exemplo, para retornar sete usuários (independentemente de quantos usuários existam na sua floresta), inclua o parâmetro ResultSize e defina o valor de parâmetro como 7. Observe que não há nenhum modo de garantir quais sete usuários serão retornados. Se definir ResultSize como 7, mas houver apenas três usuários em sua floresta, o comando retornará esses três usuários e, em seguida, será concluído sem erros. O tamanho do resultado pode ser definido com qualquer número inteiro entre 0 e 2147483647, inclusive. Se for definido com 0, o comando será executado mas nenhum dado será retornado. |
Tipos de Entrada
Nenhuma.
Tipos de Retorno
Get-CsAudioTestServiceApplication retorna instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsAudioTestServiceApplication
No exemplo anterior, Get-CsAudioTestServiceApplication é chamado sem qualquer parâmetro adicional a fim de retornar uma coleção de todos os contatos do serviço de Teste de Áudio em uso na organização.
-------------------------- Exemplo 2 ------------------------
Get-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com"
No Exemplo 2, um único contato do serviço de Teste de Áudio é retornado: o contato que possui identidade igual a sip:RedmondAudioTest@litwareinc.com.
-------------------------- Exemplo 3 ------------------------
Get-CsAudioTestServiceApplication -Filter {DisplayName -like "*Redmond*"}
O Exemplo 3 retorna todos os contatos de serviço de Teste de Áudio que tenham um nome para exibição que inclua o valor de cadeia de caracteres "Redmond". Para fazer isto, o comando usa o parâmetro Filter e o valor de filtro {DisplayName –like "*Redmond*"}; esse valor de filtro limita os dados retornados aos contatos que tenham nome para exibição que inclua o valor de cadeia de caracteres "Redmond". Este comando retorna contatos com nome para exibição como "Redmond Audio Test Service Contact", "Redmond Audio Bot" e "Test Contact for Redmond".