Compartilhar via

  • Artigo

Get-CsVoiceTestConfiguration

 

Tópico modificado em: 2012-03-23

Recupera uma situação de teste que pode ser utilizada para testar números de telefone concomitantemente a rotas e regras especificadas.

Sintaxe

Get-CsVoiceTestConfiguration [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsVoiceTestConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

Este cmdlet recupera a rota de voz, o uso, o plano de discagem e a política de voz em relação aos quais será testado um número de telefone especificado. 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. Você pode fazer este teste recuperando uma configuração de teste com este cmdlet e, em seguida, executar o cenário com o cmdlet Test-CsVoiceConfiguration.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsVoiceTestConfiguration localmente: RTCUniversalUserAdmins, 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 "Get-CsVoiceTestConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsGlobalRelativeIdentity

Uma cadeia de caracteres que identifica unicamente a configuração de teste que você deseja recuperar.

Filter

Opcional

Cadeia de caracteres

Este parâmetro permite fazer uma pesquisa utilizando caracteres curinga das configurações de testes de voz definidas (para obter mais detalhes, consulte os exemplos neste tópico).

LocalStore

Opcional

SwitchParameter

Recupera a configuração de teste de voz na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Retorna um ou mais objetos do tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.TestConfiguration.

Exemplo

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

Get-CsVoiceTestConfiguration

Recupera todas as definições de configuração de testes de voz.

-------------------------- Exemplo 2 --------------------------

Get-CsVoiceTestConfiguration | Select-Object Identity, DialedNumber, ExpectedTranslatedNumber

Este exemplo recupera todas as definições de configuração de testes de voz, exibindo apenas os parâmetros Identity, DialedNumber e ExpectedTranslatedNumber de cada um. As configurações retornadas por Get-CsVoiceTestConfiguration serão canalizadas para o cmdlet Select-Object, no qual a saída será restrita às propriedades Identity, DialedNumber e ExpectedTranslatedNumber.

-------------------------- Exemplo 3 --------------------------

Get-CsVoiceTestConfiguration -Filter *test*

Este exemplo usa o parâmetro Filtro para recuperar todas as definições de configuração de teste de voz com Identidades que contêm a cadeia de caracteres "test". Os caracteres curingas (*) no começo e no fim do valor com filtro indicam que a cadeia de caracteres "test" pode ser localizada em qualquer posição da Identidade, com qualquer caractere antes ou depois desta cadeia de caracteres. Por exemplo, este comando retornaria configurações de testes de voz com nomes como TestConfig, VoiceNumberTest e VoiceTest1.