Test-CsWebApp
Tópico modificado em: 2012-03-27
Verifica se os usuários autenticados podem usar o Microsoft Lync Web App para ingressar em uma conferência do Microsoft Lync Server 2010.
Sintaxe
Test-CsWebApp -TargetFqdn <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]
Test-CsWebApp [-TargetFqdn <String>] -User2Credential <PSCredential> -User2SipAddress <String> -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]
Test-CsWebApp -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]
Descrição Detalhada
O cmdlet Test-CsWebApp permite que os administradores verifiquem se os usuários autenticados podem implantar o Lync Web App para ingressar em conferências. Quando você executa o Test-CsWebApp, o cmdlet tenta obter um tíquetes da Web para dois usuários de teste usando o serviço de Tíquete da Web. Se os tíquetes puderem ser obtidos e os usuários de teste forem autenticados, Test-CsWebApp tentará se conectar ao Lync Server 2010 usando o Lync Web App. Se a conexão for feita, o cmdlet tentará estabelecer conferências separadas para mensagens instantâneas, compartilhamento de aplicativos e colaboração de dados.
Muitos administradores usarão os cmdlets CsHealthMonitoringConfiguration para definir os usuários de teste de cada um de seus pools do registradores. Esses usuários de teste representam um par de contas de usuários pré-configuradas para uso com transações sintéticas (geralmente, são contas de testes, e não contas que pertençam a usuários reais). Se usuários de teste estiverem configurados para um pool, os administradores poderão executar o Test-CsWebApp nesse pool sem ter que especificar a identidade (e fornecer as credenciais) da conta do usuário envolvido no teste.
Como alternativa, os administradores podem executar o Test-CsWebApp usando contas de usuário reais. Se você optar por conduzir um teste usando contas de usuário reais, será necessário fornecer o nome de logon e a senha de cada conta.
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
TargetFqdn |
Opcional |
Cadeia de caracteres |
Nome do domínio totalmente qualificado (FQDN) do pool a ser testado. Por exemplo: -TargetFqdn atl-cs-001.litwareinc.com |
User2Credential |
Opcional |
PSCredential |
Objeto de credencial de usuário para a segunda das duas contas de usuário a serem testadas. O valor passado para Use2rCredential 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\kenmyer e armazena esse objeto em uma variável chamada $y: $y = Get-Credential "litwareinc\kenmyer" É necessário fornecer a senha do usuário ao executar esse comando. |
User2SipAddress |
Opcional |
Cadeia de caracteres |
Endereço SIP para a segunda das duas contas de usuário a serem testadas. Por exemplo: -User2SipAddress "sip:pilar@litwareinc.com" Esse parâmetro não é necessário se você estiver executando o teste usando os usuários de teste configurados por meio dos cmdlets CsHealthMonitoringConfiguration. |
UserCredential |
Opcional |
PSCredential |
Objeto de credenciais de usuário para a primeira das duas contas de usuário a serem testadas. O valor passado para UserCredential 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\pilar e armazena esse objeto em uma variável chamada $x: $x = Get-Credential "litwareinc\pilar" É necessário fornecer a senha do usuário ao executar esse comando. |
UserSipAddress |
Opcional |
Cadeia de caracteres |
Endereço SIP para a primeira das duas contas de usuário a serem testadas. Por exemplo: -UserSipAddress "sip:kenmyer@litwareinc.com" Esse parâmetro não é necessário se você estiver executando o teste usando os usuários de teste configurados por meio dos cmdlets CsHealthMonitoringConfiguration. |
External |
Opcional |
SwitchParameter |
Quando presente, faz com que o Test-CsWebApp teste o Web relay externo do Reach Server. Se este parâmetro não estiver presente, o cmdlet testará o Web relay interno. O Web relay serve como um intermediário entre a rede interna e a Internet. |
TargetUri |
Opcional |
Cadeia de caracteres |
Identificador de Recurso Uniforme (URI) do Reach Server. Por exemplo: -TargetUri "https://atl-cs-001.litwareinc.com/reach" Não é possível utilizar os parâmetros TargetUri e TargetFqdn no mesmo comando. |
WebCredential |
Opcional |
Objeto PS Credential |
O objeto de credencial da conta do usuário a ser utilizada no teste. 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" Esse parâmetro será necessário se o parâmetro TargetUri ou os parâmetros UserSipAddress/User2SipAddress forem especificados e se o computador em que estiver se executando o comando não possuir um certificado de servidor. |
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. |
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 use um caractere $ como prefixo ao especificar o nome da variável. |
Force |
Opcional |
SwitchParameter |
Suprime a exibição de qualquer mensagem de erro não fatal que possa ocorrer durante a execução do comando. |
Tipos de Entrada
Nenhum.
Tipos de Retorno
O Test-CsWebApp retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemplo
-------------------------- Exemplo 1 --------------------------
Test-CsWebApp -TargetFqdn atl-cs-001.litwareinc.com
O comando anterior verifica se dois usuários de teste configurados para o pool atl-cs-001.litwareinc.com podem usar o Lync Web App para ingressar em uma conferência. Esse comando só será bem-sucedido se você tiver configurado usuários de teste para o pool usando os cmdlets CsHealthMonitoringConfiguration.
-------------------------- Exemplo 2 --------------------------
$cred1 = Get-Credential "litwareinc\kenmyer"
$cred2 = Get-Credential "litwareinc\pilar"
Test-CsWebApp -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1 -User2SipAddress "sip:pilar@litwareinc.com" -User2Credential $cred2
Os comandos mostrados no Exemplo 2 verificam se os usuários Ken Myer e Pilar Ackerman podem usar o Lync Web App para ingressar em uma conferência. Para usar contas de usuário reais, os primeiros dois comandos no exemplo usam o cmdlet Get-Credential para criar objetos de credenciais do Windows PowerShell para os dois usuários (litwareinc\kenmyer e litwareinc\pilar). Esses objetos de credenciais (armazenados nas variáveis $cred1 e $cred2) são usados como valores para os parâmetros UserCredential e User2Credential no comando final do exemplo. Além dos parâmetros de credenciais de usuário, os parâmetros UserSipAddress e User2SipAddress são incluídos, juntamente com os endereços SIP das duas contas de usuário que estão sendo usadas no teste.