Set-CsClientPin
Última modificación del tema: 2012-03-25
Asigna un nuevo número de identificación personal (PIN) al usuario especificado.
Sintaxis
Set-CsClientPin -Identity <UserIdParameter> [-Pin <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Lync Server 2010 permite a los usuarios conectarse al sistema o unirse a conferencias de red telefónica conmutada (RTC) mediante un teléfono. Normalmente, para iniciar sesión en el sistema o unirse a una conferencia, el usuario debe especificar su nombre de usuario o contraseña. Sin embargo, escribir un nombre de usuario y contraseña puede suponer un problema en teléfonos que no tienen teclado alfanumérico. Por este motivo, Lync Server 2010 permite proporcionar a los usuarios PIN formados únicamente por números. Cuando así se solicite, los usuarios podrán iniciar sesión en el sistema o unirse a una conferencia escribiendo el PIN, en lugar de un nombre de usuario y una contraseña.
Cuando se habilita a los usuarios para Lync Server 2010, no se les asigna un PIN; esto significa que, de forma predeterminada, los usuarios no pueden obtener acceso al sistema mediante la autenticación basada en PIN. Los usuarios pueden obtener un PIN en la página web de las conferencias de acceso telefónico local, o bien los administradores pueden asignar a cada usuario un PIN mediante el cmdlet Set-CsClientPin. Con Set-CsClientPin, puede asignar a un usuario un PIN específico o permitir que Lync Server 2010 lo genere de forma automática. Para generar automáticamente un PIN, simplemente omita el parámetro PIN al llamar a Set-CsClientPin. De este modo se generará un nuevo PIN y el valor de Identity del usuario y el nuevo PIN se mostrarán en pantalla cuando se complete el comando.
Tenga en cuenta que los PIN que asigne de forma explícita deben cumplir las condiciones especificadas en la directiva de autenticación mediante PIN que se aplique al usuario en cuestión; por ejemplo, el PIN debe tener por lo menos el número de dígitos que especifique la propiedad MinPasswordLength. También debe tener en cuenta que los PIN solo pueden contener números. No se permite el uso de letras ni de otros caracteres no numéricos.
Cuando se configura un PIN de cliente mediante Set-CsClientPin, no se exige el recuento de historial de PIN. Por ejemplo, supongamos que un usuario tiene el PIN 12345 y la directiva de PIN del cliente impide reutilizar inmediatamente el mismo número PIN. Si ese usuario intenta renovar su PIN de cliente a través de la página web de conferencias de acceso telefónico, se rechazarán los intentos de reutilizar el mismo número PIN (12345). Sin embargo, mediante Set-CsClientPin, un administrador puede emitir el PIN 12345 para ese usuario. El motivo es que Set-CsClientPin no está sometido al recuento del historial de PIN.
Tenga en cuenta que, de manera predeterminada, las excepciones de firewall para SQL Server Express no están habilitadas cuando se instala la versión Standard Edition de Lync Server 2010. Por lo tanto, no se podrá ejecutar Set-CsClientPin desde una instancia remota de Windows PowerShell. El motivo es que el comando no podrá atravesar el firewall y obtener acceso a la base de datos de SQL Server Express. (Sin embargo, sí podrá ejecutar el cmdlet localmente en el servidor Standard Edition). Para ejecutar Set-CsClientPin de forma remota en un servidor Standard Edition tendrá que habilitar manualmente las excepciones del firewall para SQL Server Express.
Quién puede ejecutar este cmdlet: de manera predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar localmente el cmdlet Set-CsClientPin: 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 (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsClientPin"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
UserIdParameter |
Identidad de la cuenta de usuario cuyo PIN se debe configurar. 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 el formato dominio\inicio de sesión (por ejemplo, litwareinc\kenmyer); y 4) el nombre para mostrar de Active Directory del usuario (por ejemplo, Ken Myer). Las identidades de usuario también se pueden consultar utilizando el nombre distintivo de Active Directory del usuario. 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". |
Pin |
Opcional |
Entero |
PIN opcional que debe asignarse al usuario. Si no incluye el parámetro PIN, Lync Server 2010 generará un PIN de forma aleatoria y lo asignará al usuario en cuestión. Tenga en cuenta que el PIN debe respetar la longitud mínima y la configuración de patrones comunes de la directiva de PIN de cliente que tenga asignada el usuario. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan ocurrir 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 de cadena u objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Set-CsClientPin acepta la entrada transferida de valores de cadena que representen la identidad de una cuenta de usuario. El cmdlet también acepta la entrada transferida de objetos de usuario.
Tipos de valores devueltos
Set-CsClientPin no devuelve valores ni objetos. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.UserPinService.PinInfoDetails.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Set-CsClientPin -Identity "litwareinc\kenmyer"
En el Ejemplo 1, se asigna al usuario litwareinc\kenmyer un nuevo PIN generado automáticamente. Para asignar un PIN generado automáticamente, omita el parámetro Pin al llamar a Set-CsClientPin. Una vez completado el comando, se mostrará en pantalla el nuevo PIN asignado a Ken Myer; a continuación, dicha información se puede retransmitir al usuario.
-------------------------- Ejemplo 2 ------------------------
Set-CsClientPin -Identity "litwareinc\kenmyer" -Pin 18723834
El comando del Ejemplo 2 asigna el PIN 18723834 al usuario litwareinc\kenmyer. Puede asignar un PIN específico si usa el parámetro PIN seguido del número que desee asignar.
-------------------------- Ejemplo 3 ------------------------
Get-CsUser -OU "OU=Finance,DC=litwareinc,DC=com" | Set-CsClientPin
En el Ejemplo 3 se muestra cómo se pueden asignar automáticamente nuevos PIN a todos los usuarios de una determinada unidad organizativa (OU) de Active Directory. Para ello, se usa Get-CsUser con el parámetro OU para devolver una colección de todos los usuarios que tengan cuentas en la unidad organizativa Finance. A continuación, la colección se transfiere a Set-CsClientPin, que genera un nuevo PIN para todos los usuarios incluidos en la colección.
-------------------------- Ejemplo 4 ------------------------
Get-CsUser | Get-CsClientPinInfo | Where-Object {$_.IsPinSet -eq $False} | Set-CsClientPin
El comando mostrado en el Ejemplo 4 asigna un nuevo PIN a todos los usuarios que no tengan asignado un PIN. Para llevar a cabo esta tarea, se usa Get-CsUser para devolver una colección de todos los usuarios que se hayan habilitado para Lync Server 2010. A continuación, la colección se transfiere a los cmdlets Get-CsClientPin y Where-Object; estos dos cmdlets se usan para seleccionar únicamente los usuarios cuya propiedad IsPinSet sea igual a False. La colección resultante, que solo contiene los usuarios que no tienen PIN, se transfiere a Set-CsClientPin, que genera automáticamente un PIN para todos los usuarios incluidos en la colección.