LOGINPROPERTY (Transact-SQL)
Devuelve información sobre la configuración de la directiva de inicio de sesión.
Sintaxis
LOGINPROPERTY ( 'login_name' ,
{ 'IsLocked' | 'IsExpired' | 'IsMustChange'
| 'BadPasswordCount' | 'BadPasswordTime'
| 'HistoryLength' | 'LockoutTime'
| 'PasswordLastSetTime' | 'PasswordHash' }
)
Argumentos
- login_name
Es el nombre de un inicio de sesión de SQL Server para el que se devolverá el estado de la propiedad login.
- 'IsLocked'
Devuelve información que indicará si el inicio de sesión está bloqueado.
- 'IsExpired'
Devuelve información que indicará si el inicio de sesión ha caducado.
- 'IsMustChange'
Devuelve información que indicará si se debe cambiar la contraseña del inicio de sesión la próxima vez que se conecte.
- 'BadPasswordCount'
Devuelve el número de intentos consecutivos de inicio de sesión con una contraseña incorrecta.
- 'BadPasswordTime'
Devuelve la hora del último intento de inicio de sesión con una contraseña incorrecta.
- 'HistoryLength'
Devuelve el tiempo durante el que se ha realizado un seguimiento del inicio de sesión con el sistema de aplicación de la directiva de contraseñas.
- 'LockoutTime'
Devuelve la fecha en la que se bloqueó el inicio de sesión de SQL Server por haber superado el número permitido de intentos de inicio de sesión erróneos.
- 'PasswordLastSetTime'
Devuelve la fecha en la que se estableció la contraseña actual.
- 'PasswordHash'
Devuelve el hash de la contraseña.
Notas
Esta función integrada devuelve información sobre la configuración de la directiva de contraseñas de un inicio de sesión de SQL Server. Los nombres de las propiedades no distinguen mayúsculas de minúsculas, por lo que nombres de propiedades como BadPasswordCount y badpasswordcount son equivalentes. Los valores de las propiedades PasswordHash y PasswordLastSetTime están disponibles en todas las configuraciones compatibles de SQL Server 2005, pero las demás propiedades sólo están disponibles cuando se ejecuta SQL Server 2005 en Windows Server 2003 y CHECK_POLICY y CHECK_EXPIRATION están habilitadas.
Permisos
Requiere permiso VIEW en el inicio de sesión. También se necesita permiso CONTROL SERVER para solicitar el hash de contraseña.
Devuelve
El tipo de datos depende del valor solicitado.
IsLocked, IsExpired e IsMustChange son de tipo int.
- 1 si el inicio de sesión está en el estado especificado.
- 0 si el inicio de sesión está en el estado especificado.
BadPasswordCount es de tipo int.
BadPasswordTime, HistoryLength, LockoutTime y PasswordLastSetTime son de tipo datetime.
PasswordHash es de tipo varbinary.
NULL si el inicio de sesión no es un inicio de sesión de SQL Server válido.
Ejemplos
A. Comprobar si se debe cambiar la contraseña de un inicio de sesión
En el ejemplo siguiente se comprueba si el inicio de sesión WillisJO de SQL Server debe cambiar la contraseña la próxima vez que se conecte a una instancia de SQL Server.
SELECT LOGINPROPERTY('WillisJO', 'IsMustChange');
GO
B. Comprobar si un inicio de sesión está bloqueado
En el ejemplo siguiente se comprueba si el inicio de sesión SamirK de SQL Server está bloqueado.
SELECT LOGINPROPERTY('SamirK', 'IsLocked');
GO
Vea también
Referencia
sys.server_principals (Transact-SQL)