xp_logininfo (T-SQL)

Berlaku untuk:SQL Server

Mengembalikan informasi tentang pengguna Windows dan grup Windows.

Konvensi sintaks transact-SQL

Sintaks

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

Argumen

[ @acctname = ] '@acctname'

Nama pengguna atau grup Windows yang diberikan akses ke SQL Server. @acctname adalah sysname, dengan default NULL. Jika @acctname tidak ditentukan, semua grup Windows dan pengguna Windows yang secara eksplisit diberikan izin masuk akan dilaporkan. @acctname harus sepenuhnya memenuhi syarat. Misalnya, CONTOSO\macraes atau BUILTIN\Administrators.

[ @option = ] 'semua' | 'anggota'

Menentukan apakah akan melaporkan informasi tentang semua jalur izin untuk akun tersebut, atau melaporkan informasi tentang anggota grup Windows. @option adalah varchar(10), dengan default NULL. Kecuali all ditentukan, hanya jalur izin pertama yang ditampilkan.

[ @privilege = ] 'variable_name' OUTPUT

Parameter output yang mengembalikan tingkat hak istimewa dari akun Windows yang ditentukan. @privilege adalah varchar(10), dengan default Not wanted. Tingkat hak istimewa yang dikembalikan adalah user, admin, atau null.

Ketika OUTPUT ditentukan, opsi ini menempatkan @privilege dalam parameter output.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Nama kolom Jenis data Deskripsi
account name nama sysname Nama akun Windows yang sepenuhnya memenuhi syarat.
type karakter(8) Jenis akun Windows. Nilai yang valid adalah user atau group.
privilege karakter(9) Hak istimewa akses untuk SQL Server. Nilai yang valid adalah admin, user, atau NULL.
mapped login name nama sysname Untuk akun pengguna yang memiliki hak istimewa pengguna, mapped login name menunjukkan nama login yang dipetakan yang coba digunakan SQL Server saat masuk dengan akun ini dengan menggunakan aturan yang dipetakan dengan nama domain yang ditambahkan sebelum akun tersebut.
permission path nama sysname Keanggotaan grup yang mengizinkan akses akun.

Keterangan

Jika @acctname ditentukan, xp_logininfo laporkan tingkat hak istimewa tertinggi pengguna atau grup Windows yang ditentukan. Jika pengguna Windows memiliki akses sebagai administrator sistem dan sebagai pengguna domain, pengguna tersebut dilaporkan sebagai administrator sistem. Jika pengguna adalah anggota dari beberapa grup Windows dengan tingkat hak istimewa yang sama, hanya grup yang pertama kali diberikan akses ke SQL Server, yang dilaporkan.

Jika @acctname adalah pengguna atau grup Windows yang valid yang tidak terkait dengan login SQL Server, kumpulan hasil kosong dikembalikan. Jika @acctname tidak dapat diidentifikasi sebagai pengguna atau grup Windows yang valid, pesan kesalahan akan dikembalikan.

Jika @acctname dan all ditentukan, semua jalur izin untuk pengguna atau grup Windows dikembalikan. Jika @acctname adalah anggota dari beberapa grup, yang semuanya diberikan akses ke SQL Server, beberapa baris dikembalikan. Baris admin hak istimewa dikembalikan sebelum user baris hak istimewa, dan dalam tingkat hak istimewa, baris dikembalikan dalam urutan pembuatan login SQL Server yang sesuai.

Jika @acctname dan members ditentukan, daftar anggota grup tingkat berikutnya dikembalikan. Jika @acctname adalah grup lokal, daftar dapat menyertakan pengguna lokal, pengguna domain, dan grup. Jika @acctname adalah akun domain, daftar tersebut terdiri dari pengguna domain. SQL Server harus tersambung ke pengendali domain untuk mengambil informasi keanggotaan grup. Jika server tidak dapat menghubungi pengendali domain, tidak ada informasi yang dikembalikan.

xp_logininfo hanya mengembalikan informasi dari grup global Direktori Aktif, bukan grup universal.

Izin

Memerlukan izin CONTROL SERVER di server, atau akun pengguna dalam database master dengan izin EXECUTE diberikan pada xp_logininfo.

Contoh

Contoh berikut menampilkan informasi tentang BUILTIN\Administrators grup Windows.

EXECUTE xp_logininfo 'BUILTIN\Administrators';

Konten terkait

  • Last updated on