xp_logininfo(Transact-SQL)

  • 아티클

적용 대상:SQL Server

Windows 사용자와 Windows 그룹에 대한 정보를 반환합니다.

Transact-SQL 구문 표기 규칙

구문

xp_logininfo [ [ @acctname = ] 'account_name' ]
     [ , [ @option = ] 'all' | 'members' ]
     [ , [ @privilege = ] 'variable_name' OUTPUT ]

인수

[ @acctname = ] '@acctname'

SQL Server에 대한 액세스 권한이 부여된 Windows 사용자 또는 그룹의 이름입니다. @acctname sysname이며 기본값은 .입니다NULL. @acctname 지정되지 않은 경우 명시적으로 로그인 권한이 부여된 모든 Windows 그룹 및 Windows 사용자가 보고됩니다. @acctname 정규화되어야 합니다. 예를 들면 CONTOSO\macraes 또는 BUILTIN\Administrators과 같습니다.

[ @option = ] 'all' | 'members' ]

계정에 대한 모든 사용 권한 경로에 대한 정보를 보고할지 아니면 Windows 그룹의 멤버에 대한 정보를 보고할지를 지정합니다. @option 기본값NULL인 varchar(10)입니다. 지정하지 않으면 all 첫 번째 권한 경로만 표시됩니다.

[ @privilege = ] 'variable_name' OUTPUT ]

지정된 Windows 계정의 권한 수준을 반환하는 출력 매개 변수입니다. @privilege 기본값Not wanted인 varchar(10)입니다. 반환되는 권한 수준은 사용자, 관리자 또는 null입니다.

이 옵션을 지정하면 OUTPUT 출력 매개 변수에 @privilege 배치됩니다.

반환 코드 값

0 (성공) 또는 1 (실패).

결과 집합

열 이름 데이터 형식 설명
계정 이름 sysname 정규화된 Windows 계정 이름입니다.
type char(8) Windows 계정의 유형입니다. 유효한 값은 user 또는 group입니다.
권한 char(9) SQL Server에 대한 액세스 권한입니다. 유효한 값은 admin, user 또는 NULL입니다.
매핑된 로그인 이름 sysname 사용자 권한이 있는 사용자 계정의 경우 매핑된 로그인 이름은 매핑된 규칙을 사용하여 SQL Server가 이 계정으로 로그인할 때 사용하려는 매핑된 로그인 이름을 표시합니다기본 이름 앞에 추가되었습니다.
사용 권한 경로 sysname 계정 액세스를 허용한 그룹 멤버 자격입니다.

설명

@acctname 지정 xp_logininfo 한 경우 지정된 Windows 사용자 또는 그룹의 가장 높은 권한 수준을 보고합니다. Windows 사용자가 시스템 관리자와 기본 사용자로 모두 액세스할 수 있는 경우 시스템 관리자로 보고됩니다. 사용자가 동일한 권한 수준의 여러 Windows 그룹의 구성원인 경우 SQL Server에 대한 액세스 권한이 처음 부여된 그룹만 보고됩니다.

@acctname SQL Server 로그인과 연결되지 않은 유효한 Windows 사용자 또는 그룹인 경우 빈 결과 집합이 반환됩니다. @acctname 유효한 Windows 사용자 또는 그룹으로 식별할 수 없는 경우 오류 메시지가 반환됩니다.

@acctnameall 지정되면 Windows 사용자 또는 그룹에 대한 모든 권한 경로가 반환됩니다. @acctname 모두 SQL Server에 대한 액세스 권한이 부여된 여러 그룹의 멤버인 경우 여러 행이 반환됩니다. 권한 행은 admin 권한 행 앞에 user 반환되고 권한 수준 내에서 해당 SQL Server 로그인을 만든 순서대로 행이 반환됩니다.

@acctnamemembers 지정되면 그룹의 다음 수준 멤버 목록이 반환됩니다. @acctname 로컬 그룹인 경우 목록에는 로컬 사용자, 할 일기본 사용자 및 그룹이 포함될 수 있습니다. @acctname do기본 계정인 경우 목록은 할 일기본 사용자로 구성됩니다. SQL Server는 do기본 컨트롤러에 연결하여 그룹 멤버 자격 정보를 검색해야 합니다. 서버가 do기본 컨트롤러에 연결할 수 없는 경우 정보가 반환되지 않습니다.

xp_logininfo 는 범용 그룹이 아닌 Active Directory 전역 그룹의 정보만 반환합니다.

사용 권한

Sysadmin 고정 서버 역할의 멤버 자격 또는 EXECUTE 권한이 부여된 데이터베이스의 공용 고정 데이터베이스 역할 master 의 멤버 자격이 필요합니다.

예제

다음 예제에서는 Windows 그룹에 대한 BUILTIN\Administrators 정보를 표시합니다.

EXEC xp_logininfo 'BUILTIN\Administrators';

관련 콘텐츠