Test-CsWebAppAnonymous

 

Tópico modificado em: 2012-03-26

Verifica se os usuários anônimos podem usar o Microsoft Lync Web App para ingressar em uma conferência do Microsoft Lync Server 2010.

Sintaxe

Test-CsWebAppAnonymous -TargetFqdn <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-UserSipAddress <String>]

Test-CsWebAppAnonymous -TargetUri <String> -UserSipAddress <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-WebCredential <PSCredential>]

Test-CsWebAppAnonymous [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-External <SwitchParameter>] [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>]

Descrição Detalhada

O cmdlet Test-CsWebAppAnonymous permite que os administradores verifiquem se os usuários anônimos podem implantar o Lync Web App para ingressar em conferências. Quando você executa o Test-CsWebAppAnonymous, o cmdlet tenta obter um tíquete da Web anônimo usando o serviço de Tíquete da Web. Se o tíquete puder ser obtido, Test-CsWebAppAnonymous 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-CsWebAppAnonymous 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-CsWebAppAnonymous usando uma conta de usuário real. Se você optar por conduzir um teste usando uma conta de usuário real, será necessário fornecer o nome de logon e a senha dessa 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
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. 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.
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-CsWebAppAnonymous 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 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-CsWebAppAnonymous retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.

Exemplo

-------------------------- Exemplo 1 --------------------------

Test-CsWebAppAnonymous -TargetFqdn atl-cs-001.litwareinc.com

O comando mostrado no Exemplo 1 verifica se um usuário de teste configurado para o pool atl-cs-001.litwareinc.com pode usar o Lync Web App para ingressar como anômino em uma conferência. Esse comando só será bem-sucedido se você tiver configurado um usuário de teste para o pool usando os cmdlets CsHealthMonitoringConfiguration.

-------------------------- Exemplo 2 --------------------------

$cred1 = Get-Credential "litwareinc\kenmyer"

Test-CsWebApp -TargetFqdn atl-cs-001.litwareinc.com -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $cred1 

Os comandos anteriores verificam se o usuário Ken Myer pode usar o Lync Web App para ingressar como anônimo em uma conferência. Para usar uma conta de usuário real, o primeiro comando no exemplo usa o cmdlet Get-Credential para criar um objeto de credenciais Windows PowerShell para o usuário litwareinc\kenmyer. Esse objeto de credenciais (armazenado em uma variável denominada $cred1) é passado para o parâmetro UserCredential no segundo comando do exemplo. Além do parâmetro UserCredential, o parâmetro UserSipAddress também está incluindo, juntamente com o endereço SIP do Ken Myer.