xp_logininfo (Transact-SQL)xp_logininfo (Transact-SQL)

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions)

Devuelve información sobre usuarios y grupos de Windows.Returns information about Windows users and Windows groups.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

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

ArgumentosArguments

[ @acctname = ] 'account_name' Es el nombre de un usuario o grupo de Windows al que se ha concedido acceso a SQL ServerSQL Server .[ @acctname = ] 'account_name' Is the name of a Windows user or group granted access to SQL ServerSQL Server. account_name es de tipo sysname y suvalor predeterminado es NULL.account_name is sysname, with a default of NULL. Si no se especifica account_name , se indicarán todos los grupos de Windows y los usuarios de Windows a los que se haya concedido explícitamente permiso de inicio de sesión.If account_name is not specified, all Windows groups and Windows users that have been explicitly granted login permission are reported. account_name debe ser completo.account_name must be fully qualified. Por ejemplo, 'ADVWKS4\macraes' o 'BUILTIN\Administrators'.For example, 'ADVWKS4\macraes', or 'BUILTIN\Administrators'.

' All ' | ' Members ''all' | 'members'
Especifica si se presenta información de todas las rutas de acceso a permisos de la cuenta o si se presenta información de los miembros del grupo de Windows.Specifies whether to report information about all permission paths for the account, or to report information about the members of the Windows group. ** @ Option** es de tipo VARCHAR (10) y su valor predeterminado es NULL.@option is varchar(10), with a default of NULL. A menos que se especifique All , solo se muestra la primera ruta de acceso de permisos.Unless all is specified, only the first permission path is displayed.

[ @privilege = ] variable_name Es un parámetro de salida que devuelve el nivel de privilegios de la cuenta de Windows especificada.[ @privilege = ] variable_name Is an output parameter that returns the privilege level of the specified Windows account. variable_name es de tipo VARCHAR (10) y su valor predeterminado es ' no se desea '.variable_name is varchar(10), with a default of 'Not wanted'. El nivel de privilegio devuelto es User, admino null.The privilege level returned is user, admin, or null.

OUTPUTOUTPUT
Cuando se especifica, coloca variable_name en el parámetro de salida.When specified, puts variable_name in the output parameter.

Valores de código de retornoReturn Code Values

0 (correcto) o 1 (error)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

Nombre de la columnaColumn name Tipo de datosData type DescripciónDescription
nombre de cuentaaccount name sysnamesysname Nombre completo de la cuenta de Windows.Fully qualified Windows account name.
typetype Char (8)char(8) Tipo de cuenta de Windows.Type of Windows account. Los valores válidos son User o Group.Valid values are user or group.
privilegiaprivilege char(9)char(9) Privilegio de acceso para SQL ServerSQL Server.Access privilege for SQL ServerSQL Server. Los valores válidos son admin, Usero null.Valid values are admin, user, or null.
mapped login namemapped login name sysnamesysname En el caso de las cuentas de usuario que tienen privilegios de usuario, nombre de inicio de sesión asignado muestra el nombre de inicio de sesión asignado que SQL ServerSQL Server intenta usar al iniciar sesión con esta cuenta mediante las reglas asignadas con el nombre de dominio agregado antes.For user accounts that have user privilege, mapped login name shows the mapped login name that SQL ServerSQL Server tries to use when logging in with this account by using the mapped rules with the domain name added before it.
permission pathpermission path sysnamesysname Pertenencia al grupo que permite que la cuenta tenga acceso.Group membership that allowed the account access.

ObservacionesRemarks

Si se especifica account_name , xp_logininfo notifica el nivel de privilegios más alto del usuario o grupo de Windows especificado.If account_name is specified, xp_logininfo reports the highest privilege level of the specified Windows user or group. Si un usuario de Windows tiene acceso como administrador del sistema y como usuario del dominio, se le notificará como administrador del sistema.If a Windows user has access as both a system administrator and as a domain user, it will be reported as a system administrator. Si el usuario es miembro de varios grupos de Windows del mismo nivel de privilegio, solo se le notificará en el grupo al que se concediera primero acceso a SQL ServerSQL Server.If the user is a member of multiple Windows groups of equal privilege level, only the group that was first granted access to SQL ServerSQL Server is reported.

Si account_name es un grupo o usuario de Windows válido que no está asociado a un SQL ServerSQL Server Inicio de sesión, se devuelve un conjunto de resultados vacío.If account_name is a valid Windows user or group that is not associated with a SQL ServerSQL Server login, an empty result set is returned. Si no se puede identificar account_name como un usuario o grupo de Windows válido, se devuelve un mensaje de error.If account_name cannot be identified as a valid Windows user or group, an error message is returned.

Si se especifican account_name y All , se devuelven todas las rutas de acceso de permisos para el usuario o grupo de Windows.If account_name and all are specified, all permission paths for the Windows user or group are returned. Si account_name es un miembro de varios grupos, SQL ServerSQL Server se devuelven varias filas a las que se les ha concedido acceso a.If account_name is a member of multiple groups, all of which have been granted access to SQL ServerSQL Server, multiple rows are returned. Las filas con privilegios de Administrador se devuelven antes que las filas de privilegios de usuario y, dentro de una fila de nivel de privilegios, se devuelven en el orden en que SQL ServerSQL Server se crearon los inicios de sesión correspondientes.The admin privilege rows are returned before the user privilege rows, and within a privilege level rows are returned in the order in which the corresponding SQL ServerSQL Server logins were created.

Si se especifican account_name y miembros , se devuelve una lista de los miembros de nivel siguiente del grupo.If account_name and members are specified, a list of the next-level members of the group is returned. Si account_name es un grupo local, la lista puede incluir usuarios locales, usuarios del dominio y grupos.If account_name is a local group, the listing can include local users, domain users, and groups. Si account_name es una cuenta de dominio, la lista está formada por usuarios del dominio.If account_name is a domain account, the list is made up of domain users. SQL ServerSQL Server debe conectarse al controlador de dominio para recuperar la información de pertenencia a grupos.must connect to the domain controller to retrieve group membership information. Si el servidor no puede contactar con el controlador de dominio, no se obtendrá ninguna información.If the server cannot contact the domain controller, no information will be returned.

xp_logininfo solo devuelve información de Active Directory grupos globales, no de grupos universales.xp_logininfo only returns information from Active Directory global groups, not universal groups.

PermisosPermissions

Requiere la pertenencia al rol fijo de servidor sysadmin o la pertenencia al rol fijo de base de datos Public en la base de datos maestra con el permiso Execute concedido.Requires membership in the sysadmin fixed server role or membership in the public fixed database role in the master database with EXECUTE permission granted.

EjemplosExamples

En el ejemplo siguiente se muestra información sobre el BUILTIN\Administrators grupo de Windows.The following example displays information about the BUILTIN\Administrators Windows group.

EXEC xp_logininfo 'BUILTIN\Administrators';  

Consulte tambiénSee Also

sp_denylogin ()de Transact-SQL sp_denylogin (Transact-SQL)
sp_grantlogin ()de Transact-SQL sp_grantlogin (Transact-SQL)
sp_revokelogin ()de Transact-SQL sp_revokelogin (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL) System Stored Procedures (Transact-SQL)
Procedimientos almacenados extendidos generales (Transact-SQL)General Extended Stored Procedures (Transact-SQL)