Test-CsIM
Tópico modificado em: 2012-03-26
Testa a habilidade de dois usuários trocarem mensagens instantâneas.
Sintaxe
Test-CsIM -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-ReceiverSipAddress <String>] [-RegistrarPort <Nullable>] [-SenderSipAddress <String>]
Test-CsIM [-TargetFqdn <String>] -ReceiverCredential <PSCredential> -ReceiverSipAddress <String> -SenderCredential <PSCredential> -SenderSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Descrição Detalhada
Test-CsIM é um exemplo de "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 são tipicamente conduzidas de duas formas 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.
De forma alternativa, administradores podem executar uma transação sintética usando contas de usuários de verdade. Por exemplo, se dois usuários não conseguem trocar mensagens instantâneas, um administrador pode executar transações sintéticas usando as duas contas de usuário em questão (ao invés de duas contas de teste) 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 as credenciais de cada usuário.
O cmdlet Test-CsIM primeiro tenta fazer logon de um par de usuários de teste no Lync Server. Presumindo que os dois logons tenham êxito, o cmdlet então inicia uma sessão de IM (mensagens instantâneas) entre os dois usuários de teste (Usuário 1 convida Usuário 2 para uma sessão de IM, e Usuário 2 aceita o convite). Depois de verificar se as mensagens podem ser trocadas entre os dois usuários, Test-CsIM então termina a sessão de mensagem instantânea e faz logoff dos dois usuários do sistema.
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-CsIM"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
ReceiverCredential |
Obrigatório |
Objeto PS credential |
Objeto de credencial de usuário para a primeira das duas contas de usuário a serem testadas. O valor passado para ReceiverCredential deve ser uma referência de objeto obtida usando-se o cmdlet Get-Credential. Por exemplo, este código retorna um objeto de credencial para a usuária litwareinc\pilar e armazena esse objeto em uma variável chamada $y: $y = Get-Credential "litwareinc\pilar" Você deve fornecer a senha do usuário quando executando este comando. A credencial de destinatário não será necessária se você estiver realizando o teste sob a configuração de monitoramento de integridade do pool. |
ReceiverSipAddress |
Opcional |
Cadeia de caracteres |
Endereço SIP para a primeira das duas contas de usuário a serem testadas. Por exemplo: -ReceiverSipAddress "sip:jhaas@litwareinc.com". O parâmetro ReceiverSipAddress deve referenciar a mesma conta de usuário que ReceiverCredential. O endereço SIP não será necessário se você estiver realizando o teste sob a configuração de monitoramento de integridade do pool. |
SenderCredential |
Obrigatório |
Objeto PS credential |
Objeto de credencial de usuário para a segunda das duas contas de usuário a serem testadas. O valor passado para SenderCredential deve ser uma referência de objeto obtida usando-se o cmdlet Get-Credential. Por exemplo, este código retorna um objeto de credenciais para o usuário litwareinc\kenmyer e grava este objeto em uma variável chamada $x: $x = Get-Credential "litwareinc\kenmyer" Você deve fornecer a senha do usuário quando executando este comando. A credencial de remetente não será necessária se você estiver realizando o teste sob a configuração de monitoramento de integridade do pool. |
SenderSipAddress |
Obrigatório |
Cadeia de caracteres |
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 referenciar a mesma conta de usuário de SenderCredential. O endereço SIP não será necessário se você estiver realizando o teste sob a configuração de monitoramento de integridade do pool. |
TargetFqdn |
Obrigatório |
Cadeia de caracteres |
O FQDN (nome de domínio totalmente qualificado) do pool a ser testado. |
RegistrarPort |
Opcional |
Número inteiro |
Porta SIP usada pelo serviço de Registrador. Este parâmetro não é obrigatório se o Registrador usa a porta padrão 5061. |
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. |
Force |
Opcional |
Parâmetro de Opção |
Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando. |
Verbose |
Opcional |
Parâmetro de Opção |
Reporta atividade detalhada na tela à medida que o cmdlet é executado. |
Tipos de Entrada
Nenhuma. Test-CsIM não aceita entrada em pipeline.
Tipos de Retorno
Test-CsIM retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemplo
-------------------------- Exemplo 1 --------------------------
Test-CsIm -TargetFqdn atl-cs-001.litwareinc.com
O exemplo anterior verifica se um par de usuários de teste pré-definidos pode conectar no pool atl-cs-001.litwareinc.com e, então, trocar mensagens instantâneas. Esse comando só funcionará se usuários de teste tiverem sido definidos no pool atl-cs-001.litwareinc.com. Se tiverem sido, então o comando vai determinar se os dois usuários podem se conectar ao sistema e, se for o caso, se podem trocar mensagens instantâneas. I
Se usuários de testes não tiverem sido definidos, o comando falhará porque não saberá quais usuários empregar ao fazer o teste. Se um Registrador não tiver sido definido para um pool, será necessário incluir os parâmetros SenderSipAddress e ReceiverSipAddress, além das credenciais correspondentes para os usuários envolvidos na sessão de IM. Em seguida, Test-CsIM conduzirá suas verificações usando os dois usuários especificados.
-------------------------- Exemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsIm -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 capacidade de um par de usuários (litwareinc\pilar e litwareinc\kenmyer) de fazerem logon no Lync Server e trocarem mensagens instantâneas. 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 da usuária Pilar Ackerman (como o nome de logon litwareinc\pilar 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 Pilar Ackerman). O objeto de credencial resultante é, então, armazenado na variável chamada $cred1. O segundo comando faz a mesma coisa, desta vez retornando o objeto de credencial para a conta Ken Myer.
Com os dois objetos de credencial em mãos, o terceiro comando no exemplo determina se os dois usuários podem conectar ao Lync Server e, então, trocar mensagens instantâneas. Para fazer isso, Test-CsIM é chamado, junto como os seguintes parâmetros: TargetFqdn (o FQDN do pool do Registrador); SenderSipAddress (o endereço SIP do primeiro usuário de teste); SenderCredential (o objeto do Windows PowerShell que contém as credenciais desse 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).