Get-CsClientPinInfo
Tópico modificado em: 2012-03-23
Obtém informações sobre o PIN atribuído a um usuário.
Sintaxe
Get-CsClientPinInfo -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
O Lync Server 2010 permite que os usuários se conectem ao sistema ou ingressem em conferências na PSTN (rede telefônica pública comutada) por telefone. Geralmente, para fazer logon no sistema ou ingressar em uma conferência, o usuário precisa digitar um nome de usuário ou senha. Entretanto, digitar o nome de usuário e a senha pode ser um problema para quem usa telefones sem teclado alfanumérico. Por esse motivo, o Lync Server 2010 permite que você ofereça aos usuários PINs exclusivamente numéricos; quando solicitados, os usuários podem fazer logon no sistema ou ingressar em uma conferência digitando o PIN em vez do nome de usuário e da senha.
Os administradores podem recuperar as configurações de PIN de um usuário ou grupo de usuários, executando o cmdlet Get-CsClientPinInfo. Observe que não há como um administrador recuperar o PIN atribuído a um usuário. Se um usuário esquecer o próprio PIN, não conseguirá usar a autenticação PIN para acessar o sistema até que um administrador tenha atribuído a esse usuário um novo número PIN ou que o usuário obtenha um novo PIN na página da Web de Conferência Discada.
Observe que, por padrão, as exceções de firewall para o SQL Server Express não são habilitadas quando você instala o Lync Server 2010 Standard Edition. Isso significa que não será possível executar Get-CsClientPinInfo a partir de uma instância remota do Windows PowerShell; isso ocorre porque seu comando não será capaz de passar pelo firewall e acessar o banco de dados do SQL Server Express (no entanto, ainda é possível executar o cmdlet localmente no Servidor Standard Edition). Para executar Get-CsClientPinInfo remotamente contra um Servidor Standard Edition, será preciso habilitar manualmente as exceções de firewall para o SQL Server Express.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsClientPinInfo localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsClientPinInfo"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Parâmetro UserId |
Indica a Identidade da conta de usuário cujo PIN deve ser bloqueado. A Identidade de Usuário pode ser especificada usando um de quatro formatos: 1) O endereço SIP do usuário; 2) o nome UPN do usuário; 3) o nome de domínio do usuário e nome de logon, na forma domínio\logon (por exemplo, litwareinc\kenmyer); e, 4) o nome de exibição do Active Directory do usuário (por exemplo, Ken Myer). Também é possível fazer referência a uma conta de usuário com o nome diferenciado do Active Directory. Você pode usar o caráter curinga (*) asterisco ao usar o Nome de Exibição como a Identity de usuário. Por exemplo, Identity "* Smith" retorna todos os usuários com nome para exibição terminando com o valor de cadeia de caracteres " Smith". |
WhatIf |
Opcional |
Parâmetros de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetros de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Valor de cadeia de caracteres ou objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Get-CsClientPinInfo aceita entrada em pipeline de valores de cadeia de caracteres representando o parâmetro Identity de uma conta de usuário. O cmdlet também aceita entrada em pipeline de objetos de usuário.
Tipos de Retorno
Get-CsClientPinInfo retorna uma ou mais instâncias do objeto Microsoft.Rtc.Management.UserPinService.PinInfoDetails.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsUser | Get-CsClientPinInfo
O comando anterior retorna informações de PIN de todos os usuários que tenham sido habilitados para o Lync Server 2010. Para fazer isso, o comando chama primeiro o cmdlet Get-CsUser para retornar todos os usuários habilitados para o Lync Server 2010. Essa coleção é encaminhada para Get-CsClientPinInfo, que exibe informações de PIN de todos os usuários da coleção.
-------------------------- Exemplo 2 ------------------------
Get-CsClientPinInfo -Identity "litwareinc\kenmyer"
No Exemplo 2, Get-CsClientPinInfo é usado para exibir informações do PIN de um único usuário: o usuário com Identity litwareinc\kenmyer.
-------------------------- Exemplo 3 ------------------------
Get-CsUser -OU "OU=Finance,DC=litwareinc,DC=com" | Get-CsClientPinInfo
O Exemplo 3 retorna as informações de PIN de todos os usuários com contas na unidade organizacional Finance. Para isso, Get-CsUser e o parâmetro -OU são usados para retornar uma coleção de todos os usuários na OU Finance. Essa coleção é canalizada para Get-CsClientPinInfo, que exibe informações de PIN de todos os usuários da coleção.
-------------------------- Exemplo 4 ------------------------
Get-CsUser -LdapFilter "Title=Manager" | Get-CsClientPinInfo
O comando mostrado no Exemplo 4 exibe informações de PIN de todos os gerentes (Managers) da organização. Para recuperar uma coleção de todos os gerentes, o comando usa Get-CsUser e o parâmetro LdapFilter; o valor de filtro "Title=Manager" limita a coleção retornada aos usuários que tenham "Manager" como título do cargo. Get-CsClientPinInfo é usado para exibir informações do PIN de todos esses usuários.