xp_logininfo(Transact-SQL)
적용 대상: 
SQL Server
Windows 사용자와 Windows 그룹에 대한 정보를 반환합니다.
구문
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 사용자 또는 그룹으로 식별할 수 없는 경우 오류 메시지가 반환됩니다.
@acctname all 지정되면 Windows 사용자 또는 그룹에 대한 모든 권한 경로가 반환됩니다. @acctname 모두 SQL Server에 대한 액세스 권한이 부여된 여러 그룹의 멤버인 경우 여러 행이 반환됩니다. 권한 행은 admin 권한 행 앞에 user 반환되고 권한 수준 내에서 해당 SQL Server 로그인을 만든 순서대로 행이 반환됩니다.
@acctname members 지정되면 그룹의 다음 수준 멤버 목록이 반환됩니다. @acctname 로컬 그룹인 경우 목록에는 로컬 사용자, 도메인 사용자 및 그룹이 포함될 수 있습니다. @acctname 도메인 계정인 경우 목록은 도메인 사용자로 구성됩니다. 그룹 멤버 자격 정보를 검색하려면 SQL Server가 도메인 컨트롤러에 연결해야 합니다. 서버가 도메인 컨트롤러에 연결할 수 없는 경우 정보가 반환되지 않습니다.
xp_logininfo 는 범용 그룹이 아닌 Active Directory 전역 그룹의 정보만 반환합니다.
사용 권한
Sysadmin 고정 서버 역할의 멤버 자격 또는 EXECUTE 권한이 부여된 데이터베이스의 공용 고정 데이터베이스 역할 master 의 멤버 자격이 필요합니다.
예제
다음 예제에서는 Windows 그룹에 대한 BUILTIN\Administrators 정보를 표시합니다.
EXEC xp_logininfo 'BUILTIN\Administrators';