Set-CsClientPin
Tópico modificado em: 2012-03-25
Atribui um novo número de identificação pessoal (PIN) ao usuário especificado.
Sintaxe
Set-CsClientPin -Identity <UserIdParameter> [-Pin <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
O Lync Server 2010 permite que os usuários se conectem ao sistema ou participem de conferências da rede telefônica pública comutada (PSTN) pelo telefone. Normalmente, o logon no sistema ou a participação de uma conferência exige que o usuário digite um nome de usuário ou uma senha. No entanto, a digitação de um nome de usuário e uma senha pode ser um problema, se você estiver usando um telefone que não possua um teclado alfanumérico. Por isso, o Lync Server 2010 permite fornecer aos usuários PINs com valores exclusivamente numéricos. Quando solicitados, os usuários podem fazer o logon no sistema ou participar de uma conferência, digitando o PIN em vez do nome de usuário e da senha.
Os usuários não receberão a atribuição de um PIN quando estiverem habilitados para o Lync Server 2010; isso significa que, por padrão, eles não poderão acessar o sistema utilizando a autenticação por PIN. Os usuários podem obter um PIN na página da Web Conferência discada. Como alternativa, os administradores poderão atribuir um PIN a cada usuário, usando o cmdlet Set-CsClientPin. Com o Set-CsClientPin, é possível atribuir um PIN específico a um usuário ou permitir que o Lync Server 2010 gere um PIN. Para gerar automaticamente um PIN, omita o parâmetro PIN ao chamar Set-CsClientPin. Se fizer isso, será gerado um novo PIN, e a Identidade do usuário e o novo PIN serão exibidos na tela quando o comando for concluído.
Observe que os PINs que forem atribuídos explicitamente devem corresponder às condições especificadas na política de autenticação por PIN que governam o usuário em questão. Por exemplo: o PIN deve ter, pelo menos, o mesmo número de dígitos que o especificado pela propriedade MinPasswordLength. Observe também que os PINs podem conter apenas números. Não são permitidas letras ou outros caracteres não-numéricos.
Quando você definir um PIN de cliente usando Set-CsClientPin, a contagem do histórico do PIN não será aplicada. Por exemplo: suponha que um usuário tenha o PIN 12345 e a sua política de PIN de cliente o impede de reutilizar imediatamente o mesmo PIN. Se esse usuário tentar renovar o PIN de cliente usando a página da Web Conferência discada, qualquer tentativa de reutilizar o mesmo PIN (12345) será rejeitada. No entanto, ao usar Set-CsClientPin, um administrador pode emitir para esse usuário o PIN 12345. Isso ocorre porque Set-CsClientPin não está vinculado à contagem do histórico da política de PIN.
Observe que, por padrão, as exceções de firewall do SQL Server Express não são habilitadas ao se instalar a Standard Edition do Lync Server 2010. Isso significa que não será possível executar Set-CsClientPin em uma instância remota do Windows PowerShell porque o comando não pode atravessar o firewall nem acessar o banco de dados do SQL Server Express. (no entanto, ainda será possível executar o cmdlet localmente no próprio servidor Standard Edition). Para executar o Set-CsClientPin remotamente em um servidor Standard Edition, será necessário habilitar manualmente as exceções de firewall do SQL Server Express.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsClientPin localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsClientPin"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
UserIdParameter |
Identidade da conta do usuário cujo PIN deverá ser definido. As identidades de usuário podem ser especificadas usando-se um dos quatro formatos a seguir: 1) O endereço SIP do usuário, 2) o UPN (nome principal de usuário), 3) o nome de domínio e nome de logon do usuário, na forma domínio\logon (por exemplo: litwareinc\kenmyer) e 4) o nome de exibição do usuário no Active Directory (por exemplo: Ken Myer). Também é possível fazer referência às Identidades de usuário, usando-se o nome diferenciado do usuário no Active Directory. Além disso, pode-se utilizar o caractere curinga asterisco (*) ao utilizar o nome de exibição como identidade do usuário. Por exemplo, a identidade "* Smith" retornará todos os usuários com nome de exibição que terminarem com o valor da cadeia de caracteres " Smith". |
Pin |
Opcional |
Inteiro |
PIN opcional a ser atribuído ao usuário. Se você não incluir o parâmetro PIN, o Lync Server 2010 irá gerar aleatoriamente um PIN e atribuí-lo ao usuário em questão. Observe que o PIN deve aderir ao comprimento mínimo e às definições padrão comuns postuladas pela política de PIN de cliente que tiver sido atribuída ao usuário. |
Force |
Opcional |
Parâmetro de opção |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando. |
WhatIf |
Opcional |
Parâmetro de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetro 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. Set-CsClientPin aceita entradas canalizadas de valores de cadeia de caracteres que representam a Identidade de uma conta de usuário. O cmdlet também aceita entradas canalizadas de objetos de usuário.
Tipos de Retorno
Set-CsClientPin não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.UserPinService.PinInfoDetails.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsClientPin -Identity "litwareinc\kenmyer"
No Exemplo 1, um novo PIN gerado automaticamente é atribuído ao usuário litwareinc\kenmyer. Para atribuir um PIN gerado automaticamente, omita o parâmetro PIN, ao chamar Set-CsClientPin. Depois que o comando for concluído, será exibido na tela o novo PIN atribuído a Ken Myer e essas informações poderão então ser retransmitidas ao usuário.
-------------------------- Exemplo 2 ------------------------
Set-CsClientPin -Identity "litwareinc\kenmyer" -Pin 18723834
O comando do Exemplo 2 atribui o PIN 18723834 ao usuário litwareinc\kenmyer. É possível atribuir um PIN específico, usando-se o parâmetro PIN, seguido do número a ser atribuído.
-------------------------- Exemplo 3 ------------------------
Get-CsUser -OU "OU=Finance,DC=litwareinc,DC=com" | Set-CsClientPin
O Exemplo 3 mostra como se pode atribuir automaticamente novos PINs a todos os usuários em uma determinada unidade organizacional (OU) do Active Directory. Para fazer isso, utiliza-se Get-CsUser, juntamente com o parâmetro OU, para retornar uma coleção de todos os usuários que possuírem contas na OU Financeira. Essa coleção será então canalizada para Set-CsClientPin, que gerará um novo PIN para cada usuário na coleção.
-------------------------- Exemplo 4 ------------------------
Get-CsUser | Get-CsClientPinInfo | Where-Object {$_.IsPinSet -eq $False} | Set-CsClientPin
O comando exibido no Exemplo 4 atribui um novo PIN a todos os usuários que não possuírem um número PIN. Para realizar essa tarefa, utiliza-se Get-CsUser, para retornar uma coleção de todos os usuários que tiverem sido habilitados para o Lync Server 2010. Essa coleção será então canalizada para os cmdlets Get-CsClientPin e Where-Object, que são usados para selecionar apenas os usuários cuja propriedade IsPinSet for igual a False. A coleção resultante, que contém apenas usuários que não possuem um PIN, será então canalizada para Set-CsClientPin, que gerará automaticamente um PIN para cada usuário na coleção.