Test-CsP2PAV
Tópico modificado em: 2012-03-26
Testa a capacidade de um par de usuários conduzir uma chamada ponto a ponto de áudio/vídeo.
Sintaxe
Test-CsP2PAV -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsP2PAV [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrição Detalhada
Test-CsP2PAV é 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 PSTN (rede telefônica pública comutada). 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 de 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 usando 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-CsP2PAV é usado para determinar se dois usuários de teste podem participar de uma conversação ponto a ponto de áudio/vídeo. Para testar esta situação, o cmdlet inicialmente faz o logon dos dois usuários no Lync Server. Presumindo-se que os dois logons sejam bem-sucedidos, o primeiro usuário convidará o segundo para participar da chamada de áudio/vídeo. O segundo usuário aceitará a chamada, a conexão entre os dois usuários será testada e, em seguida, a chamada será encerrada e os usuários de teste farão o logoff do sistema.
Na verdade, Test-CsP2PAV não realiza uma chamada de áudio/vídeo. Os usuários não trocam informações multimídia entre si. Em vez disso, o cmdlet simplesmente verifica se as conexões apropriadas podem ser feitas e se os dois usuários podem realizar essa chamada.
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-CsP2PAV"}
Parâmetros
| Parâmetro | Obrigatório | Digite | 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 do usuário litwareinc\pilar e armazena esse objeto em uma variável denominada $y: $y = Get-Credential "litwareinc\pilar" É necessário fornecer ao usuário uma senha ao executar esse comando. A credencial do destinatário não será necessária, caso se esteja executando o teste com as definições de configuração de monitoramento de integridade do pool. |
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 esteja se executando o teste com as definições de configuração de monitoramento de integridade do pool. |
RegistrarPort |
Opcional |
Inteiro |
Porta SIP usada pelo serviço Registrador. Esse parâmetro não é necessário se o Registrador usar 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, esse código retorna um objeto de credenciais para o usuário litwareinc\kenmyer e armazena esse objeto em uma variável denominada $x: $x = Get-Credential "litwareinc\kenmyer" É necessário fornecer ao usuário uma senha ao executar esse comando. A credencial do remetente não será necessária, caso se esteja executando o teste com as definições de configuração de monitoramento de integridade do pool. |
SenderSipAddress |
Opcional |
Endereço SIP |
Endereço SIP para a segunda das duas contas de usuário a serem testadas. Por exemplo: -SenderSipAddres "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. |
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. |
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. |
Verbose |
Opcional |
Parâmetro de opção |
Relata na tela a atividade detalhada, à medida que o cmdlet for executado. |
Tipos de Entrada
Nenhuma. Test-CsP2PAV não aceita a entrada canalizada.
Tipos de Retorno
Test-CsP2PAV retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemplo
-------------------------- Exemplo 1 --------------------------
Test-CsP2PAV -TargetFqdn atl-cs-001.litwareinc.com
O exemplo anterior verifica se um par de usuários de teste pré-configurados podem fazer logon no pool atl-cs-001.litwareinc.com e conduzir uma chamada ponto a ponto de áudio/vídeo. Esse comando funcionará apenas se usuários de teste tiverem sido definidos para o pool atl-cs-001.litwareinc.com. Se tiverem sido definidos, o comando determinará se os dois usuários poderão fazer logon no sistema e, em caso afirmativo, poderão conversar usando uma chamada de áudio/vídeo.
Se os usuários de teste não tiverem sido definidos, o comando irá falhar porque não vai saber quais usuários empregar ao fazer o teste. Se você não tiver definido os usuários de teste de um pool, então será necessário incluir os parâmetros SenderSipAddress e ReceiverSipAddress, bem como as credenciais correspondentes aos usuários envolvidos na troca de mensagens instantâneas. Test-CsP2PAV conduzirá então as suas verificações, usando os dois usuários especificados.
-------------------------- Exemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsP2PAV -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2
Os comandos exibidos no Exemplo 2 testam a capacidade de um par de usuários (litwareinc\pilar e litwareinc\kenmyer) fazer logon no Lync Server e, em seguida, conduzir uma chamada ponto a ponto de áudio/vídeo. 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.
De posse dos dois objetos de credencial, o terceiro comando no exemplo determinará se os dois usuários podem ou não fazer logon no Lync Server e, em seguida, conduzir uma chamada ponto a ponto de áudio/vídeo. Para realizar essa tarefa, chama-se Test-CsP2PAV, juntamente com os parâmetros a seguir: 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).