Megosztás:


LOGINPROPERTY (Transact-SQL)

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSQL-adatbázis a Microsoft Fabricben

A bejelentkezési szabályzat beállításaival kapcsolatos információkat adja vissza.

Transact-SQL szintaxis konvenciók

Szemantika

LOGINPROPERTY ( 'login_name' , 'property_name' )

Érvek

login_name

Annak az SQL Server-bejelentkezésnek a neve, amelyhez a bejelentkezési tulajdonság állapota vissza lesz adva.

propertyname

A bejelentkezéshez visszaadandó tulajdonságadatokat tartalmazó kifejezés. A tulajdonságnév az alábbi értékek egyike lehet.

Érték Leírás
BadPasswordCount A helytelen jelszóval való bejelentkezés egymást követő kísérleteinek számát adja vissza.
BadPasswordTime Az utolsó, helytelen jelszóval történő bejelentkezésre tett kísérlet időpontját adja vissza.
DaysUntilExpiration A jelszó lejáratáig érvényes napok számát adja vissza.
DefaultDatabase A metaadatokban tárolt alapértelmezett SQL Server bejelentkezési adatbázist adja vissza, vagy master ha nincs megadva adatbázis. Null értéket ad vissza a nem SQL Serverrel kiépített felhasználók (például a Windows által hitelesített felhasználók) számára.
DefaultLanguage A metaadatokban tárolt alapértelmezett bejelentkezési nyelvet adja vissza. Null értéket ad vissza a nem SQL Serverrel kiépített felhasználók, például a Windows által hitelesített felhasználók számára.
HistoryLength A bejelentkezéshez nyomon követett jelszavak számát adja vissza a jelszóházirend-kényszerítési mechanizmus használatával. 0, ha a jelszóházirend nincs kényszerítve. A jelszóházirend-kényszerítés újraindul 1 időpontban.
IsExpired Azt jelzi, hogy a bejelentkezési jelszó lejárt-e.
IsLocked Azt jelzi, hogy a bejelentkezés zárolva van-e.
IsMustChange Azt jelzi, hogy a bejelentkezésnek módosítania kell-e a jelszavát, amikor legközelebb csatlakozik.
LockoutTime Azt a dátumot adja vissza, amikor az SQL Server-bejelentkezés zárolva lett, mert túllépte a sikertelen bejelentkezési kísérletek engedélyezett számát.
PasswordHash A jelszó kivonatát adja vissza.
PasswordLastSetTime Az aktuális jelszó beállításának dátumát adja vissza.
PasswordHashAlgorithm A jelszó kivonatához használt algoritmust adja vissza. Az SQL Server 2022 (16.x) és korábbi verzióiban a tárolt jelszóadatok kiszámítása a sózott jelszó SHA-512 használatával történik. Az SQL Server 2025-től (17.x) kezdve egy iterált hash algoritmust, RFC2898 (PBKDF) rendszert használnak. A hash első bájtja a verziót jelzi: 0x02 a 2-es verzióhoz (SQL Server 2022 (16.x) és korábbi verziók), 0x03 valamint a 3-as verzióhoz (SQL Server 2025 (17.x) és későbbi verziók).

Visszatérítések

Az adattípus a kért értéktől függ.

Az IsLocked, az IsExpired és az IsMustChange típus int típusú.

  • 1, ha a bejelentkezés a megadott állapotban van.

  • 0, ha a bejelentkezés nem a megadott állapotban van.

A BadPasswordCount és a HistoryLength típus int típusú.

A BadPasswordTime, a LockoutTime, a PasswordLastSetTimedátum/idő típusú.

A PasswordHashvarbinary típusú.

NULL értékű, ha a bejelentkezés nem érvényes SQL Server-bejelentkezés.

A DaysUntilExpirationint típusú.

  • 0, ha a bejelentkezés lejárt, vagy a lekérdezés napján lejár.

  • -1, ha a Windows helyi biztonsági szabályzata soha nem jár le a jelszóval.

  • NULL érték, ha a CHECK_POLICY vagy CHECK_EXPIRATION ki van kapcsolva egy bejelentkezéshez, vagy ha az operációs rendszer nem támogatja a jelszóházirendet.

A PasswordHashAlgorithm int típusú.

  • 0 sql7.0 kivonat esetén

  • 1 ha SHA-1 kivonat

  • 2 ha SHA-2 kivonat

  • NULL érték, ha a bejelentkezés nem érvényes SQL Server-bejelentkezés

Megjegyzések

Ez a beépített függvény egy SQL Server-bejelentkezés jelszóházirend-beállításaival kapcsolatos információkat ad vissza. A tulajdonságok neve nem megkülönbözteti a kis- és nagybetűket, ezért az olyan tulajdonságnevek, mint a BadPasswordCount és a badpasswordcount , egyenértékűek. A PasswordHash, a PasswordHashAlgorithm és a PasswordLastSetTime tulajdonságok értékei az SQL Server összes támogatott konfigurációjában elérhetők, a többi tulajdonság azonban csak akkor érhető el, ha az SQL Server Windows Server 2003 rendszeren fut, és mind a CHECK_POLICY, mind a CHECK_EXPIRATION engedélyezve van. További információ: Jelszóházirend.

Engedélyek

Megtekintési engedélyt igényel a bejelentkezéshez. A jelszókivonat kéréséhez CONTROL SERVER-engedélyre is szükség van.

Példák

Egy. Annak ellenőrzése, hogy a bejelentkezésnek módosítania kell-e a jelszavát

Az alábbi példa azt ellenőrzi, hogy az SQL Server-bejelentkezésnek John3 módosítania kell-e a jelszavát, amikor legközelebb csatlakozik egy SQL Server-példányhoz.

SELECT LOGINPROPERTY('John3', 'IsMustChange');
GO

B. Annak ellenőrzése, hogy a bejelentkezés zárolva van-e

Az alábbi példa ellenőrzi, hogy az SQL Server-bejelentkezés John3 zárolva van-e.

SELECT LOGINPROPERTY('John3', 'IsLocked');
GO