xp_logininfo (Transact-SQL)

A következőkre vonatkozik:SQL Server

Adatokat ad vissza a Windows-felhasználókról és a Windows-csoportokról.

Transact-SQL szintaxis konvenciói

Szintaxis

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

Érvek

[ @acctname = ] '@acctname'

Az SQL Serverhez hozzáférést biztosító Windows-felhasználó vagy -csoport neve. @acctnamesysname, alapértelmezett értéke NULL. Ha nincs megadva @acctname, a rendszer minden olyan Windows-csoportot és Windows-felhasználót jelent, aki kifejezetten bejelentkezési engedélyt kap. @acctname teljes mértékben minősítettnek kell lennie. Például CONTOSO\macraesvagy BUILTIN\Administrators.

[ @option = ] "mind" | 'tagok'

Megadja, hogy a fiók összes engedélyútvonalával kapcsolatos információkat, illetve a Windows-csoport tagjaival kapcsolatos információkat jelentse-e. @optionvarchar(10), alapértelmezett értéke NULL. Ha nincs megadva all, csak az első engedély elérési útja jelenik meg.

[ @privilege = ] 'variable_name' OUTPUT

Egy kimeneti paraméter, amely a megadott Windows-fiók jogosultsági szintjét adja vissza. @privilegevarchar(10), alapértelmezett értéke Not wanted. A visszaadott jogosultsági szint user, adminvagy null.

Ha OUTPUT van megadva, ez a beállítás @privilege helyez a kimeneti paraméterbe.

Kódértékek visszaadása

0 (sikeres) vagy 1 (hiba).

Eredményhalmaz

Oszlop neve Adattípus Leírás
account name sysname Teljes windowsos fióknév.
type karakter(8) A Windows-fiók típusa. Az érvényes értékek user vagy group.
privilege karakter(9) Hozzáférési jogosultság az SQL Serverhez. Az érvényes értékek a következők: admin, uservagy NULL.
mapped login name sysname Felhasználói jogosultsággal rendelkező felhasználói fiókok esetén mapped login name az SQL Server által a fiókba való bejelentkezéskor használni kívánt leképezett bejelentkezési nevet jeleníti meg a leképezett szabályok és az előtte hozzáadott tartománynév használatával.
permission path sysname Csoporttagság, amely engedélyezte a fiók elérését.

Megjegyzések

Ha @acctname van megadva, xp_logininfo a megadott Windows-felhasználó vagy -csoport legmagasabb jogosultsági szintjét jelenti. Ha egy Windows-felhasználó rendszergazdaként és tartományi felhasználóként is rendelkezik hozzáféréssel, a rendszer rendszergazdaként jelenti. Ha a felhasználó több egyenlő jogosultsági szintű Windows-csoport tagja, a rendszer csak azt a csoportot jelenti, amely először kap hozzáférést az SQL Serverhez.

Ha @acctname érvényes Windows-felhasználó vagy -csoport, amely nincs SQL Server-bejelentkezéshez társítva, a rendszer üres eredményhalmazt ad vissza. Ha @acctname nem azonosítható érvényes Windows-felhasználóként vagy -csoportként, hibaüzenet jelenik meg.

Ha @acctname és all van megadva, a rendszer visszaadja a Windows-felhasználó vagy -csoport összes engedélyútvonalát. Ha @acctname több csoport tagja, amelyek mindegyike hozzáférést kap az SQL Serverhez, a rendszer több sort ad vissza. A admin jogosultsági sorokat a rendszer a user jogosultsági sorok előtt adja vissza, és egy jogosultsági szinten belül a sorokat a megfelelő SQL Server-bejelentkezések létrehozásának sorrendjében adja vissza.

Ha @acctname és members van megadva, a rendszer visszaadja a csoport következő szintű tagjainak listáját. Ha @acctname helyi csoport, akkor a lista tartalmazhat helyi felhasználókat, tartományi felhasználókat és csoportokat. Ha @acctname tartományi fiók, a lista tartományi felhasználókból áll. Az SQL Servernek csatlakoznia kell a tartományvezérlőhöz a csoporttagság adatainak lekéréséhez. Ha a kiszolgáló nem tud kapcsolatba lépni a tartományvezérlővel, a rendszer nem ad vissza információt.

xp_logininfo csak az Active Directory globális csoportjaitól, nem pedig az univerzális csoportoktól ad vissza információkat.

Engedélyek

A kiszolgálón CONTROL SERVER engedélyre van szükség, vagy egy felhasználói fiókra master adatbázisban EXECUTE engedéllyel xp_logininfo.

Példák

Az alábbi példa a BUILTIN\Administrators Windows-csoportra vonatkozó információkat jeleníti meg.

EXECUTE xp_logininfo 'BUILTIN\Administrators';