Set-CsAudioTestServiceApplication

 

Tópico modificado em: 2012-03-27

Permite modificar os valores de propriedades de qualquer contato de aplicativo de serviço de teste de áudio em uso na organização. UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)

Sintaxe

Set-CsAudioTestServiceApplication -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-Enabled <$true | $false>] [-EnabledForFederation <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-ExchangeArchivingPolicy <Uninitialized | UseLyncArchivingPolicy | NoArchiving | ArchivingToExchange>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-SecondaryLanguages <MultiValuedProperty>] [-SipAddress <String>] [-Type <String>] [-WhatIf [<SwitchParameter>]]

Exemplos

EXEMPLO 1

No Exemplo 1, o idioma principal de contato do serviço Teste de áudio sip:RedmondAudioTest@litwareinc.com é definido como inglês norte-americano (en-US).

Set-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com" -PrimaryLanguage "en-US" 

EXEMPLO 2

O Exemplo 2 limpa o valor da propriedade PrimaryLanguage do contato do serviço Teste de áudio (sip:RedmondAudioTest@litwareinc.com). Isso é realizado incluindo-se o parâmetro PrimaryLanguage e definindo-se o valor do parâmetro como $Null.

Set-CsAudioTestServiceApplication -Identity "sip:RedmondAudioTest@litwareinc.com" -PrimaryLanguage $Null 

EXEMPLO 3

No Exemplo 3, todos os contatos do serviço de Teste de Áudio em uso na organização estão configurados para usar o inglês norte-americano como o idioma principal. Para isso, o cmdlet Get-CsAudioTestServiceApplication é chamado primeiro, sem qualquer parâmetro, para retornar uma coleção dos contatos do serviço de Teste de Áudio. Esta coleção é então canalizada ao cmdlet Set-CsAudioTestServiceApplication, que atribui o inglês norte-americano (en-Us) à propriedade PrimaryLanguage de cada contato da coleção.

Get-CsAudioTestServiceApplication | Set-CsAudioTestServiceApplication -PrimaryLanguage "en-US"

Descrição Detalhada

O Serviço de teste de áudio permite que os usuários do Lync Server testem as suas conexões de voz antes de realizarem uma chamada de voz. Para fazer isso, os usuários clicam no botão Verificar a qualidade da chamada, na guia Dispositivo de áudio da caixa de diálogo Opções do Lync. Quando um usuário clicar nesse botão, será feita uma chamada para o serviço automatizado de testes de áudio. A chamada será atendida e, depois da reprodução de uma solicitação introdutória, o chamador precisará gravar uma mensagem breve (dez segundos, no máximo). Essa gravação será então reproduzida, permitindo que o chamador ouça como ele soaria na conexão em uso.

O serviço de Teste de Áudio se baseia, em parte, em objetos de contato do Active Directory. Esses objetos são criados automaticamente quando você instala o Bot de Áudio. Não é possível criar manualmente esses objetos. No entanto, os administradores podem usar o cmdlet Get-CsAudioTestServiceApplication para recuperar as informações sobre os vários contatos do serviço de teste em uso na organização. Os administradores também podem usar o cmdlet Set-CsAudioTestServiceApplication para modificar as propriedades desses contatos.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsAudioTestServiceApplication localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAudioTestServiceApplication"}

Parâmetros

Parâmetro	Obrigatório	Digite	Descrição
Identity	Obrigatório	Microsoft.Rtc.Management.AD.UserIdParameter	Endereço SIP do contato de serviço de teste de áudio a ser modificado.
Confirm	Opcional	System.Management.Automation.SwitchParameter	Solicita confirmação antes da execução do comando.
DisplayName	Opcional	System.String	Nome de exibição do objeto de contato no Active Directory.
DisplayNumber	Opcional	System.String	Embora seja uma propriedade válida, DisplayNumber não é usada com o serviço Teste de áudio.
Enabled	Opcional	System.Boolean	Indica se o objeto de contato foi habilitado ou não para o Lync Server. Se você estabelecer este valor como False ($False), o contato não poderá mais fazer o logon no Lync Server. A definição deste valor como True ($True) reabilitará os privilégios de logon do contato.
EnabledForFederation	Opcional	System.Boolean	Indica se esse contato estará disponível para usuários de um domínio federado. Se for definido como False, somente os usuários de dentro da organização terão acesso ao contato.
EnterpriseVoiceEnabled	Opcional	System.Boolean	Indica se o objeto de contato foi habilitado para o Enterprise Voice, a implementação de VoIP da Microsoft. Com o Enterprise Voice, os usuários podem fazer chamadas telefônicas usando a Internet em vez de usar a rede telefônica padrão.
ExchangeArchivingPolicy	Opcional	Microsoft.Rtc.Management.ADConnect.Core.ExchangeArchivingPolicyOptionsEnum	Indica se as sessões de mensagem instantânea do contato foram arquivadas. Os valores permitidos são: * Uninitialized * UseLyncArchivingPolicy * ArchivingToExchange * NoArchiving
LineURI	Opcional	System.String	Embora seja uma propriedade válida, LineUri não é usada com o serviço Teste de áudio.
PassThru	Opcional	System.Management.Automation.SwitchParameter	Permite passar um objeto de usuário através do pipeline que representa o usuário ao qual será atribuída a política. Por padrão, o cmdlet Set-CsAudioTestServiceApplication não canaliza objetos.
PrimaryLanguage	Opcional	System.String	Idioma principal usado no serviço de teste de áudio. O idioma deve ser configurado usando-se um dos códigos de idioma permitidos. Por exemplo: en-US, para inglês dos EUA, fr-FR, para francês, etc. Para retornar uma lista dos códigos de idioma disponíveis, digite o seguinte comando no prompt do Windows PowerShell: Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages.
SecondaryLanguages	Opcional	Microsoft.Rtc.Management.ADConnect.Core.MultiValuedProperty	Embora seja uma propriedade válida, SecondaryLanguages não é usada com o serviço Teste de áudio.
SipAddress	Opcional	System.String	Este parâmetro está desabilitado. Você não consegue alterar o endereço SIP usando Set-CsAudioTestServiceApplication.
Type	Opcional	System.String	Indica o tipo de contato de teste a ser implantado. Por padrão, os contatos são listados como Automaton, indicando que podem interagir com os chamadores.
WhatIf	Opcional	System.Management.Automation.SwitchParameter	Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Tipos de Entrada

O cmdlet Set-CsAudioTestServiceApplication aceita instâncias por pipeline do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADApplicationContact.

Tipos de Retorno

O cmdlet Set-CsAudioTestServiceApplication não retorna nenhum objeto ou valor.

Consulte Também

Outros Recursos

Get-CsAudioTestServiceApplication