Test-CsPstnPeerToPeerCall
Tópico modificado em: 2012-03-25
Testa a capacidade de um par de usuários realizar uma chamada ponto a ponto através do gateway da rede telefônica pública comutada (PSTN).
Sintaxe
Test-CsPstnPeerToPeerCall -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsPstnPeerToPeerCall [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrição Detalhada
Test-CsPstnPeerToPeerCall é 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 se certificar de que os usuários sejam capazes de concluir tarefas comuns com sucesso, como fazer logon no sistema, trocar mensagens instantâneas ou realizar chamadas para um telefone localizado na rede telefônica pública comutada (PSTN). Esses testes podem ser conduzidos manualmente por um administrador ou executados automaticamente por um aplicativo como o Microsoft System Center Operations Manager (anteriormente Microsoft Operations Manager).
Normalmente, as transações sintéticas são conduzidas de duas maneiras diferentes. Muitos administradores usarão os cmdlets CsHealthMonitoringConfiguration para definir os usuários de teste de cada um de seus pools do registradores. Esses usuários de teste são um par de usuários que foram configurados previamente para uso com transações sintéticas. (normalmente, essas são contas de teste e não contas que pertencem a usuários reais). Com usuários de teste configurados para um pool, os administradores podem simplesmente executar uma transação sintética nesse pool, sem ter de especificar as identidades (nem fornecer credenciais) das contas dos usuários envolvidos no teste.
Como alternativa, os administradores podem executar uma transação sintética utilizando contas de usuários reais. Por exemplo, se dois usuários não puderem trocar mensagens instantâneas, um administrador pode executar uma transação sintética usando as duas contas dos usuários em questão (em vez de um par de contas de teste) e tentar diagnosticar e resolver o problema. Se decidir conduzir uma transação sintética usando contas de usuários reais, você terá de fornecer o nome e a senha de logon de cada usuário.
Test-CsPstnPeerToPeerCall também pode ser usado no modo plataforma de servidor. Neste caso, será necessário apenas especificar o endereço SIP dos usuários, e o Lync Server 2010 utilizará certificados para autenticá-los.
Quando se chama Test-CsPstnPeerToPeerCall, o cmdlet primeiramente tentará efetuar o logon dos dois usuários de teste no Lync Server. Assumindo-se que os logons tenham tido sucesso, o cmdlet fará então o usuário 1 tentar chamar o usuário 2 utilizando o gateway PSTN. Test-CsPstnPeerToPeerCall fará esta chamada utilizando o plano de discagem, a política de voz e outras políticas e configurações atribuídas ao usuário de teste. Se o teste ocorrer como o planejado, o cmdlet verificará se o usuário 2 conseguiu atender à chamada e efetuará o logoff das duas contas.
Test-CsPstnPeerToPeerCall faz uma chamada telefônica real, que verifica se uma conexão pode ser estabelecida e transmite códigos de multifrequência de tom dual (DTMF) ao longo da rede, para determinar se é possível enviar mídia pela conexão. No entanto, a chamada será atendida pelo próprio cmdlet, e nenhum encerramento manual da chamada será necessário. (ou seja, ninguém precisará atender e desligar o telefone para o qual tiver sido feita ligação).
Quem pode executar esse cmdlet: Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPstnPeerToPeerCall"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
TargetFqdn |
Obrigatório |
Cadeia de caracteres |
Nome do domínio totalmente qualificado (FQDN) do pool a ser testado. |
ReceiverCredential |
Opcional |
Objeto de credencial PS |
Objeto de credencial de usuário da primeira das duas contas de usuário a serem testadas. O valor passado para ReceiverCredential deve ser uma referência de objeto obtida ao se utilizar o cmdlet Get-Credential. Por exemplo: esse código retorna um objeto de credenciais correspondente ao usuário litwareinc\pilar e armazena esse objeto em uma variável denominada $y: $y = Get-Credential "litwareinc\pilar" É necessário fornecer a senha do usuário para executar este comando. A credencial do destinatário não é necessária, caso se esteja executando o teste com a configuração de monitoramento de integridade do pool ou no modo plataforma do servidor. |
ReceiverSipAddress |
Opcional |
Endereço SIP |
Endereço SIP da primeira das duas contas de usuário a serem testadas. Por exemplo: -ReceiverSipAddress "sip:pilar@litwareinc.com". O parâmetro ReceiverSIPAddress deve fazer referência à mesma conta de usuário que ReceiverCredential. O endereço SIP não será necessário, caso se esteja executando o teste com as definições de configuração de monitoramento de integridade do pool. |
RegistrarPort |
Opcional |
Inteiro |
Porta SIP utilizada pelo serviço Registrador. Este parâmetro não será obrigatório se o Registrador utilizar a porta padrão 5061. |
SenderCredential |
Opcional |
Objeto de credencial PS |
Objeto de credencial de usuário da segunda das duas contas de usuário a serem testadas. O valor passado para SenderCredential deve ser uma referência de objeto obtida ao se utilizar o cmdlet Get-Credential. Por exemplo: este código retorna um objeto de credenciais do usuário litwareinc\kenmyer e o armazena em uma variável denominada $x: $x = Get-Credential "litwareinc\kenmyer" É necessário fornecer a senha do usuário para executar este comando. A credencial do remetente não é necessária, caso esteja se executando o teste com a configuração de monitoramento de integridade do pool ou no modo plataforma do servidor. |
SenderSipAddress |
Opcional |
Endereço SIP |
Endereço SIP para a segunda das duas contas de usuário a serem testadas. Por exemplo: -SenderSipAddress "sip:kenmyer@litwareinc.com." O parâmetro SenderSIPAddress deve fazer referência à mesma conta de usuário que SenderCredential. O endereço SIP não será necessário, caso esteja se executando o teste com as definições de configuração de monitoramento de integridade do pool. |
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 denominada $TestOutput, use a seguinte sintaxe: -OutVerboseVariable TestOutput Não coloque um caractere $ como prefixo ao especificar o nome da variável. |
Force |
Opcional |
Parâmetro de opção |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando. |
Verbose |
Opcional |
Parâmetro de opção |
Relata na tela a atividade detalhada, à medida que o cmdlet for executado. |
Tipos de Entrada
Nenhuma. O cmdlet Test-CsPstnPeerToPeerCall não aceita entradas canalizadas.
Tipos de Retorno
Test-CsPstnPeerToPeerCall retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemplo
-------------------------- Exemplo 1 --------------------------
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com
O exemplo anterior verifica se um par de usuários de teste pré-configurados consegue efetuar o logon no pool atl-cs-001.litwareinc.com. Após o logon, Test-CsPstnPeerToPeerCall verificará se os dois usuários conseguem efetuar uma chamada ponto a ponto utilizando o gateway PSTN. Esse comando funcionará apenas se usuários de teste tiverem sido definidos para o pool atl-cs-001.litwareinc.com. Em caso positivo, o comando determinará se o primeiro usuário de teste pode efetuar o logon no sistema e verificará se este usuário pode chamar o segundo usuário definido para o pool.
Se um dos usuários de teste não tiver sido definido, o comando falhará, porque não saberá quais usuários empregar ao fazer o teste. Se não houver usuários de teste definidos no pool e o modo plataforma de servidor não estiver sendo executado, deverão se incluir os parâmetros SenderSipAddress e ReceiverSipAddress, além das credenciais correspondentes aos usuários servindo como contas de teste. Test-CsPstnPeerToPeerCall realizará as verificações utilizando os dois usuários especificados.
-------------------------- Exemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:jhaas@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2
Os comandos mostrados no Exemplo 2 testam a capacidade de um par de usuários (litwareinc\pilar e litwareinc\kenmyer) efetuar o logon no Lync Server e realizar uma chamada ponto a ponto utilizando o gateway PSTN. Para isso, o primeiro comando no exemplo usa o cmdlet Get-Credential, para criar um objeto de credencial do Windows PowerShell contendo o nome e a senha da usuária Pilar Ackerman. (como o nome de logon litwareinc\pilar foi incluído como um parâmetro, a caixa de diálogo resultante – Solicitação de credenciais – do Windows PowerShell solicitará apenas que o administrador insira a senha da conta de Pilar Ackerman). O objeto de credencial resultante será então armazenado em uma variável denominada $cred1. O segundo comando fará o mesmo, retornando, desta vez, um objeto de credencial para a conta de Ken Myer.
Obtidos os dois objetos de credencial, o terceiro comando no exemplo determinará se os dois usuários podem efetuar o logon no Lync Server e realizar uma chamada ponto a ponto utilizando o gateway PSTN. Para realizar esta tarefa, chama-se Test-CsPstnPeerToPeerCall, juntamente com os seguintes parâmetros: TargetFqdn (o FQDN do pool de registradores), SenderSipAddress (o endereço SIP do primeiro usuário de teste), SenderCredential (o objeto do Windows PowerShell que contém as credenciais deste usuário), ReceiverSipAddress (o endereço SIP do outro usuário de teste) e ReceiverCredential (o objeto do Windows PowerShell que contém as credenciais do outro usuário).
-------------------------- Exemplo 3 --------------------------
Test-CsPstnPeerToPeerCall -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:jhaas@litwareinc.com" -ReceiverSipAddress "sip:kenmyer@litwareinc.com"
O Exemplo 3 mostra como Test-CsPstnPeerToPeerCall pode ser usado no modo plataforma do servidor. Neste modo, especificam-se os endereços SIP dos usuários de teste, mas não se incluem as credenciais dos usuários. Quando executado desta forma, o Lync Server 2010 usa certificados para autenticar os dois usuários de teste.