LOGINPROPERTY (Transact-SQL)

Artikel
12/15/2008

Gibt Informationen zu Richtlinieneinstellungen für die Anmeldung zurück.

Syntax

LOGINPROPERTY ( 'login_name' , 
                                    { 'IsLocked' | 'IsExpired' | 'IsMustChange'
                                    | 'BadPasswordCount' | 'BadPasswordTime' 
                                    | 'HistoryLength' | 'LockoutTime' 
                                    | 'PasswordLastSetTime' | 'PasswordHash' } 
                            )

Argumente

login_name
Der Name einer SQL Server-Anmeldung, für die der Status der Anmeldungseigenschaften zurückgegeben wird.

'IsLocked'
Gibt Informationen darüber zurück, ob die Anmeldung gesperrt ist.

'IsExpired'
Gibt Informationen darüber zurück, ob die Anmeldung abgelaufen ist.

'IsMustChange'
Gibt Informationen darüber zurück, ob das Anmeldekennwort bei der nächsten Verbindung geändert werden muss.

'BadPasswordCount'
Gibt die Anzahl aufeinander folgender Anmeldeversuche mit einem falschen Kennwort zurück.

'BadPasswordTime'
Gibt die Zeit des letzten Anmeldeversuchs mit einem falschen Kennwort zurück.

'HistoryLength'
Gibt die Länge der Zeit zurück, in der die Anmeldung mithilfe der Mechanismen zur Durchsetzung von Kennwortrichtlinien nachverfolgt wurde.

'LockoutTime'
Gibt das Datum zurück, an dem die SQL Server-Anmeldung gesperrt wurde, da die zulässige Anzahl fehlgeschlagener Anmeldeversuche überschritten wurde.

'PasswordLastSetTime'
Gibt das Datum zurück, an dem das aktuelle Kennwort festgelegt wurde.

'PasswordHash'
Gibt den Hash des Kennworts zurück.

Hinweise

Diese integrierte Funktion gibt Informationen zu den Kennwortrichtlinien-Einstellungen einer SQL Server-Anmeldung zurück. Bei den Namen der Eigenschaften wird die Groß-/Kleinschreibung nicht beachtet. Somit sind Eigenschaftsnamen wie BadPasswordCount und badpasswordcount gleichwertig. Die Werte der Eigenschaften PasswordHash und PasswordLastSetTime sind in allen unterstützten Konfigurationen von SQL Server 2005 verfügbar, die anderen Eigenschaften jedoch nur, wenn SQL Server 2005 unter Windows Server 2003 ausgeführt wird und CHECK_POLICY und CHECK_EXPIRATION aktiviert sind.

Berechtigungen

Erfordert die VIEW-Berechtigung für die Anmeldung. Wenn der Kennworthash angefordert wird, ist auch die CONTROL SERVER-Berechtigung erforderlich.

Rückgabewert

Der Datentyp hängt vom angeforderten Wert ab.

IsLocked, IsExpired und IsMustChange sind vom Typ int.

1, wenn sich die Anmeldung im angegebenen Status befindet.
0, wenn sich die Anmeldung nicht im angegebenen Status befindet.

BadPasswordCount ist vom Typ int.

BadPasswordTime, HistoryLength, LockoutTime und PasswordLastSetTime sind vom Typ datetime.

PasswordHash ist vom Typ varbinary.

NULL, wenn es sich bei der Anmeldung nicht um eine gültige SQL Server-Anmeldung handelt.

Beispiele

A. Überprüfen, ob das Kennwort einer Anmeldung geändert werden muss

Im folgenden Beispiel wird überprüft, ob das Kennwort des SQL Server-Anmeldenamens WillisJO geändert werden muss, wenn das nächste Mal unter diesem Anmeldenamen eine Verbindung mit einer Instanz von SQL Server hergestellt wird.

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

B. Überprüfen, ob eine Anmeldung gesperrt ist

Im folgenden Beispiel wird überprüft, ob der SQL Server-Anmeldename SamirK gesperrt ist.

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

Siehe auch