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

SE APLICA A: síSQL Server (a partir de 2008) noAzure SQL Database noAzure SQL Data Warehouse noAlmacenamiento de datos paralelos APPLIES TO: yesSQL Server (starting with 2008) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

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 de Windows o grupo que se le 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 sysname, su valor predeterminado es null.account_name is sysname, with a default of NULL. Si account_name no se especifica, todos los grupos de Windows y los usuarios de Windows que se han explícitamente permiso de inicio de sesión se notifican.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 un nombre 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 varchar (10), su valor predeterminado es null.@option** is varchar(10), with a default of NULL. A menos que todas se especifica, se muestra solo la primera ruta 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 privilegio 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 varchar (10), su valor predeterminado es 'Not wanted'.variable_name is varchar(10), with a default of 'Not wanted'. El nivel de privilegio devuelto es usuario, admin, o 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 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.
Tipotype char(8)char(8) Tipo de cuenta de Windows.Type of Windows account. Los valores válidos son usuario o grupo.Valid values are user or group.
privilegeprivilege char(9)char(9) Privilegio de acceso para SQL ServerSQL Server.Access privilege for SQL ServerSQL Server. Los valores válidos son admin, usuario, o null.Valid values are admin, user, or null.
nombre de inicio de sesión asignadomapped login name sysnamesysname Cuentas de usuario que tienen privilegio de usuario, asigna el nombre de inicio de sesión muestra el nombre de inicio de sesión asignado que SQL ServerSQL Server intenta usar al iniciar sesión con esta cuenta mediante el uso de las reglas de asociación 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.
ruta de acceso de permisopermission path sysnamesysname Pertenencia al grupo que permite que la cuenta tenga acceso.Group membership that allowed the account access.

ComentariosRemarks

Si account_name se especifica, xp_logininfo notifica el nivel de privilegios más alto del grupo o usuario 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 usuario de Windows o grupo que no está asociado con válido 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 account_name no se puede identificar como un usuario válido de Windows o un grupo, 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 account_name y todas son especificado, se devuelven todas las rutas de permisos para el usuario de Windows o grupo.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, que ha concedido acceso a SQL ServerSQL Server, se devuelven varias filas.If account_name is a member of multiple groups, all of which have been granted access to SQL ServerSQL Server, multiple rows are returned. El admin se devuelven las filas del privilegio antes el usuario filas del privilegio y, dentro de un privilegio de nivel de filas devueltas en el orden en que el correspondiente SQL ServerSQL Server se crearon inicios de sesión.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 account_name y miembros son especificado, se devuelve una lista de los miembros del siguiente nivel 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, los 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 se compone de los 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 sólo devuelve información de grupos globales de Active Directory, los grupos universales no.xp_logininfo only returns information from Active Directory global groups, not universal groups.

PermisosPermissions

Requiere la pertenencia a la sysadmin fijo de servidor o la pertenencia a la pública rol fijo de base de datos en el maestro base de datos con permiso de ejecución.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

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

EXEC xp_logininfo 'BUILTIN\Administrators';  

Vea tambiénSee Also

sp_denylogin (Transact-SQL) sp_denylogin (Transact-SQL)
sp_grantlogin (Transact-SQL) sp_grantlogin (Transact-SQL)
sp_revokelogin (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)