Partilhar via

  • Artigo

Test-CsLisConfiguration

 

Tópico modificado em: 2012-03-26

Testa a configuração do servidor de informações de local (LIS).

Sintaxe

Test-CsLisConfiguration -TargetFqdn <String> [-BssId <String>] [-ChassisId <String>] [-External <SwitchParameter>] [-Force <SwitchParameter>] [-Mac <String>] [-OutVerboseVariable <String>] [-PortId <String>] [-PortIdSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-RegistrarPort <Nullable>] [-Subnet <String>] [-UserSipAddress <String>]

Test-CsLisConfiguration -TargetUri <String> -UserSipAddress <String> [-BssId <String>] [-ChassisId <String>] [-Force <SwitchParameter>] [-Mac <String>] [-OutVerboseVariable <String>] [-PortId <String>] [-PortIdSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-Subnet <String>] [-WebCredential <PSCredential>]

Test-CsLisConfiguration [-TargetFqdn <String>] -UserCredential <PSCredential> -UserSipAddress <String> [-BssId <String>] [-ChassisId <String>] [-External <SwitchParameter>] [-Force <SwitchParameter>] [-Mac <String>] [-OutVerboseVariable <String>] [-PortId <String>] [-PortIdSubType <InterfaceAlias | InterfaceName | LocallyAssigned>] [-RegistrarPort <Nullable>] [-Subnet <String>]

Descrição Detalhada

Este cmdlet determina se o serviço web do servidor de informações de local (LIS) pode ser contatado, com base nas informações contidas nos parâmetros fornecidos. Se o serviço web puder ser contatado e se for encontrado um local que corresponda a qualquer um dos parâmetros fornecidos, o teste será considerado aprovado e o local será exibido. Mesmo se o local não for encontrado, se o serviço web puder ser contatado, o teste retornará uma aprovação, mas sem informações de local. Além disso, caso este cmdlet seja chamado sem se fornecer qualquer um dos parâmetros opcionais, o teste será aprovado, contanto que o serviço web possa ser contatado; no entanto, mais uma vez, nenhuma informação de local será retornada.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Test-CsLisConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

TargetFqdn

Obrigatório

Cadeia de caracteres

O nome de domínio totalmente qualificado (FQDN) (no formato server.litwareinc.com) do servidor que se quer testar.

Esse parâmetro é necessário, a menos que você especifique o parâmetro TargetUri. Nesse caso, não é possível especificar TargetFqdn.

TargetUri

Obrigatório

Cadeia de caracteres

O Identificador de Recurso Uniforme (URI) do Serviço de Informações de Local. É possível recuperar o URI do Serviço de Informações de Local, executando-se o seguinte comando: Get-CsService –WebServer | Select-Object LIServiceInternalUri

Caso se especifique o valor deste parâmetro, o parâmetro UserSipAddress também será obrigatório. Se o computador em que você estiver executando o comando não possuir um certificado de servidor, será necessário especificar também o valor do parâmetro WebCredential.

Este parâmetro é obrigatório, a menos que se especifique o parâmetro TargetFqdn.

UserCredential

Obrigatório

PSCredential

Um objeto que contém credenciais de usuário para acesso ao Serviço de Informações de Local. Este objeto pode ser recuperado chamando-se o cmdlet Get-Credential e fornecendo-se as credenciais apropriadas.

Esse parâmetro será necessário se os parâmetros TargetFqdn e UserSipAddress forem especificados, e se o computador em que estiver executando o cmdlet não possuir um certificado de servidor.

UserSipAddress

Obrigatório

Cadeia de caracteres

O endereço SIP de um usuário remoto.

Se você especificar um valor para esse parâmetro, o parâmetro TargetFqdn ou TargetUri também será necessário.

Esse parâmetro será necessário quando você especificar o parâmetro TargetFqdn apenas se você não tiver definido os usuários de transações sintéticas. Para ver se os usuários de transações sintéticas foram definidos, execute o cmdlet Get-CsHealthMonitoringConfiguration.

BssId

Opcional

Cadeia de caracteres

O Identificador do conjunto de serviços básicos (BSSID) de um ponto de acesso sem fio. Este valor deve estar no formato nn-nn-nn-nn-nn-nn (como 12-34-56-78-90-ab, por exemplo).

ChassisId

Opcional

Cadeia de caracteres

O endereço MAC (Controle de acesso de mídia) de um comutador de rede. Este valor deve estar no formato nn-nn-nn-nn-nn-nn (como 12-34-56-78-90-ab, por exemplo) ou de um endereço IP.

External

Opcional

SwitchParameter

Este parâmetro não recebe apoio do Servidor de informações de local.

Mac

Opcional

Cadeia de caracteres

O endereço MAC do comutador de portas. Este valor deve estar no formato nn-nn-nn-nn-nn-nn (como 12-34-56-78-90-ab, por exemplo).

PortId

Opcional

Cadeia de caracteres

O ID da porta associada ao local a ser testado. Ele também pode conter um endereço MAC ou um endereço IP.

PortIdSubType

Opcional

PortIDSubType

O subtipo da porta. Este valor pode ser inserido como um valor numérico ou uma cadeia de caracteres, mas deve ser um subtipo válido. Os subtipos válidos são:

1: InterfaceAlias

5: InterfaceName

7: LocallyAssigned

RegistrarPort

Opcional

System.Nullable

O número da porta do serviço Registrador.

Subnet

Opcional

Cadeia de caracteres

O endereço IP de uma sub-rede. Este valor deveria ser digitado como um endereço IPv4 (dígitos separados por pontos, como 192.0.2.0, por exemplo).

WebCredential

Opcional

PSCredential

Um objeto que contém credenciais de usuário para acesso ao Serviço de Informações de Local. Este objeto pode ser recuperado chamando-se o cmdlet Get-Credential e fornecendo-se as credenciais apropriadas.

Esse parâmetro será necessário se os parâmetros TargetUri e UserSipAddress forem especificados e se o computador em que estiver se executando o comando não possuir um certificado de servidor.

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.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Test-CsLisConfiguration retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.

Exemplo

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

Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0

Este exemplo testa a configuração LIS no FQDN atl-cs-001.litwareinc.com. O teste será aprovado caso se possa efetuar uma conexão contendo as credenciais de usuário atuais com o serviço web LIS nesse FQDN. Se for encontrado um local que seja convertido no endereço IP de sub-rede 192.168.0.0, será retornado o endereço desse local.

Para esse comando ser bem-sucedido, deverá existir uma configuração de monitoramento de integridade que contenha os usuários de transição sintética. Para verificar se há uma configuração de monitoramento de integridade, execute o cmdlet Get-CsHealthMonitoringConfiguration. Para criar uma nova configuração de monitoramento de integridade, execute o cmdlet New-CsHealthMonitoringConfiguration.

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

Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0 -UserSipAddress sip:kmyer@litwareinc.com

Esse exemplo é idêntico ao Exemplo 1, mas com a adição do parâmetro UserSipAddress. Use esse comando quando nenhum usuário de transação sintética tiver sido definido, mas quando o computador em que o comando estiver sendo executado possuir um certificado de servidor.

-------------------------- Exemplo 3 --------------------------

$cred = Get-Credential
Test-CsLisConfiguration -TargetFqdn atl-cs-001.litwareinc.com -Subnet 192.168.0.0 -UserSipAddress sip:kmyer@litwareinc.com -UserCredential $cred

A primeira linha deste exemplo chama um cmdlet do Windows PowerShell (Get-Credential), que solicitará ao usuário um ID de usuário e uma senha. Essas informações serão armazenadas de maneira criptografada na variável $cred.

A segunda linha é idêntica ao comando no Exemplo 2, mas com a adição do parâmetro UserSipAddress. Use esse comando quando nenhum usuário de transação sintética tiver sido definido e quando o computador em que o comando estiver sendo executado não possuir um certificado de servidor.

-------------------------- Exemplo 4 --------------------------

$cred = Get-Credential
Test-CsLisConfiguration -TargetUri https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc -UserSipAddress sip:kmyer@litwareinc.com -WebCredential $cred -Subnet 192.168.0.0 -Mac 0A-23-00-00-00-AA -PortId 4500 -ChassisId 0A-23-00-00-00-AA

A primeira linha deste exemplo chama o cmdlet Get-Credential, que solicitará ao usuário um ID de usuário e uma senha. Essas informações serão armazenadas de maneira criptografada na variável $cred.

A linha 2 testa a configuração LIS realizando uma chamada para o URI do serviço web (https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc), com base no endereço SIP do usuário remoto (sip:kmyer@litwareinc.com) e usando as credenciais obtidas na linha 1, passando-as para o parâmetro WebCredential. O teste será aprovado se for possível se efetuar uma conexão contendo as credenciais de usuário fornecidas com o serviço web LIS nesse URI. Se for encontrado um local que seja convertido no endereço IP 192.168.0.0, no endereço MAC 0A-23-00-00-00-AA ou no ID de porta 4500 e ChassisId 0A-23-00-00-00-AA, esse endereço de local será retornado.

Use esse comando quando o computador em que o comando estiver sendo executado não possuir um certificado de servidor.

-------------------------- Exemplo 5 --------------------------

Test-CsLisConfiguration -TargetUri https://atl-cs-001.litwareinc.com/locationinformation/lisservice.svc -UserSipAddress sip:kmyer@litwareinc.com -Subnet 192.168.0.0 -Mac 0A-23-00-00-00-AA -PortId 4500 -ChassisId 0A-23-00-00-00-AA

Esse exemplo é idêntico ao Exemplo 4, exceto pelo fato de que o comando não usa o parâmetro WebCredential (e, portanto, não chama Get-Credential). Use esse comando quando o computador em que o comando estiver sendo executado possuir um certificado de servidor.