Test-CsDialInConferencing
Tópico modificado em: 2012-03-25
Test-CsDialInConferencing verifica se um usuário pode participar de uma sessão de conferência discada.
Sintaxe
Test-CsDialInConferencing -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsDialInConferencing [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrição Detalhada
Test-CsDialInConferencing é 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 de registradores. Estes usuários de teste são um par de usuários que foram pré-configurados para uso com transações sintéticas. (normalmente, essas são contas de teste e não 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.
O Test-CsDialInConferencing funciona tentando fazer o logon de um usuário de teste no sistema. (se você estiver utilizando usuários de teste, Test-CsDialInConferencing usará a primeira conta de teste configurada para esse pool). Se o logon for bem sucedido, o cmdlet usará as credenciais e permissões do usuário para tentar os números de acesso à conferência discada disponíveis. O sucesso ou a falha de cada tentativa de discagem será anotado e, em seguida, o usuário de teste será desconectado do Lync Server.
Test-CsDialInConferencing apenas verifica se é possível efetuar as conexões necessárias. Na verdade, o cmdlet não faz nenhuma chamada telefônica, nem cria conferências discadas de que outros usuários possam participar.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Test-CsDialInConferencing localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsDialInConferencing"}
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. |
UserCredential |
Obrigatório |
Objeto de credencial PS |
Objeto de credencial do usuário da conta do usuário a ser testada. O valor passado para UserCredential 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. Esse parâmetro não é necessário, caso esteja se conduzindo o teste usando as definições de configuração de monitoramento de integridade. |
UserSipAddress |
Obrigatório |
Endereço SIP |
Endereço SIP da conta do usuário a ser testada. Por exemplo: -UserSipAddress "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, caso esteja se conduzindo o teste usando as definições de configuração de monitoramento de integridade. |
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. |
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. |
Verbose |
Opcional |
Parâmetro de opção |
Relata na tela a atividade detalhada, à medida que o cmdlet for executado. |
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. |
Tipos de Entrada
Nenhuma. Test-CsDialInConferencing não aceita a entrada canalizada.
Tipos de Retorno
Test-CsDialInConferencing retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemplo
-------------------------- Exemplo 1 --------------------------
Test-CsDialInConferencing -TargetFqdn atl-cs-001.litwareinc.com
O exemplo anterior verifica se o usuário de teste pré-configurado pode participar de uma conferência discada no pool atl-cs-001.litwareinc.com. Esse comando funcionará apenas se tiverem sido definidos usuários de teste para o pool atl-cs-001.litwareinc.com. Se eles tiverem sido definidos, o comando determinará se o primeiro usuário pode fazer logon no Lync Server.
Se os usuários de teste não tiverem sido definidos, o comando falhará porque não vai saber qual usuário empregar ao fazer o logon. Se não tiverem sido definidos os usuários de teste do pool, deve-se incluir o parâmetro UserCredential e as credenciais do usuário que o comando deve empregar ao tentar fazer o logon.
-------------------------- Exemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
Test-CsDialInConferencing -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:pilar@litwareinc.com" -UserCredential $cred1
Os comandos exibidos no Exemplo 2 testam a capacidade de um usuário específico (litwareinc\pilar) de participar de conferências discadas no pool atl-cs-001.litwareinc.com. 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, o administrador apenas precisa inserir a senha da conta de Pilar Ackerman na caixa de diálogo Solicitação de credenciais do Windows PowerShell). O objeto de credencial resultante será então armazenado em uma variável denominada $cred1.
O segundo comando verificará se a usuária Pilar Ackerman pode fazer o logon no pool atl-cs-001.litwareinc.com e participar de uma conferência discada. Para realizar essa tarefa, chama-se Test-CsDialInConferencing, juntamente com três parâmetros: TargetFqdn (o nome de domínio totalmente qualificado do pool de registradores), UserCredential (o objeto do Windows PowerShell que contém as credenciais da usuária Pilar Ackerman) e UserSipAddress (o endereço SIP correspondente às credenciais de usuário fornecidas).