Test-CsPresence
Tópico modificado em: 2012-03-26
Testa a capacidade de um usuário fazer logon no Microsoft Lync Server 2010, publicar suas informações de presença, e depois inscrever-se nas informações de presença publicadas por um segundo usuário.
Sintaxe
Test-CsPresence -TargetFqdn <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-PublisherSipAddress <String>] [-RegistrarPort <Nullable>] [-SubscriberSipAddress <String>] [-SubscriberSipAddress <String>]
Test-CsPresence [-TargetFqdn <String>] -PublisherCredential <PSCredential> -PublisherSipAddress <String> -SubscriberCredential <PSCredential> -SubscriberSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-SubscriberSipAddress <String>]
Descrição Detalhada
Test-CsPresence é um exemplo de uma transação sintética do Lync Server 2010. As transações sintéticas são usadas no Lync Server 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 costumam ser conduzidas de duas maneiras diferentes. Muitos administradores vão usar os cmdlets CsHealthMonitoringConfiguration para configurar usuários de teste para cada um de seus pools de Registrador. Geralmente, são contas de testes, e não contas que pertençam a usuários reais. Com essas contas de usuário 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.
Outra opção para os administradores é a de executar uma transação sintética com contas de usuário reais. Por exemplo, se dois usuários não conseguirem trocar mensagens instantâneas, um administrador pode executar uma transação sintética usando as duas contas de usuário em questão (em vez de um par de contas de testes) 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 os nomes de logon e as senhas de cada usuário.
Test-CsPresence é usado para determinar se um par de usuários de testes pode fazer logon no Lync Server e trocar informações de presença. Para fazer isso, o cmdlet primeiro faz logon dos dois usuários no sistema. Se o logon de ambos tiver êxito, o primeiro usuário de testes solicita o recebimento de informações de presença do segundo usuário. O segundo usuário publica essas informações, e Test-CsPresence verifica se as informações foram transmitidas com êxito para o primeiro usuário. Após a troca de informações de presença, os dois usuários de testes são desconectados do Lync Server.
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-CsPresence"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
TargetFqdn |
Obrigatório |
Cadeia de caracteres |
O FQDN (nome de domínio totalmente qualificado) do pool a ser testado. |
PublisherCredential |
Obrigatório |
Objeto de credencial PS |
Objeto de credencial de usuário para a primeira das duas contas de usuário a serem testadas. O valor passado para PublisherCredential deve ser uma referência de objeto obtida com o cmdlet Get-Credential. Por exemplo, este código retorna um objeto de credencial para o usuário litwareinc\kenmyer e armazena esse objeto em uma variável chamada $x: $x = Get-Credential "litwareinc\kenmyer" É preciso fornecer a senha de usuário ao executar este comando. A credencial de editor não será necessária se você estiver realizando o teste sob a configuração de monitoramento de integridade do pool. |
PublisherSipAddress |
Obrigatório |
Endereço SIP |
O endereço SIP da primeira das duas contas de usuário a serem testadas. Por exemplo: -PublisherSipAddress "sip:kenmyer@litwareinc.com". O parâmetro PublisherSipAddress precisa fazer referência à mesma conta de usuário que PublisherCredential. 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. |
SubscriberCredential |
Obrigatório |
Objeto de credencial PS |
Objeto de credencial de usuário para a segunda das duas contas de usuário a serem testadas. O valor passado para SubscriberCredential deve ser uma referência de objeto obtida com 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" É preciso fornecer a senha de usuário ao executar este comando. A credencial de assinante não será necessária se você estiver realizando o teste sob a configuração de monitoramento de integridade do pool. |
SubscriberSipAddress |
Obrigatório |
Endereço SIP |
O endereço SIP da segunda das duas contas de usuário a serem testadas. Por exemplo: -SubscriberSipAddress "sip:pilar@litwareinc.com". O parâmetro SubscriberSipAddress precisa fazer referência à mesma conta de usuário que SubscriberCredential. 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. |
RegistrarPort |
Opcional |
Inteiro |
Porta SIP usada pelo serviço Registrador. Esse parâmetro não será necessário se o Registrador usar 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 o caractere $ como um prefixo ao especificar o nome da variável. |
Force |
Opcional |
Parâmetros de opção |
Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando. |
Verbose |
Opcional |
Cadeia de caracteres |
Relata atividade detalhada na tela enquanto o cmdlet é executado. |
Tipos de Entrada
Nenhuma. Test-CsPresence não aceita entrada em pipeline.
Tipos de Retorno
Test-CsPresence retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemplo
-------------------------- Exemplo 1 --------------------------
Test-CsPresence -TargetFqdn atl-cs-001.litwareinc.com
O exemplo anterior verifica se um par de usuários de testes pré-configurado pode fazer logon no pool atl-cs-001.litwareinc.com; depois que os usuários de teste fazem logon, Test-CsPresence verifica se os dois usuários conseguem trocar informações de presença. Esse comando só funcionará se usuários de teste tiverem sido definidos no pool atl-cs-001.litwareinc.com. Se eles tiverem sido definidos, o comando determinará se o primeiro usuário de testes pode fazer logon no sistema, e depois verifica se esse usuário pode trocar informações de presença com o segundo usuário de testes definido para o pool.
Se um Registrador não tiver sido definido, o comando falhará porque não saberá quais usuários empregar ao fazer o teste. Se usuários de testes não tiverem sido definidos para um pool, será preciso incluir os parâmetros SubscriberSipAddress e PublisherSipAddress, além das credenciais correspondentes para os usuários agindo como o assinante de presença e o editor de presença. Test-CsPresence conduzirá suas verificações usando os dois usuários especificados.
-------------------------- Exemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\pilar"
$cred2 = Get-Credential "litwareinc\kenmyer"
Test-CsPresence -TargetFqdn atl-cs-001.litwareinc.com -SubscriberSipAddress "sip:pilar@litwareinc.com" -SubscriberCredential $cred1 -PublisherSipAddress "sip:kenmyer@litwareinc.com" -PublisherCredential $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 informações de presença. 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 em uma variável chamada $cred1. O segundo comando faz a mesma coisa, mas retorna um objeto de credencial para a conta de Ken Myer.
Com dois objetos de credencial nas mãos, o terceiro comando do exemplo determina se os dois usuários podem ou não fazer logon no Lync Server e trocar informações de presença. Para realizar essa tarefa, Test-CsPresence é chamado, junto com os seguintes parâmetros: TargetFqdn (o FQDN do pool do Registrador); SubscriberSipAddress (o endereço SIP de um usuário de teste); SubscriberCredential (o objeto do Windows PowerShell que contém as credenciais desse usuário); PublisherSipAddress (o endereço SIP do outro usuário de teste); e PublisherCredential (o objeto do Windows PowerShell que contém as credenciais do outro usuário).