다음을 통해 공유

LOGINPROPERTY(Transact-SQL)

로그인 정책 설정에 대한 정보를 반환합니다.

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

LOGINPROPERTY ( 'login_name' , 'property_name' )

인수

  • login_name.
    로그인 속성 상태가 반환되는 SQL Server 로그인의 이름입니다.

  • propertyname
    반환될 로그인 속성 정보가 포함된 식입니다. propertyname은 다음 값 중 하나일 수 있습니다.

    값

    설명

    BadPasswordCount

    잘못된 암호를 사용하여 연속해서 로그인을 시도한 횟수를 반환합니다.

    BadPasswordTime

    잘못된 암호를 사용하여 마지막으로 로그인을 시도한 시간을 반환합니다.

    DaysUntilExpiration

    암호 만료일까지 남은 일 수를 반환합니다.

    DefaultDatabase

    데이터베이스가 지정되지 않은 경우 메타데이터 또는 master에 저장된 SQL Server 로그인의 기본 데이터베이스를 반환합니다. SQL Server 이외 로그인이 제공되는 사용자(예: Windows 인증 사용자)의 경우 NULL을 반환합니다.

    DefaultLanguage

    메타데이터에 저장된 로그인 기본 언어를 반환합니다. SQL Server 이외 로그인이 제공되는 사용자(예: Windows 인증 사용자)의 경우 NULL을 반환합니다.

    HistoryLength

    암호 정책 적용 메커니즘을 사용하여 로그인이 추적된 기간을 반환합니다.

    IsExpired

    로그인이 만료되었는지 여부를 나타내는 정보를 반환합니다.

    IsLocked

    로그인이 잠겨 있는지 여부를 나타내는 정보를 반환합니다.

    IsMustChange

    로그인이 다음에 연결할 때 해당 암호를 변경해야 하는지 여부를 나타내는 정보를 반환합니다.

    LockoutTime

    SQL Server 로그인이 허용되는 로그인 시도 실패 횟수를 초과하여 잠긴 날짜를 반환합니다.

    PasswordHash

    암호의 해시를 반환합니다.

    PasswordLastSetTime

    현재 암호가 설정된 날짜를 반환합니다.

반환 값

데이터 형식은 요청된 값에 따라 달라집니다.

IsLocked, IsExpired 및 IsMustChange는 int 유형입니다.

  • 로그인이 지정된 상태에 있으면 1을 반환합니다.

  • 로그인이 지정된 상태에 있지 않으면 0을 반환합니다.

BadPasswordCount는 int 유형입니다.

BadPasswordTime, HistoryLength, LockoutTime 및 PasswordLastSetTime은 datetime 유형입니다.

PasswordHash는 varbinary 유형입니다.

로그인이 올바른 SQL Server 로그인이 아니면 NULL을 반환합니다.

DaysUntilExpiration은 int 유형입니다.

로그인이 만료되었거나 쿼리한 날에 만료되는 경우 0입니다.

Windows의 로컬 보안 정책으로 인해 암호가 만료되지 않는 경우 -1입니다.

CHECK_POLICY 또는 CHECK_EXPIRATION이 로그인에 대해 OFF이거나 운영 체제에서 암호 정책을 지원하지 않는 경우 NULL입니다.

주의

이 기본 제공 함수는 SQL Server 로그인의 암호 정책 설정에 대한 정보를 반환합니다. 속성 이름은 대/소문자를 구분하지 않으므로 속성 이름 BadPasswordCount와 badpasswordcount는 같습니다. PasswordHash 및 PasswordLastSetTime 속성 값은 SQL Server에서 지원하는 모든 구성에서 사용할 수 있지만 다른 속성은 SQL Server가 Windows Server 2003에서 실행 중이고 CHECK_POLICY 및 CHECK_EXPIRATION이 모두 설정된 경우에만 사용할 수 있습니다. 자세한 내용은 암호 정책을 참조하십시오.

사용 권한

로그인에 대한 VIEW 권한이 필요합니다. 암호 해시를 요청하는 경우 CONTROL SERVER 권한도 필요합니다.

예

1. 로그인이 해당 암호를 변경해야 하는지 여부 확인

다음 예에서는 SQL Server 로그인 John3가 다음에 SQL Server 인스턴스에 연결할 때 해당 암호를 변경해야 하는지 여부를 확인합니다.

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

2. 로그인이 잠겼는지 여부 확인

다음 예에서는 SQL Server 로그인 John3가 잠겼는지 여부를 확인합니다.

SELECT LOGINPROPERTY('John3', 'IsLocked');
GO
  • Last updated on