xp_logininfo (Transact-SQL)

Artikel
06/18/2013

Gibt Informationen zu Windows-Benutzern und Windows-Gruppen zurück.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @acctname = ] 'account_name'
Der Name eines Windows-Benutzers oder einer Windows-Gruppe, dem bzw. der Zugriff auf SQL Server gewährt wird. account_name ist vom Datentyp sysname und hat den Standardwert NULL. Wenn account_name nicht angegeben wird, werden alle Windows-Gruppen und Windows-Benutzer ausgegeben, denen explizit Anmeldeberechtigungen gewährt wurden. account_name muss vollqualifiziert sein. Beispiel: 'ADVWKS4\macraes' oder 'VORDEFINIERT\Administratoren'.
'all' | 'members'
Gibt an, ob für das Konto die Informationen zu allen Berechtigungspfaden oder nur die Informationen zu den Mitgliedern der Windows-Gruppe ausgegeben werden sollen. @option ist vom Datentyp varchar(10), der Standardwert ist NULL. Sofern nicht all angegeben wurde, wird nur der erste Berechtigungspfad angezeigt.
[ @privilege = ] variable_name
Ein Ausgabeparameter, der die Berechtigungsstufe des angegebenen Windows-Kontos zurückgibt. variable_name ist vom Datentyp varchar(10). Der Standardwert ist "Not wanted". Die zurückgegebene Privilegstufe ist user, admin oder null.
OUTPUT
Wenn dieser Parameter angegeben wird, wird variable_name in den Ausgabeparameter platziert.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Spaltenname	Datentyp	Beschreibung
Kontoname	sysname	Der vollqualifizierte Windows-Kontoname.
Typ	char(8)	Der Windows-Kontotyp. Gültige Werte sind user oder group.
privilege	char(9)	Das Zugriffsprivileg für SQL Server. Gültige Werte sind admin, user oder null.
mapped login name	sysname	Für Benutzerkonten mit Benutzerprivileg wird mit mapped login name der zugeordnete Anmeldename angezeigt, den SQL Server bei der Anmeldung mit diesem Konto zu verwenden versucht. Dabei werden die Zuordnungsregeln mit Voranstellung des Domänennamens verwendet.
permission path	sysname	Die Gruppenmitgliedschaft, die dem Konto den Zugriff ermöglicht hat.

Hinweise

Wird account_name angegeben, meldet xp_logininfo die höchste Privilegstufe des angegebenen Windows-Benutzers bzw. der angegebenen Windows-Gruppe. Wenn ein Windows-Benutzer Zugriff als Systemadministrator und als Domänenbenutzer hat, wird er nur als Systemadministrator gemeldet. Gehört der Benutzer mehreren Windows-Gruppen derselben Privilegstufe an, wird nur die Gruppe gemeldet, der zuerst Zugriff auf SQL Server erteilt wurde.

Wenn account_name ein gültiger Windows-Benutzer oder eine gültige Windows-Gruppe ist, dem bzw. der kein SQL Server-Anmeldename zugeordnet ist, wird ein leeres Resultset zurückgegeben. Wenn account_name nicht als gültiger Windows-Benutzer oder als gültige Windows-Gruppe identifiziert werden kann, wird ein Fehler gemeldet.

Werden account_name und all angegeben, werden sämtliche Berechtigungspfade für den Windows-Benutzer oder die Windows-Gruppe zurückgegeben. Wenn account_name mehreren Gruppen angehört, denen allen Zugriff auf SQL Server erteilt wurde, werden mehrere Zeilen zurückgegeben. Die Zeilen für das admin-Privileg werden vor den Zeilen für das user-Privileg zurückgegeben. Innerhalb einer Privilegstufe werden die Zeilen in der Reihenfolge zurückgegeben, in der die entsprechenden SQL Server-Anmeldenamen erstellt wurden.

Wenn account_name und members angegeben werden, wird eine Liste der Gruppenmitglieder der nächsten Ebene zurückgegeben. Ist account_name der Name einer lokalen Gruppe, kann die Liste lokale Benutzer, Domänenbenutzer und Gruppen enthalten. Wenn account_name ein Domänenkonto ist, besteht die Liste aus Domänenbenutzern. SQL Server muss eine Verbindung mit dem Domänencontroller herstellen, um Informationen zu Gruppenmitgliedschaften abzurufen. Falls der Server keine Verbindung mit dem Domänencontroller herstellen kann, werden keine Informationen zurückgegeben.

xp_logininfo gibt nur Informationen von globalen Active Directory-Gruppen zurück und nicht für universelle Gruppen.

Berechtigungen

Mitgliedschaft in der festen Serverrolle sysadmin bzw. Mitgliedschaft in der festen Datenbankrolle public in der master-Datenbank mit erteilter EXECUTE-Berechtigung erforderlich.

Beispiele

Im folgenden Beispiel werden Informationen zur Windows-Gruppe BUILTIN\Administrators angezeigt.

EXEC xp_logininfo 'BUILTIN\Administrators'

Siehe auch

Verweis

sp_denylogin (Transact-SQL)

sp_grantlogin (Transact-SQL)

sp_revokelogin (Transact-SQL)

Gespeicherte Systemprozeduren (Transact-SQL)

Allgemeine erweiterte gespeicherte Prozeduren (Transact-SQL)

Freigeben über