Test-CsPstnOutboundCall
Tópico modificado em: 2012-03-26
Testa a capacidade de um usuário realizar chamadas para um número de telefone localizado na PSTN (rede telefônica pública comutada).
Sintaxe
Test-CsPstnOutboundCall -TargetFqdn <String> -TargetPstnPhoneNumber <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsPstnOutboundCall [-TargetFqdn <String>] -TargetPstnPhoneNumber <String> -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrição Detalhada
Test-CsPstnOutboundCall é um exemplo de uma "transação sintética" do Microsoft Lync Server 2010. As transações sintéticas são usadas no Lync Server 2010 para verificar se os usuários podem concluir tarefas comuns, como fazer logon no sistema, trocar mensagens instantâneas ou fazer chamadas para um telefone localizado na PSTN (rede telefônica pública comutada). Esses testes podem ser conduzidos manualmente por um administrador, ou ser executados automaticamente por um aplicativo como o Microsoft System Center Operations Manager (anteriormente Microsoft Operations Manager).
Transações sintéticas costumam ser conduzidas de duas maneiras diferentes. Muitos administradores vão usar os cmdlets CsHealthMonitoringConfiguration para configurar um usuário de teste para cada um de seus pools de Registrador. Esses usuários de teste são um par de usuários pré-configurados para uso com transações sintéticas (geralmente, são contas de testes, e não contas que pertençam a usuários reais). Com contas de usuário de testes configuradas para um pool, os administradores podem simplesmente executar uma transação sintética nesse pool sem ter que especificar as identidades (e fornecer as credenciais) das contas de usuário envolvidas no teste.
Outra opção para os administradores é a de executar uma transação sintética com contas de usuário reais. Por exemplo, se dois usuários não conseguirem trocar mensagens instantâneas, um administrador poderia executar uma transação sintética usando as duas contas de usuário em questão (em vez de um par de contas de testes) para tentar diagnosticar e resolver o problema. Se optar por conduzir uma transação sintética usando contas de usuário reais, será necessário fornecer os nomes de logon e as senhas de cada usuário.
Test-CsPstnOutboundCall também pode ser usado em modo de plataforma de servidor. Nesse caso, só é preciso especificar o endereço SIP de um usuário, e o Lync Server 2010 usará certificados para autenticar esse usuário.
Ao executar o Test-CsPstnOutboundCall, o cmdlet primeiro tenta fazer logon do usuário de testes no Lync Server. Se o logon tiver êxito, o cmdlet tenta fazer uma chamada telefônica através do gateway da PSTN. Essa chamada será feita usando o plano de discagem, a diretiva de voz e outras diretivas e configurações atribuídas à conta de testes. Quando a chamada é atendida, o cmdlet envia códigos DTMF pela rede para verificar a conectividade de mídia.
Ao conduzir seu teste, Test-CsPstnOutboundCall fará uma chamada telefônica real: o telefone de destino irá tocar e deve ser atendido para que o teste tenha êxito. Essa chamada também deve ser finalizada manualmente pelo administrador.
Quem pode executar este cmdlet: 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-CsPstnOutboundCall"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
TargetFqdn |
Obrigatório |
Cadeia de caracteres |
O FQDN (nome de domínio totalmente qualificado) do pool a ser testado. |
TargetPstnPhoneNumber |
Obrigatório |
Cadeia de caracteres |
Número de telefone da PSTN a ser chamado na realização do teste. O número de telefone de destino é melhor especificado com o formato E.164, o que significa que um número será parecido com "+14255551298", contendo um sinal de adição (+) seguido pelo código de chamada do país/região (1), pelo código de área (425) e pelo número de telefone (5551298). Não use traços, parênteses e demais caracteres ao especificar o número do telefone. Se não quiser usar o formato E.164, o plano de discagem do usuário de testes será anexado ao número. O Lync Server 2010 usará esse plano de discagem para normalizar o número para o formato E.164. Se o número não puder ser normalizado, a chamada não será realizada e o teste irá falhar. |
UserCredential |
Opcional |
Objeto de credencial PS |
Objeto de credencial de usuário para a conta a ser testada. O valor passado para UserCredential deve ser uma referência de objeto obtida com o cmdlet Get-Credential. Por exemplo, este código retorna um objeto de credencial para o usuário litwareinc\kenmyer e armazena esse objeto em uma variável chamada $x: $x = Get-Credential "litwareinc\kenmyer" É preciso fornecer a senha de usuário ao executar este comando. Esse parâmetro não é necessário se o comando estiver usando os usuários de testes configurados com os cmdlets CsHealthMonitoringConfiguration. Não é necessário especificar esse parâmetro se o teste estiver sendo realizado em modo de plataforma de servidor. Nesse caso, Lync Server 2010 vai tentar autenticar o usuário utilizando certificados. |
UserSipAddress |
Opcional |
Endereço SIP |
O endereço SIP da conta de usuário a ser testada. Por exemplo: -SenderSipAddress "sip:kenmyer@litwareinc.com". O parâmetro UserSipAddress precisa fazer referência à mesma conta de usuário que UserCredential. Esse parâmetro não é necessário se o comando estiver usando os usuários de testes configurados com os cmdlets CsHealthMonitoringConfiguration. |
OutVerboseVariable |
Opcional |
Cadeia de caracteres |
Quando presente, a saída detalhada da execução do cmdlet será armazenada na variável especificada. Por exemplo, para armazenar a saída em uma variável chamada $TestOutput, use a seguinte sintaxe: -OutVerboseVariable TestOutput Não coloque um caractere $ como prefixo ao especificar o nome da variável. |
RegistrarPort |
Opcional |
Inteiro |
Porta SIP usada pelo serviço Registrador. Esse parâmetro não será necessário se o Registrador usar a porta padrão 5061. |
Force |
Opcional |
Parâmetros de opção |
Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando. |
Verbose |
Opcional |
Cadeia de caracteres |
Relata atividade detalhada na tela enquanto o cmdlet é executado. |
Tipos de Entrada
Nenhuma. Test-CsPstnOutboundCall não aceita entrada em pipeline.
Tipos de Retorno
Test-CsPstnOutboundCall retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemplo
-------------------------- Exemplo 1 --------------------------
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567"
O exemplo anterior verifica se um usuário de testes pré-configurado pode fazer logon no pool atl-cs-001.litwareinc.com e em seguida fazer uma chamada telefônica através do gateway PSTN. Esse comando só funcionará se usuários de teste tiverem sido definidos no pool atl-cs-001.litwareinc.com. Se eles tiverem sido definidos, o comando determinará se o primeiro usuário de testes pode fazer logon no sistema e, em caso afirmativo, faz uma chamada telefônica para outro telefone localizado na rede PSTN.
Se usuários de testes não tiverem sido definidos, o comando irá falhar porque não vai saber qual usuário empregar ao fazer o teste. Se usuários de testes não tiverem sido definidos para um pool, será preciso incluir o parâmetro UserSipAddress, além das credenciais correspondentes para a conta de usuário envolvida no teste. Test-CsPstnOutboundCall conduzirá suas verificações usando o usuário especificado.
-------------------------- Exemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -TargetPstnPhoneNumber "+15551234567" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1
Os comandos mostrados no Exemplo 2 testam a capacidade de um usuário de testes (litwareinc\kenmyer) de fazer logon no Lync Server e de fazer uma chamada telefônica através do gateway PSTN. Para fazer isso, o primeiro comando do exemplo usa o cmdlet Get-Credential para criar um objeto de credencial do Windows PowerShell contendo o nome e a senha do usuário Ken Myer (como o nome de logon litwareinc\kenmyer foi incluído como parâmetro, a caixa de diálogo Solicitação de Credenciais do Windows PowerShell só exigirá que o administrador digite a senha da conta de Ken Myer). O objeto de credencial resultante é então armazenado em uma variável chamada $cred1.
Com o objeto de credencial em mãos, o segundo comando do exemplo determina se o usuário de testes pode ou não fazer logon no Lync Server e em seguida fazer uma chamada telefônica para o número de telefone de destino (+15551234567). Para realizar essa tarefa, Test-CsPstnOutboundCall é chamado, junto com os seguintes parâmetros: TargetFqdn (o FQDN do pool do registrador); UserSipAddress (o endereço SIP do usuário que está fazendo a chamada); UserCredential (o objeto do Windows PowerShell que contém as credenciais do usuário de testes); e TargetPstnPhoneNumber (o número de telefone que está sendo chamado).
-------------------------- Exemplo 3 --------------------------
Test-CsPstnOutboundCall -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress sip:kenmyer@litwareinc.com -TargetPstnPhoneNumber "+15551234567"
O Exemplo 3 mostra como Test-CsPstnOutboundCall pode ser usado em modo de plataforma de servidor. Neste modo, o endereço SIP do usuário é especificado, mas as credenciais do usuário não são incluídas. Quando executado dessa forma, o Lync Server 2010 usa certificados para autenticar o usuário de testes.