New-CsVoiceTestConfiguration
Tópico modificado em: 2012-03-27
Cria uma situação de teste que pode ser utilizada para testar números de telefone quanto a rotas e regras especificadas.
Sintaxe
New-CsVoiceTestConfiguration -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
New-CsVoiceTestConfiguration -Name <String> [-Confirm [<SwitchParameter>]] [-DialedNumber <String>] [-ExpectedRoute <String>] [-ExpectedTranslatedNumber <String>] [-ExpectedUsage <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-TargetDialplan <String>] [-TargetVoicePolicy <String>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Antes de implementar as rotas de voz e as políticas de voz, deve-se testá-las em vários números de telefone para garantir que os resultados sejam os esperados. Este teste pode ser feito ao se criar situações de teste com este cmdlet.
O cmdlet New-CsVoiceTestConfiguration define a rota de voz, o uso, o plano de discagem e a política de voz contra os quais testar um número de telefone especificado. Todas estas informações podem ser definidas e recuperadas usando-se outros cmdlets. Para obter mais informações, consulte as descrições sobre parâmetros, neste tópico.
As configurações criadas com este cmdlet são testadas usando-se o cmdlet Test-CsVoiceTestConfiguration.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsVoiceTestConfiguration 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 "New-CsVoiceTestConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsGlobalRelativeIdentity |
Uma cadeia de caracteres que identifica unicamente este cenário de teste. Esta cadeia de caracteres pode ter até 32 caracteres de comprimento e conter qualquer caractere alfanumérico, além da barra invertida (\), do ponto (.) e do sublinhado (_). 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 único é necessário. |
Name |
Obrigatório |
Cadeia de caracteres |
Este parâmetro contém o mesmo valor que a Identidade. Se o parâmetro de Identidade for especificado, você não pode incluir o parâmetro Nome no seu comando. Do mesmo modo, se o parâmetro Nome for especificado, você não pode especificar uma Identidade. |
DialedNumber |
Opcional |
Cadeia de caracteres |
O número de telefone que você deseja usar para testar as políticas, os usos, etc. Deve ter 512 caracteres ou menos. Padrão: 1234 |
ExpectedRoute |
Opcional |
Cadeia de caracteres |
O nome da rota de voz que se espera utilizar durante o teste de configuração. Se for utilizada uma outra rota, com base no plano de discagem de destino e na política de voz, o teste falhará. Você pode recuperar as rotas de voz disponíveis chamando o cmdlet Get-CsVoiceRoute. Deve ter 256 caracteres ou menos. |
ExpectedTranslatedNumber |
Opcional |
Cadeia de caracteres |
O número de telefone no formato que você espera vê-lo depois da tradução. Este é o valor do parâmetro DialedNumber após a normalização. Se Test-CsVoiceTestConfiguration for executado e DialedNumber não resultar no valor em ExpectedTranslatedNumber, o teste notificará uma falha. Deve ter 512 caracteres ou menos. Padrão: +1234 |
ExpectedUsage |
Opcional |
Cadeia de caracteres |
O nome do Uso da PSTN que se espera utilizar durante o teste de configuração. Se for utilizado um outro uso da PSTN, com base no plano de discagem de destino e na política de voz, o teste falhará. É possível recuperar os usos disponíveis chamando-se Get-CsPstnUsage. Deve ter 256 caracteres ou menos. |
TargetDialplan |
Opcional |
Cadeia de caracteres |
A Identidade do plano de discagem a ser usado neste teste. Os planos de discagem podem ser recuperados chamando-se o cmdlet Get-CsDialPlan. Deve ter 40 caracteres ou menos. Padrão: Global |
TargetVoicePolicy |
Opcional |
Cadeia de caracteres |
A Identidade da política de voz em relação à qual este teste será executado. As políticas de voz podem ser recuperadas chamando-se Get-CsVoicePolicy. Deve ter 40 caracteres ou menos. Padrão: Global |
Force |
Opcional |
SwitchParameter |
Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações. |
InMemory |
Opcional |
SwitchParameter |
Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet. |
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
Nenhuma.
Tipos de Retorno
Este cmdlet apaga um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration
Exemplo
-------------------------- Exemplo 1 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1
Este exemplo cria uma nova configuração de teste de voz com valores padrão que possuem a Identidade TestConfig1.
-------------------------- Exemplo 2 --------------------------
New-CsVoiceTestConfiguration TestConfig1 -TargetDialplan site:Redmond1
Este exemplo cria uma nova configuração de teste de voz, denominada TestConfig1, e define o parâmetro TargetDialplan como site:Redmond1. Isto resultará nos testes de número esperado, uso, e rota a ser executada em relação às definições do plano de discagem do site Redmond1.
Neste exemplo, declaramos TestConfig1 sem especificar o parâmetro Identidade. Identidade é um parâmetro posicional, portanto, o primeiro valor no comando depois do nome do cmdlet é reconhecido pelo cmdlet como a Identidade.
-------------------------- Exemplo 3 --------------------------
New-CsVoiceTestConfiguration -Identity TestConfig1 -DialedNumber 5551212 -ExpectedTranslatedNumber +5551212
Este exemplo cria um nova configuração de teste de voz, denominada TestConfig1. Esta configuração usará os valores padrão para testar DialedNumber 5551212 em relação a uma saída esperada (ExpectedTranslatedNumber) de 5551212. Esta expectativa é baseada nas regras de normalização associadas ao plano de discagem que será usado quando se executar um teste em relação a este objeto. Esse teste deve ser executado usando-se o cmdlet Test-CsVoiceTestConfiguration.