Partager via


sp_ActiveDirectory_Obj (Transact-SQL)

Contrôle l'inscription d'une base de données MicrosoftSQL Server dans Microsoft Windows Active Directory.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sp_ActiveDirectory_Obj [ @Action = N'action'
     [ , [@ObjType = ] N'database' ]
          , [ @ObjName = ] N'database_name'

Arguments

  • [ @Action = ] N'action'
    Spécifie si l'objet Active Directory qui inscrit la base de données SQL Server doit être créé, mis à jour ou supprimé. action est de type nvarchar(20), avec N'create' comme valeur par défaut.

    Valeur

    Description

    create

    Inscrit la base de données SQL Server dans Active Directory en créant un objet MS-SQL-SQLDatabasedans l'annuaire. L'objet MS-SQL-SQLDatabase enregistre les attributs de la base de données au moment de l'exécution de l'action. Si vous spécifiez cette valeur et que la base de données est déjà inscrite, l'objet est mis à jour.

    update

    Actualise les attributs inscrits pour la base de données dans Active Directory en mettant à jour les attributs enregistrés dans l'objet MS-SQL-SQLDatabase au sein d'Active Directory.

    delete

    Supprime l'inscription Active Directory de la base de données en supprimant l'objet MS-SQL-SQLDatabase dans Active Directory.

  • [ @ObjType = ] N'database'
    Spécifie que sp_ActiveDirectory_Obj exécute l'action demandée sur un objet de base de données dans Active Directory. N'database' est de type nvarchar(15), avec N'database' comme valeur par défaut. Il s'agit de la seule valeur possible.

  • [ @ObjName = ] N'database_name'
    Spécifie le nom de la base de données pour laquelle l'action d'inscription est effectuée. database_name est de type sysname et vous devez spécifier une valeur. L'argument database_name doit spécifier le nom d'une base de données existant dans l'instance de SQL Server au sein de laquelle la procédure sp_ActiveDirectory_Obj est exécutée. database_name doit être conforme aux règles des identificateurs.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

Aucun

Notes

L'instance en cours de SQL Server doit être inscrite dans Active Directory avant que vous puissiez inscrire l'une des bases de données dans l'instance. Si vous supprimez l'inscription de l'instance d'Active Directory, toutes les inscriptions de bases de données dans cette instance seront également supprimées.

Les bases de données sont les seules entités que vous pouvez inscrire dans Active Directory en utilisant directement sp_ActiveDirectory_Obj. Pour contrôler l'inscription des instances de SQL Server dans Active Directory, utilisez sp_ActiveDirectory_SCP.

[!REMARQUE]

L'inscription d'Active Directory peut uniquement être modifiée par le compte qui l'a créée. Lorsque vous changez le compte de sécurité utilisé par le service SQL Server, supprimez l'inscription Active Directory, modifiez le compte de service, puis recréez l'inscription Active Directory.

Autorisations

Nécessite l'appartenance au rôle de serveur fixe sysadmin ou au rôle de base de données fixe db_owner.

Exemples

Dans l'exemple suivant, la base de données AdventureWorks est inscrite dans Active Directory à partir de l'instance actuelle de SQL Server.

DECLARE @RetCode INT

EXEC @RetCode = sp_ActiveDirectory_Obj @Action = N'create',
     @ObjType = N'database',
     @ObjName = N'AdventureWorks'

PRINT 'Return code = ' + CAST(@RetCode AS VARCHAR)