적용 대상:
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' | '멤버'
계정에 대한 모든 사용 권한 경로에 대한 정보를 보고할지 아니면 Windows 그룹의 멤버에 대한 정보를 보고할지를 지정합니다.
@option 기본값인 varchar(10)NULL. 지정하지 않으면 all 첫 번째 권한 경로만 표시됩니다.
[ @privilege = ] 'variable_name' OUTPUT
지정된 Windows 계정의 권한 수준을 반환하는 출력 매개 변수입니다.
@privilege 기본값인 varchar(10)Not wanted. 반환되는 권한 수준은 user, admin또는 null.
이 옵션을 지정하면 OUTPUT 출력 매개 변수에 @privilege 배치됩니다.
반환 코드 값
0(성공) 또는 1(실패).
결과 집합
| 열 이름 | 데이터 형식 | 설명 |
|---|---|---|
account name |
sysname | 정규화된 Windows 계정 이름입니다. |
type |
char(8) | Windows 계정의 유형입니다. 유효한 값은 user 또는 group입니다. |
privilege |
char(9) | SQL Server에 대한 액세스 권한입니다. 유효한 값은 admin, user 또는 NULL입니다. |
mapped login name |
sysname | 사용자 권한이 있는 사용자 계정의 경우 mapped login name SQL Server가 이전에 추가된 도메인 이름과 매핑된 규칙을 사용하여 이 계정으로 로그인할 때 사용하려고 하는 매핑된 로그인 이름을 표시합니다. |
permission path |
sysname | 계정 액세스를 허용한 그룹 멤버 자격입니다. |
설명
@acctnamexp_logininfo지정된 Windows 사용자 또는 그룹의 가장 높은 권한 수준을 보고합니다. Windows 사용자가 시스템 관리자 및 도메인 사용자로 모두 액세스할 수 있는 경우 시스템 관리자로 보고됩니다. 사용자가 동일한 권한 수준의 여러 Windows 그룹의 구성원인 경우 SQL Server에 대한 액세스 권한이 처음 부여된 그룹만 보고됩니다.
@acctname SQL Server 로그인과 연결되지 않은 유효한 Windows 사용자 또는 그룹인 경우 빈 결과 집합이 반환됩니다. @acctname 유효한 Windows 사용자 또는 그룹으로 식별할 수 없는 경우 오류 메시지가 반환됩니다.
@acctnameallWindows 사용자 또는 그룹에 대한 모든 권한 경로가 반환됩니다.
@acctname 모두 SQL Server에 대한 액세스 권한이 부여된 여러 그룹의 멤버인 경우 여러 행이 반환됩니다. 권한 행은 admin 권한 행 앞에 user 반환되고 권한 수준 내에서 해당 SQL Server 로그인을 만든 순서대로 행이 반환됩니다.
@acctnamemembers그룹의 다음 수준 멤버 목록이 반환됩니다. @acctname 로컬 그룹인 경우 목록에는 로컬 사용자, 도메인 사용자 및 그룹이 포함될 수 있습니다. @acctname 도메인 계정인 경우 목록은 도메인 사용자로 구성됩니다. 그룹 멤버 자격 정보를 검색하려면 SQL Server가 도메인 컨트롤러에 연결해야 합니다. 서버가 도메인 컨트롤러에 연결할 수 없는 경우 정보가 반환되지 않습니다.
xp_logininfo 는 범용 그룹이 아닌 Active Directory 전역 그룹의 정보만 반환합니다.
사용 권한
서버에 대한 CONTROL SERVER 권한이 필요하거나 xp_logininfoEXECUTE 권한이 부여된 master 데이터베이스의 사용자 계정이 필요합니다.
예제
다음 예제에서는 Windows 그룹에 대한 BUILTIN\Administrators 정보를 표시합니다.
EXECUTE xp_logininfo 'BUILTIN\Administrators';