Get-CsClientPinInfo
Última modificación del tema: 2012-03-23
Recupera información sobre el número de identificación personal (PIN) asignado a un usuario.
Sintaxis
Get-CsClientPinInfo -Identity <UserIdParameter> [-Confirm [<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. Por lo general, para iniciar sesión en el sistema o para unirse a una conferencia, el usuario debe especificar un nombre de usuario o una contraseña. Sin embargo, la especificación de un nombre de usuario o de una contraseña puede ser un problema si se usa un teléfono que no tiene un teclado alfanumérico. Por este motivo, Lync Server 2010 le permite proporcionar a los usuarios 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 escribiendo el número PIN en lugar de un nombre de usuario y una contraseña.
Los administradores pueden recuperar la configuración de PIN para un usuario o un grupo de usuarios por medio de la ejecución del cmdlet Get-CsClientPinInfo. Tenga en cuenta que no hay forma de que un administrador recupere el número PIN que se le ha asignado a un usuario. Si un usuario olvida su número PIN, dicho usuario no podrá usar la autenticación de PIN para obtener acceso al sistema hasta que un administrador les haya asignado un nuevo número PIN o que el usuario haya obtenido un nuevo número PIN de la página web de conferencia de acceso telefónico local.
Tenga en cuenta que, de manera predeterminada, las excepciones de firewall para SQL Server Express no están habilitadas cuando se instala la Standard Edition de Lync Server 2010. Esto significa que no podrá ejecutar Get-CsClientPinInfo desde una instancia remota de Windows PowerShell; esto sucede porque el comando no podrá atravesar el firewall y obtener acceso a la base de datos de SQL Server Express. (Sin embargo, todavía se puede ejecutar el cmdlet localmente en Servidor Standard Edition). Para ejecutar Get-CsClientPinInfo de manera remota frente a un Servidor Standard Edition, deberá habilitar las excepciones de firewall manualmente para SQL Server Express.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Get-CsClientPinInfo localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsClientPinInfo"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Parámetro UserId |
Indica el parámetro Identity de la cuenta de usuario cuyo número PIN debe bloquearse. 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 de inicio de sesión (por ejemplo, litwareinc\kenmyer), y 4) el nombre para mostrar de Active Directory del usuario (por ejemplo, Ken Myer). Asimismo, puede hacer referencia a una cuenta de usuario por medio del nombre distintivo de Active Directory del usuario. Puede usar el asterisco (*) como comodín al usar el Nombre para mostrar como identidad del usuario. Por ejemplo, el parámetro Identity "* Smith" devolvería todos los usuarios cuyo nombre para mostrar termine con el valor de cadena " Smith". |
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. Get-CsClientPinInfo acepta entradas canalizadas de valores de cadena que representan el parámetro Identity de una cuenta de usuario. Asimismo, el cmdlet acepta entradas canalizadas de objetos de usuario.
Tipos de valores devueltos
Get-CsClientPinInfo devuelve una o más instancias del objeto Microsoft.Rtc.Management.UserPinService.PinInfoDetails.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsUser | Get-CsClientPinInfo
El comando anterior devuelve la información de PIN a todos los usuarios que se han habilitado en Lync Server 2010. Para llevar a cabo esta acción, el comando primero llama a Get-CsUser para devolver a todos los usuarios que se han habilitado en Lync Server 2010. Esa recopilación se redirecciona a Get-CsClientPinInfo, que muestra información de PIN para cada usuario en la recopilación.
-------------------------- Ejemplo 2 --------------------------
Get-CsClientPinInfo -Identity "litwareinc\kenmyer"
En el Ejemplo 2, Get-CsClientPinInfo se usa para mostrar información de PIN de un único usuario: El usuario con valor Identity litwareinc\kenmyer.
-------------------------- Ejemplo 3 --------------------------
Get-CsUser -OU "OU=Finance,DC=litwareinc,DC=com" | Get-CsClientPinInfo
El Ejemplo 3 devuelve información de PIN a todos los usuarios con cuentas en la unidad organizativa (OU) Finance. Para llevar a cabo esta acción, Get-CsUser y el parámetro OU se usan primero para devolver una recopilación de todos los usuarios en la OU Finance. Luego, esa recopilación se redirecciona a Get-CsClientPinInfo, que muestra información de PIN para cada usuario en la recopilación.
-------------------------- Ejemplo 4 --------------------------
Get-CsUser -LdapFilter "Title=Manager" | Get-CsClientPinInfo
El comando que se muestra en el Ejemplo 4 muestra información de PIN para todos los administradores en la organización. Para recuperar una recopilación de todos los administradores, el comando usa Get-CsUser y el parámetro LdapFilter; el valor de filtro "Title=Manager" limita la recopilación que se devuelve a usuarios que tienen "Manager" (administrador) como su cargo. Get-CsClientPinInfo se usa para mostrar información de PIN para cada uno de esos usuarios.