Partager via


sp_ActiveDirectory_SCP (Transact-SQL)

Contrôle l'inscription d'une instance de MicrosoftSQL Server dans Microsoft Windows Active Directory. Les actions de la procédure stockée sp_ActiveDirectory_SCP s'appliquent toujours à l'instance connectée de SQL Server.

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

Syntaxe

sp_ActiveDirectory_SCP [ @Action = ] N'action'

Arguments

  • [ @Action = ] N'action'
    Spécifie si l'objet Active Directory qui inscrit l'instance de 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 l'instance de SQL Server dans Active Directory en créant un objet MS-SQL-SQLServer dans l'annuaire. L'objet MS-SQL-SQLServer enregistre les attributs de l'instance de SQL Server au moment de l'exécution de l'action. Si vous spécifiez cette valeur alors que l'instance est déjà inscrite, l'objet est mis à jour.

    update

    Actualise les attributs inscrits pour l'instance active de SQL Server dans Active Directory. Met à jour les attributs enregistrés dans l'objet MS-SQL-SQLServer dans Active Directory.

    delete

    Annule l'inscription Active Directory pour l'instance active de SQL Server. Supprime l'objet MS-SQL-SQLServer dans Active Directory. Efface également les inscriptions de toutes les bases de données et publications dans l'instance.

Valeurs des codes de retour

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

Ensembles de résultats

Aucun

Notes

Après avoir inscrit une instance de SQL Server dans Active Directory, vous pouvez utiliser sp_ActiveDirectory_Obj pour inscrire n'importe quelle base de données de l'instance et vous pouvez utiliser sp_addpublication ou sp_addmergepublication pour inscrire des publications.

[!REMARQUE]

Seul le compte créateur de l'inscription Active Directory peut modifier cette inscription. 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.

Exemple

L'exemple suivant inscrit l'instance active de SQL Server dans Active Directory.

DECLARE @RetCode INT

EXEC @RetCode = sp_ActiveDirectory_SCP @Action = N'create'

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