Test-CsPhoneBootstrap
Tópico modificado em: 2012-03-26
Verifica se um usuário pode fazer o logon no Microsoft Lync Server 2010 usando um dispositivo compatível com o Microsoft Lync 2010 Phone Edition.
Sintaxe
Test-CsPhoneBootstrap [-TargetFqdn <String>] -PhoneOrExt <String> -PIN <String> [-Force <SwitchParameter>] [-OutVerboseVariable <String>] [-RegistrarPort <Nullable>] [-TargetUri <String>] [-UserSipAddress <String>]
Descrição Detalhada
Para se conectar a dispositivos compatíveis com o Lync Server 2010, Lync 2010 Phone Edition é necessário usar o Protocolo de Configuração Dinâmica de Host (DHCP), para recuperar o endereço de um Registrador do Lync Server; esses dispositivos também devem fornecer um número de telefone válido e um número de identificação pessoal (PIN) associado para ser autenticado pelo sistema. (esse processo é conhecido como "bootstrapping".) O cmdlet Test-CsPhoneBootstrap permite que os administradores verifiquem se um determinado usuário, que usa o número de telefone e o PIN atribuídos a ele, pode fazer logon no sistema em um dispositivo compatível com o Lync 2010 Phone Edition. (nenhum dispositivo é realmente necessário para executar o teste).
Para que Test-CsPhoneBootstrap possa realizar essa verificação, é necessário que o pool de registradores que hospeda a conta do usuário testada seja detectável usando-se o DHCP. Para determinar se um Registrador é detectável dessa maneira, use o cmdlet Get-CsRegistrarConfiguration e verifique o valor da propriedade EnableDHCPServer. Se essa propriedade for definida como False, será necessário usar Set-CsRegistrarConfiguration para definir o valor da propriedade como True e tornar o registrador detectável usando-se o DHCP. Isso também pode ser feito usando-se o Enterprise DHCP Server e configurando as opções específicas do Lync Server.
Quem pode executar esse cmdlet: Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Test-CsPhoneBootstrap"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
PhoneOrExt |
Obrigatório |
Cadeia de caracteres |
Número do telefone ou ramal telefônico da conta de usuário a ser testada. Por exemplo: -PhoneOrExt "+14255551219". |
PIN |
Obrigatório |
Cadeia de caracteres |
PIN da conta de usuário a ser testada. |
RegistrarPort |
Opcional |
Inteiro |
Porta SIP usada pelo serviço do Registrador. Esse parâmetro não é necessário se o Registrador usar a porta padrão 5061. |
TargetFqdn |
Opcional |
Cadeia de caracteres |
Nome de domínio totalmente qualificado do pool de registradores que hospeda a conta de usuário a ser testada. Se não for especificado, a descoberta do DHCP será usada para localizar o pool de Registradores. |
TargetUri |
Opcional |
Cadeia de caracteres |
URL do serviço de provisionamento de certificados. Se esse parâmetro não for incluído, a descoberta de DHCP será usada para localizar o URI de destino. |
UserSipAddress |
Opcional |
Cadeia de caracteres |
Endereço SIP da conta de usuário usada no texto. Por exemplo: -UserSipAddress "sip:kenmyer@litwareinc.com". O parâmetro UserSIPAddress deve fazer referência ao número de telefone e PIN fornecidos. O teste falhará se o número de telefone e o PIN incluídos não pertencerem ao usuário especificado pelo parâmetro UserSipAddress. Observe que o endereço SIP deve incluir o prefixo "sip:". |
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 |
Guid |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando. |
Verbose |
Opcional |
Cadeia de caracteres |
Relata na tela a atividade detalhada, à medida que o cmdlet for executado. |
Tipos de Entrada
Nenhuma. Test-CsPhoneBootstrap não aceita a entrada canalizada.
Tipos de Retorno
Test-CsPhoneBootstrap retorna uma instância do objeto Microsoft.Rtc.SyntheticTransactions.TaskOutput.
Exemplo
-------------------------- Exemplo 1 ------------------------
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712"
O comando exibido no Exemplo 1 verifica se o usuário com o número de telefone e o PIN especificados pode se conectar ao Lync Server usando um dispositivo compatível com o Lync 2010 Phone Edition. Para executar o teste, devem se fornecer o número de telefone do usuário (+14255551219) e o PIN do usuário (0712).
-------------------------- Exemplo 2 ------------------------
Test-CsPhoneBootstrap -PhoneOrExt "+14255551219" -Pin "0712" -UserSipAddress "sip:kenmyer@litwareinc.com"
O comando anterior verifica se o usuário com o número de telefone e o PIN especificados pode se conectar ou não ao Lync Server usando um dispositivo compatível com o Lync 2010 Phone Edition. Nesse exemplo, o parâmetro UserSipAddress é incluído como uma verificação adicional: o teste falhará se o usuário com o endereço SIP não for o mesmo que o usuário com o número de telefone e PIN especificados.