Compartilhar via

  • Artigo

Set-CsVoiceConfiguration

 

Tópico modificado em: 2012-03-26

Modifica uma lista de configurações de teste de voz.

Sintaxe

Set-CsVoiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsVoiceConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VoiceTestConfigurations <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

As configurações de teste de voz são usadas para testar um número de telefone em relação a uma política de voz, rota e plano de discagem específico. Este cmdlet pode ser usado para modificar configurações de teste de voz de uma lista contendo todas as configurações de teste de voz para uma implantação do Microsoft Lync Server 2010.

Esse cmdlet modifica um objeto do tipo VoiceConfiguration. Esse objeto é simplesmente um objeto de contêiner para configurações de testes de voz. Portanto, o uso deste cmdlet não é recomendável. Para modificar as configurações de voz, modifique as configurações de teste de voz individuais chamando o cmdlet Set-CsVoiceTestConfiguration.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsVoiceConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Cadeia de caracteres

O escopo deste objeto. O único valor possível para este parâmetro é Global.

Instance

Opcional

VoiceConfiguration

Uma referência a um objeto de configuração de voz (Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration). Um objeto desse tipo pode ser recuperado chamando-se o cmdlet Get-CsVoiceConfiguration.

VoiceTestConfigurations

Opcional

PSListModifier

Uma lista de todas as configurações de teste de voz (objetos Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration) definidas para a implantação do Lync Server 2010.

Você pode modificar objetos de configuração de teste de voz usando o cmdlet Set-CsVoiceTestConfiguration. Está é a maneira recomendada para modificar configurações nesta lista.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration. Aceita entrada canalizada de um objeto de configuração de voz.

Tipos de Retorno

Set-CsVoiceConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoiceConfiguration.

Exemplo

-------------------------- Exemplo 1 --------------------------

$a = Get-CsVoiceConfiguration
$b = $a.VoiceTestConfigurations | Where-Object {$_.Name -eq "TestConfig2"}
$b.DialedNumber = 5551212
$b.ExpectedTranslatedNumber = +5551212
Set-CsVoiceConfiguration -Instance $a

São necessárias diversas etapas para modificar uma configuração de voz de teste em uma configuração de voz. Neste exemplo, iniciamos por recuperar o objeto de configuração de voz, chamando Get-CsVoiceConfiguration. Atribuímos o objeto recuperado (haverá somente um) à variável $a.

Na linha 2 desse exemplo, recuperamos o conteúdo da propriedade VoiceTestConfigurations, que é uma coleção de objetos de configuração de teste de voz, da variável $a. Em seguida, canalizamos essa coleção para o cmdlet Where-Object, no qual pesquisamos na coleção o objeto de configuração de teste de voz cujo Name for igual à cadeia de caracteres TestConfig2. Atribuímos este objeto à variável $b.

Depois, modificamos o objeto configuração de teste de voz TestConfig2 atribuindo novos valores para as propriedades DialedNumber e ExpectedTranslatedNumber. Ao atualizar este objeto, atualizamos o objeto na variável $a. No entanto, este objeto ainda está apenas na memória. Na etapa final, precisamos salvar estas alterações, passando $a para o parâmetro Instance de Set-CsVoiceConfiguration.

Esta não é a maneira recomendada de modificar uma configuração de voz. Para modificar uma configuração de voz, altere as configurações de teste de voz individuais com a propriedade Set-CsVoiceTestConfiguration, conforme mostrado aqui:

Set-CsVoiceTestConfiguration -Identity TestConfig2 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212

Esta linha realizará a mesma tarefa exibida no Exemplo 1.