LOGINPROPERTY (Transact-SQL)
Berlaku untuk:
SQL Server Azure SQL Managed Instance
Mengembalikan informasi tentang pengaturan kebijakan masuk.
Sintaks
LOGINPROPERTY ( 'login_name' , 'property_name' )
Argumen
login_name
Adalah nama login SQL Server yang status properti masuknya akan dikembalikan.
nama properti
Adalah ekspresi yang berisi informasi properti yang akan dikembalikan untuk masuk. propertyname bisa menjadi salah satu nilai berikut.
| Nilai | Deskripsi |
|---|---|
| BadPasswordCount | Mengembalikan jumlah upaya berturut-turut untuk masuk dengan kata sandi yang salah. |
| BadPasswordTime | Mengembalikan waktu upaya terakhir untuk masuk dengan kata sandi yang salah. |
| DaysUntilExpiration | Mengembalikan jumlah hari hingga kata sandi kedaluwarsa. |
| DefaultDatabase | Mengembalikan database default masuk SQL Server seperti yang disimpan dalam metadata atau master jika tidak ada database yang ditentukan. Mengembalikan NULL untuk pengguna yang disediakan non-SQL Server (misalnya, pengguna yang diautentikasi Windows). |
| DefaultLanguage | Mengembalikan bahasa default masuk seperti yang disimpan dalam metadata. Mengembalikan NULL untuk pengguna yang disediakan non-SQL Server, misalnya, pengguna yang diautentikasi Windows. |
| HistoryLength | Mengembalikan jumlah kata sandi yang dilacak untuk login, menggunakan mekanisme penegakan kebijakan kata sandi. 0 jika kebijakan kata sandi tidak diberlakukan. Memulai ulang penegakan kebijakan kata sandi dimulai ulang pada 1. |
| IsExpired | Menunjukkan apakah kata sandi masuk telah kedaluwarsa. |
| Diblokir | Menunjukkan apakah login dikunci. |
| IsMustChange | Menunjukkan apakah login harus mengubah kata sandinya saat berikutnya terhubung. |
| LockoutTime | Mengembalikan tanggal ketika login SQL Server dikunci karena telah melebihi jumlah upaya masuk yang gagal yang diizinkan. |
| PasswordHash | Mengembalikan hash kata sandi. |
| PasswordLastSetTime | Mengembalikan tanggal ketika kata sandi saat ini diatur. |
| PasswordHashAlgorithm | Mengembalikan algoritma yang digunakan untuk hash kata sandi. |
Mengembalikan
Jenis data tergantung pada nilai yang diminta.
IsLocked, IsExpired, dan IsMustChange berjenis int.
1 jika login dalam status yang ditentukan.
0 jika login tidak dalam status yang ditentukan.
BadPasswordCount dan HistoryLength berjenis int.
BadPasswordTime, LockoutTime, PasswordLastSetTime adalah jenis tanggalwaktu.
PasswordHash berjenis varbinary.
NULL jika login bukan login SQL Server yang valid.
DaysUntilExpiration berjenis int.
0 jika login kedaluwarsa atau jika akan kedaluwarsa pada hari ketika dikueri.
-1 jika kebijakan keamanan lokal di Windows tidak pernah kedaluwarsa kata sandi.
NULL jika CHECK_POLICY atau CHECK_EXPIRATION NONAKTIF untuk login, atau jika sistem operasi tidak mendukung kebijakan kata sandi.
PasswordHashAlgorithm berjenis int.
0 jika hash SQL7.0
1 jika hash SHA-1
2 jika hash SHA-2
NULL jika login bukan login SQL Server yang valid
Keterangan
Fungsi bawaan ini mengembalikan informasi tentang pengaturan kebijakan kata sandi dari login SQL Server. Nama properti tidak peka huruf besar/kecil, sehingga nama properti seperti BadPasswordCount dan badpasswordcount setara. Nilai properti PasswordHash, PasswordHashAlgorithm, dan PasswordLastSetTime tersedia di semua konfigurasi SQL Server yang didukung, tetapi properti lainnya hanya tersedia ketika SQL Server berjalan di Windows Server 2003 dan CHECK_POLICY dan CHECK_EXPIRATION diaktifkan. Untuk informasi selengkapnya, lihat Kebijakan Kata Sandi.
Izin
Memerlukan izin VIEW pada login. Saat meminta hash kata sandi, juga memerlukan izin SERVER KONTROL.
Contoh
J. Memeriksa apakah login harus mengubah kata sandinya
Contoh berikut memeriksa apakah login John3 SQL Server harus mengubah kata sandinya saat berikutnya terhubung ke instans SQL Server.
SELECT LOGINPROPERTY('John3', 'IsMustChange');
GO
B. Memeriksa apakah login dikunci
Contoh berikut memeriksa apakah login John3 SQL Server dikunci.
SELECT LOGINPROPERTY('John3', 'IsLocked');
GO