Set-CsVoiceTestConfiguration
Tópico modificado em: 2012-03-27
Modifica um cenário de teste que você pode usar para testar números de telefone contra rotas e regras especificadas.
Sintaxe
Set-CsVoiceTestConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
Set-CsVoiceTestConfiguration [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
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. Você pode fazer isto modificando cenários de teste com este cmdlet.
O cmdlet Set-CsVoiceTestConfiguration modifica a rota de voz, o uso, o plano de discagem e a diretiva de voz contra o qual um número de telefone especificado será testado. Todas estas informações podem ser definidas e recuperadas com outros cmdlets, conforme especificado nas descrições de parâmetro deste tópico.
As configurações modificadas com este cmdlet são testadas usando o cmdlet Test-CsVoiceTestConfiguration.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-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 "Set-CsVoiceTestConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Cadeia de caracteres |
Uma cadeia de caracteres que identifica unicamente a configuração de teste que você deseja recuperar. O valor deste parâmetro não inclui o escopo, pois este objeto só pode ser criado no escopo global. Por isso, só um nome é necessário. |
Instance |
Opcional |
TestConfiguration |
Um objeto de tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration que contém uma configuração de teste de voz existente com as modificações que você gostaria de fazer àquela configuração. Um objeto desse tipo pode ser recuperado com o cmdlet Get-CsVoiceTestConfiguraton. |
DialedNumber |
Opcional |
Cadeia de caracteres |
O número de telefone que você deseja usar para testar as diretivas, usos etc. Deve ser 512 caracteres ou menos. |
ExpectedRoute |
Opcional |
Cadeia de caracteres |
O nome da rota de voz esperada para ser usado durante o teste de configuração. Se uma rota diferente for usada, baseada no plano de discagem de destino e na diretiva de voz, o teste falhará. Você pode recuperar as rotas de voz disponíveis chamando o cmdlet Get-CsVoiceRoute. Deve ser 256 caracteres ou menos. |
ExpectedTranslatedNumber |
Opcional |
Cadeia de caracteres |
O número de telefone no formato que você espera vê-lo depois da conversão. Este é o valor do parâmetro DialedNumber após a normalização. Se você executar o Test-CsVoiceTestConfiguration e o DialedNumber não resultar no valor em ExpectedTranslatedNumber, o teste notificará como Falha. Deve ser 512 caracteres ou menos. |
ExpectedUsage |
Opcional |
Cadeia de caracteres |
O nome do uso de PSTN esperado para ser usado durante o teste de configuração. Se um uso de PSTN diferente for usado, baseado no plano de discagem de destino e na diretiva de voz, o teste falhará. Você pode recuperar usos disponíveis chamando Get-CsPstnUsage. Deve ser 256 caracteres ou menos. |
TargetDialplan |
Opcional |
Cadeia de caracteres |
A Identidade do plano de discagem a ser usado para este teste. Os planos de discagem podem ser recuperados chamando o cmdlet Get-CsDialPlan. Deve ser 40 caracteres ou menos. |
TargetVoicePolicy |
Opcional |
Cadeia de caracteres |
A Identidade da diretiva de voz contra a qual executar este teste. As diretiva de voz podem ser recuperadas chamando o Get-CsVoicePolicy. Deve ser 40 caracteres ou menos. |
Force |
Opcional |
SwitchParameter |
Suprime todos os avisos de confirmação que seriam exibidos antes que as alterações sejam feitas. |
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.TestConfiguration. Aceita entrada em pipeline de objetos de configuração de teste de voz.
Tipos de Retorno
Este cmdlet retorna um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration.
Exemplo
-------------------------- Exemplo 1 --------------------------
Set-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 14255551212
Este exemplo define o número discado da configuração de teste de voz para TestConfig1 como 14255551212. Este é o número que será verificado contra a diretiva de voz e rota para garantir que a normalização ocorra conforme esperado, bem como garantir que as rotas corretas e os planos de discagem estejam sendo aplicadas.
-------------------------- Exemplo 2 --------------------------
Set-CsVoiceTestConfiguration -Identity TestConfig1 -TargetDialplan site:Redmond1 -ExpectedTranslatedNumber "+912065551212"
Este exemplo modifica as definições da configuração de teste de voz TestConfig1. O comando define o TargetDialplan para o perfil de discagem para site:Redmond1. Como uma modificação no plano de discagem pode significar uma modificação em regras de normalização, o ExpectedTranslationNumber também foi modificado para refletir o que é esperado das regras de normalização daquele plano de discagem.