sp_addsrvrolemember (Transact-SQL)

S’applique à :SQL Server

Ajoute une connexion ou un principal de sécurité en tant que membre d’un rôle serveur fixe.

Important

Cette fonctionnalité sera supprimée dans une version future de SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez plutôt ALTER SERVER ROLE .

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_addsrvrolemember
    [ @loginame = ] N'loginame'
    [ , [ @rolename = ] N'rolename' ]
[ ; ]

Arguments

[ @loginame = ] N’loginame'

Nom du principal de sécurité ajouté au rôle serveur fixe. @loginame est sysname, sans valeur par défaut. @loginame peut être une connexion SQL Server ou un compte Windows. Si le compte Windows n’est pas déjà autorisé à accéder à SQL Server, l’accès est automatiquement accordé.

[ @rolename = ] N’rolename'

Nom du rôle serveur fixe auquel le principal de sécurité est ajouté. @rolename est sysname, avec une valeur par défaut NULL, et doit être l’une des valeurs suivantes :

  • sysadmin
  • securityadmin
  • serveradmin
  • setupadmin
  • processadmin
  • diskadmin
  • dbcreator
  • bulkadmin

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

Lorsqu’un principal de sécurité est ajouté à un rôle serveur fixe, il obtient les autorisations associées à ce rôle.

L’appartenance au rôle de l’utilisateur sa et du public ne peut pas être modifiée.

Permet sp_addrolemember d’ajouter un membre à une base de données fixe ou à un rôle défini par l’utilisateur.

sp_addsrvrolemember ne peut pas être exécuté dans une transaction définie par l’utilisateur.

Autorisations

Il faut appartenir au rôle auquel le nouveau membre est ajouté.

Exemples

L’exemple suivant ajoute le compte Corporate\HelenS Windows au rôle serveur fixe sysadmin .

EXEC sp_addsrvrolemember 'Corporate\HelenS', 'sysadmin';
GO