Partager via

  • Article

LOGINPROPERTY (Transact-SQL)

Retourne des informations sur les paramètres de stratégie de connexion.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

LOGINPROPERTY ( 'login_name' , 'property_name' )

Argument

  • login_name.
    Nom d'une connexion SQL Server pour laquelle l'état des propriétés de connexion est retourné.

  • propertyname
    Expression contenant les informations de propriété devant être retournées pour la connexion. L'argument propertyname peut prendre l'une des valeurs suivantes.

    Valeur

    Description

    BadPasswordCount

    Retourne le nombre de tentatives de connexion consécutives effectuées avec un mot de passe incorrect.

    BadPasswordTime

    Retourne l'heure de la dernière tentative de connexion effectuée avec un mot de passe incorrect.

    DaysUntilExpiration

    Retourne le nombre de jours avant l'expiration du mot de passe.

    DefaultDatabase

    Retourne la base de données par défaut de la connexion SQL Server telle que stockée dans les métadonnées ou master si aucune base de données n'est spécifiée. Retourne NULL pour les utilisateurs fournis non-SQL Server ; par exemple, les utilisateurs authentifiés Windows.

    DefaultLanguage

    Retourne la langue par défaut de connexion telle que stockée dans les métadonnées. Retourne NULL pour les utilisateurs fournis non-SQL Server, par exemple les utilisateurs authentifiés Windows.

    HistoryLength

    Retourne la durée pendant laquelle la connexion a fait l'objet d'un suivi à l'aide du mécanisme d'application des stratégies de mot de passe.

    IsExpired

    Retourne des informations qui indiquent si la connexion a expiré.

    IsLocked

    Retourne des informations qui indiquent si la connexion est verrouillée.

    IsMustChange

    Retourne des informations qui indiquent si la connexion doit modifier son mot de passe lors de l'établissement de la connexion suivante.

    LockoutTime

    Retourne la date à laquelle la connexion SQL Server a été verrouillée en raison du dépassement du nombre de tentatives de connexion autorisé.

    PasswordHash

    Retourne le hachage du mot de passe.

    PasswordLastSetTime

    Retourne la date à laquelle le mot de passe actuel a été défini.

Valeur retournée

Le type de données dépend de la valeur demandée.

IsLocked, IsExpired et IsMustChange sont de type int.

  • 1 si la connexion est dotée de l'état spécifié.

  • 0 si la connexion n'est pas dotée de l'état spécifié.

BadPasswordCount est de type int.

BadPasswordTime, HistoryLength, LockoutTime et PasswordLastSetTime sont de type datetime.

PasswordHash est de type varbinary.

NULL si la connexion n'est pas une connexion SQL Server valide.

DaysUntilExpiration est de type int.

0 si la connexion a expiré ou si elle expirera le jour de l'interrogation.

-1 si la stratégie de sécurité locale dans Windows ne fait jamais expirer le mot de passe.

NULL si CHECK_POLICY ou CHECK_EXPIRATION a la valeur OFF pour une connexion, ou si le système d'exploitation ne prend pas en charge la stratégie de mot de passe.

Notes

Cette fonction intégrée retourne des informations sur les paramètres de stratégie de mot de passe d'une connexion SQL Server. Étant donné que les noms des propriétés ne respectent pas la casse, les noms de propriété tels que BadPasswordCount et badpasswordcount sont équivalents. Les valeurs des propriétés PasswordHash et PasswordLastSetTime sont disponibles sur toutes les configurations de SQL Server prises en charge, mais les autres propriétés ne sont disponibles que si SQL Server est en cours d'exécution sous Windows Server 2003 et que CHECK_POLICY et CHECK_EXPIRATION sont tous les deux activés. Pour plus d'informations, consultez Stratégie de mot de passe.

Autorisations

Requiert l'autorisation VIEW sur la connexion. Pour la demande du hachage de mot de passe, requiert en outre l'autorisation CONTROL SERVER.

Exemples

A. Détermination de la nécessité de modifier le mot de passe d'une connexion

L'exemple suivant vérifie si la connexion SQL ServerJohn3 doit modifier son mot de passe lorsqu'elle se connecte la fois suivante à une instance de SQL Server.

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

B. Vérification du verrouillage d'une connexion

L'exemple suivant vérifie si la connexion SQL ServerJohn3 est verrouillée.

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