Compartilhar via


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.

Consulte Também

Outros Recursos

Test-CsRegistration