Test-CsVoiceTestConfiguration
Tópico modificado em: 2012-03-26
Execute as configurações da voz de teste para garantir que roteamento e diretivas de voz funcionem conforme esperado.
Sintaxe
Test-CsVoiceTestConfiguration -TestCaseInputObject <TestConfiguration> [-Dialplan <LocationProfile>] [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>] [-VoicePolicy <VoicePolicy>]
Test-CsVoiceTestConfiguration -DialedNumber <PhoneNumber> -Dialplan <LocationProfile> -VoicePolicy <VoicePolicy> [-Force <SwitchParameter>] [-RouteSettings <PstnRoutingSettings>]
Descrição Detalhada
Antes da implementação de rotas e diretivas de voz, é uma boa ideia testá-las em vários números de telefone para garantir que os resultados sejam os esperados. Executar este cmdlet com as configurações de parâmetro adequadas permite executar estes testes.
Este cmdlet testa um número de telefone em relação a uma rota de voz, uso, plano de discagem e política de voz para que você possa verificar os resultados pretendidos ou comparar o resultado real com o resultado esperado. As configurações de voz a serem testadas podem ser definidas digitando-se os parâmetros apropriados individualmente, ou usando o cmdlet New-CsVoiceTestConfiguration.
Se digitar valores para DialedNumber, DialPlan e VoicePolicy, a saída incluirá o número traduzido, a regra de normalização usada para criar a tradução, a rota usada e a utilização da PSTN. Se em vez disso você digitar um valor para o parâmetro TestCaseInputObject, será possível obter o status indicando se os resultados corresponderam aos resultados esperados que foram fornecidos ao objeto de teste quando você o criou com o cmdlet New-CsVoiceTestConfiguration.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Test-CsVoiceTestConfiguration localmente: RTCUniversalServerAdmins. 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 "Test-CsVoiceTestConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
DialedNumber |
Obrigatório |
PhoneNumber |
O número de telefone para realização do teste. Com base no plano de discagem, rota e diretiva, esse número será normalizado e exibido como saída. O parâmetro será obrigatório a menos que o parâmetro TestCaseInputObject seja fornecido com um valor. Não é possível fornecer DialedNumber e TestCaseInputObject. (TestCaseInputObject já contém DialedNumber dentro desse objeto.) |
Dialplan |
Obrigatório |
LocationProfile |
Uma referência a um objeto do plano de discagem do plano a ser usada durante a execução do teste. Os objetos do plano de discagem podem ser recuperados chamando-se o cmdlet Get-CsDialPlan. Esse parâmetro será obrigatório se você também especificou o parâmetro DialedNumber. Não use esse parâmetro caso você esteja usando o parâmetro TestCaseInputObject. Se usá-lo, o objeto nesse parâmetro deverá corresponder ao plano de discagem especificado em TestCaseInputObject, usando esse parâmetro redundante. |
TestCaseInputObject |
Obrigatório |
TestConfiguration |
Um objeto contendo uma referência à configuração de voz para teste. Essa referência de objeto pode ser recuperada chamando-se o cmdlet Get-CsVoiceTestConfiguration. Se você chamar o cmdlet com esse parâmetro, não será possível especificar DialedNumber. Você também não deve especificar Dialplan ou VoicePolicy, porque eles poderiam ser redundantes com os valores no objeto de configuração de teste da voz. |
VoicePolicy |
Obrigatório |
VoicePolicy |
Uma referência a um objeto de diretiva de voz da diretiva de voz a ser usada durante a realização do teste. Os objetos da diretiva de voz podem ser recuperados chamando-se o cmdlet Get-CsVoicePolicy. Esse parâmetro será obrigatório se você também especificou o parâmetro DialedNumber. Não use esse parâmetro caso você esteja usando o parâmetro TestCaseInputObject. Se você usá-lo, o objeto nesse parâmetro deverá corresponder à diretiva de voz especificada em TestCaseInputObject, usando esse parâmetro redundante. |
RouteSettings |
Opcional |
PstnRoutingSettings |
Uma referência a um objeto contendo todas as rotas de voz disponíveis na instalação do Microsoft Lync Server 2010. É possível recuperar esse objeto chamando-se o cmdlet Get-CsRoutingConfiguration. Você pode usar esse parâmetro com o parâmetro DialedNumber ou TestCaseInputObject. |
Force |
Opcional |
SwitchParameter |
Suprime todos os avisos de confirmação que seriam exibidos antes que as alterações sejam feitas. |
Tipos de Entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration. Aceita entrada em pipeline de um objeto de configuração de teste de voz.
Tipos de Retorno
Este cmdlet retorna um objeto do tipo Microsoft.Rtc.Management.Voice.OcsVoiceTestResult.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsVoiceTestConfiguration -Identity TestConfig1 | Test-CsVoiceTestConfiguration
Este exemplo executa um teste de configuração de voz em relação à configuração TestConfig1. Primeiro o cmdlet Get-CsVoiceTestConfiguration é executado para recuperar a configuração com a Identity TestConfig1. Em seguida, esse objeto de configuração é redirecionado ao cmdlet Test-CsVoiceTestConfiguration.
-------------------------- Exemplo 2 --------------------------
$a = Get-CsVoiceTestConfiguration -Identity TestConfig1
Test-CsVoiceTestConfiguration -TestCaseInputObject $a
O Exemplo 2 é idêntico ao Exemplo 1, exceto pelo objeto, que, em vez de redirecionar os resultados da operação Get diretamente ao cmdlet Test, será inicialmente armazenado na variável $a e, em seguida, passado como o valor para o parâmetro TestCaseInputObject a ser usado como a configuração de teste.
-------------------------- Exemplo 3 --------------------------
$dp = Get-CsDialPlan -Identity Global
$vp = Get-CsVoicePolicy -Identity Global
Test-CsVoiceTestConfiguration -DialedNumber 4255551212 -Dialplan $dp -VoicePolicy $vp
Este exemplo executa uma configuração de teste sem antes precisar defini-la com New-CsVoiceTestConfiguration. Em vez de passar um objeto TestConfiguration criado antecipadamente, este exemplo mostra como definir um teste instantaneamente especificando o número discado para teste e o plano de discagem, além da diretiva de voz para a realização do teste.
A primeira linha neste exemplo chama o cmdlet Get-CsDialPlan para recuperar o plano de discagem Global. O objeto do plano de discagem recuperado é atribuído à variável $dp. Na segunda linha, fazemos a mesma coisa com a diretiva de voz, chamando o cmdlet Get-CsVoicePolicy para recuperar a diretiva de voz Global e, em seguida, atribuindo essa diretiva à variável $vp.
Por fim, estamos prontos para realizar o teste. Chamamos Test-CsVoiceTestConfiguration, passando o número de telefone a ser testado para o parâmetro DialedNumber, o plano de discagem que recuperamos na linha 1 (armazenado em $dp) para o parâmetro Dialplan e a diretiva de voz que recuperamos na linha 2 (armazenada em $vp) para o parâmetro VoicePolicy.
Observe que a saída do Exemplo 3 não incluirá o status dos resultados esperados. Se quiser testar os resultados em relação às suas expectativas, defina as expectativas usando o cmdlet New-CsVoiceTestConfiguration e chame Test-CsVoiceTestConfiguration como mostrado nos Exemplos 1 e 2.