| title | xp_grantlogin (Transact-SQL) | ||
|---|---|---|---|
| description | Grants a Windows group or user access to SQL Server. | ||
| author | VanMSFT | ||
| ms.author | vanto | ||
| ms.reviewer | randolphwest | ||
| ms.date | 06/23/2025 | ||
| ms.service | sql | ||
| ms.subservice | system-objects | ||
| ms.topic | reference | ||
| f1_keywords |
|
||
| helpviewer_keywords |
|
||
| dev_langs |
|
[!INCLUDE SQL Server]
Grants a Windows group or user access to [!INCLUDE ssNoVersion].
Important
[!INCLUDE ssNoteDepFutureAvoid] Use CREATE LOGIN instead.
:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions
xp_grantlogin { [ @loginame = ] 'login' } [ , [ @logintype = ] 'logintype' ]
The name of the Windows user or group to be added. The Windows user or group must be qualified with a Windows domain name in the form <domain>\<user>. @loginame is sysname, with no default.
The security level of the login being granted access. @logintype is varchar(5), with a default of NULL. Only admin can be specified. If admin is specified, @loginame is granted access to [!INCLUDE ssNoVersion], and added as a member of the sysadmin fixed server role.
0 (success) or 1 (failure).
xp_grantlogin is a system stored procedure instead of an extended stored procedure. xp_grantlogin calls sp_grantlogin and sp_addsrvrolemember.
Requires membership in the securityadmin fixed server role. Changing the @logintype requires membership in the sysadmin fixed server role.