Test-CsAVConference
Tópico modificado em: 2012-03-26
Testa a capacidade de um par de usuários participar de uma conferência de áudio/vídeo (A/V).
Sintaxe
Test-CsAVConference -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsAVConference [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrição Detalhada
Test-CsAVConference é um exemplo de uma "transação sintética". As transações sintéticas são usadas no Microsoft 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 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 solucionar 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.
O cmdlet Test-CsAVConference verifica se dois usuários de teste podem conduzir uma conferência de áudio/vídeo. Quando o cmdlet for executado, os dois usuários serão registrados no sistema. Depois que eles se conectarem com êxito, o primeiro usuário criará uma conferência de A/V e aguardará até que o segundo usuário participe da conferência. Depois de uma breve troca de dados, a conferência é excluída e os dois usuários de teste fazem logoff.
Na verdade, Test-CsAVConference não conduz uma conferência de áudio/vídeo entre os dois usuários de teste. Em vez disso, o cmdlet verifica se os dois usuários podem estabelecer as conexões necessárias para realizar essa conferência.
Quem pode executar esse cmdlet: 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 "Test-CsAVConference"}
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 correspondente ao 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 se 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 se esteja 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 se 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: -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 se esteja 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 a atividade detalhada na tela à medida que o cmdlet for executado. |
Tipos de Entrada
Nenhuma.
Tipos de Retorno
Test-CsAVConference retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemplo
-------------------------- Exemplo 1 --------------------------
Test-CsAVConference -TargetFqdn atl-cs-001.litwareinc.com
O exemplo anterior verifica se um par de usuários de teste preconfigurados podem fazer logon no pool atl-cs-001.litwareinc.com e depois participar de uma conferência de áudio/vídeo. Esse comando funcionará apenas se os usuários de teste tiverem sido definidos para o pool atl-cs-001.litwareinc.com. Se eles tiverem sido definidos, o comando determinará se os dois usuários podem fazer logon no sistema. Se eles puderem, o primeiro usuário de teste criará uma conferência de áudio/vídeo e convidará o segundo usuário a participar da conferência. O cmdlet então verificará se os dois usuários de teste puderam ou não estabelecer uma conexão bem-sucedida.
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, 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-CsAVConference 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-CsAVConference -TargetFqdn atl-cs-001.litwareinc.com -SenderSipAddress "sip:pilar@litwareinc.com" -SenderCredential $cred1 -ReceiverSipAddress "sip:kenmyer@litwareinc.com" -ReceiverCredential $cred2
Os comandos mostrados no Exemplo 2 testam a possibilidade de um par de usuários (litwareinc\pilar e litwareinc\kenmyer) fazer logon no Lync Server 2010 e, em seguida, participar de uma conferência de A/V. Para realizar isso, o primeiro comando no exemplo usa o cmdlet Get-Credential, para criar um objeto de credencial 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 2010 e, em seguida, participar de uma conferência de A/V. Para realizar essa tarefa, chama-se Test-CsAVConference, 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).