Unlock-CsClientPin
Última modificación del tema: 2012-03-24
Permite a un administrador desbloquear el número de identificación personal (PIN) del usuario especificado.
Sintaxis
Unlock-CsClientPin -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Lync Server 2010 permite a los usuarios conectarse al sistema o participar en conferencias de la red telefónica conmutada (RTC) a través del teléfono. En general, para que un usuario pueda iniciar sesión en el sistema o participar en una conferencia, es necesario que introduzca un nombre de usuario o una contraseña. Pero introducir un nombre de usuario y una contraseña puede resultar difícil si se utiliza un teléfono sin teclado alfanumérico. Por este motivo, Lync Server 2010 le permite proporcionar a los usuarios números PIN que sólo contengan números; cuando se solicite, los usuarios podrán iniciar sesión en el sistema o unirse a una conferencia introduciendo el número PIN en lugar de un nombre de usuario y una contraseña.
Sin embargo, esto sólo funcionará si el PIN del usuario está desbloqueado. Si se ha bloqueado un PIN (porque el usuario haya introducido mal los datos de inicio de sesión varias veces, o porque un administrador haya bloqueado el PIN), el usuario no podrá obtener acceso al sistema ni unirse a una conferencia utilizando la autenticación con PIN. (Aunque podrá usar una aplicación, como Microsoft Lync 2010, para iniciar sesión en el sistema con un nombre de usuario y una contraseña.) Si un PIN se ha bloqueado, sólo hay un sistema para que el usuario pueda volver a tener acceso al sistema mediante autenticación por PIN: un administrador debe desbloquear el número PIN bloqueado. Para ello, puede utilizar el cmdlet Unlock-CsClientPin.
Tenga en cuenta que, de forma predeterminada, las excepciones del firewall de SQL Server Express no están habilitadas al instalar la edición Standard de Lync Server 2010. Esto implica que no podrá ejecutar Unlock-CsClientPin desde una instancia remota de Windows PowerShell, porque el comando no podrá atravesar el firewall y obtener acceso a la base de datos de SQL Server Express. (Sin embargo, puede seguir ejecutando el cmdlet de forma local en el propio servidor de Standard Edition.) Para ejecutar Unlock-CsClientPin remotamente contra un servidor Standard Edition, deberá habilitar de forma manual las excepciones del firewall de SQL Server Express.
Quién puede ejecutar este cmdlet: de forma predeterminada, están autorizados para ejecutar el cmdlet Unlock-CsClientPin localmente los miembros de los siguientes grupos: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluidos los roles de RBAC personalizados que haya creado), ejecute el siguiente comando en el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Unlock-CsClientPin"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
UserIdParameter |
La identidad de la cuenta de usuario para la que debe desbloquearse el PIN. Las identidades de usuario pueden especificarse con cuatro formatos: 1) la dirección SIP del usuario; 2) el nombre principal del usuario (UPN); 3) el nombre del dominio y el nombre de inicio de sesión del usuario, con formato dominio\nombre (por ejemplo, litwareinc\kenmyer), y 4) el nombre para mostrar de Active Directory del usuario (por ejemplo, Ken Myer). También se puede hacer referencia a las identidades de usuario mediante el nombre distintivo de Active Directory. Asimismo, puede usar el asterisco (*) como comodín al usar el nombre para mostrar como identidad del usuario. Por ejemplo, la identidad "* Smith" devuelve todos los usuarios con un nombre para mostrar que termine con el valor de cadena de caracteres " Smith". |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean irrecuperables y que puedan surgir al ejecutar el comando. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Valor alfanumérico u objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Unlock-CsClientPin acepta la entrada por canalización de valores alfanuméricos que representen la identidad de una cuenta de usuario. El cmdlet acepta también la entrada por canalización de objetos de usuario.
Tipos de valores devueltos
Unlock-CsClientPin no devuelve ningún valor u objeto. En su lugar, el cmdlet configura una o varias instancias del objeto Microsoft.Rtc.Management.UserPinService.PinInfoDetails.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Unlock-CsClientPin -Identity "litwareinc\kenmyer"
En el Ejemplo 1, se usa Unlock-CsClientPin para desbloquear el PIN del usuario litwareinc\kenmyer.
-------------------------- Ejemplo 2 ------------------------
Get-CsUser | Get-CsClientPinInfo | Where-Object {$_.IsLockedOut -eq $True} | Unlock-CsClientPin
En el ejemplo anterior, se usa Unlock-CsClientPin para desbloquear todos los PIN bloqueados actualmente. Para llevar a cabo esta tarea, primero se usa Get-CsUser para devolver una recopilación de todos los usuarios que se han habilitado para Lync Server 2010. A continuación, la recopilación se transfiere a Get-CsClientPinInfo, que se usa en combinación con el cmdlet Where-Object para seleccionar sólo los usuarios cuya propiedad IsLockedOut es igual a (-eq) True ($True).
A continuación, la recopilación filtrada se transfiere a Unlock-CsClientPin, que desbloquea los PIN de todos los usuarios con PIN bloqueado.