sp_dropserver (Transact-SQL)

Supprime un serveur dans la liste des serveurs liés et distants connus sur l'instance locale de SQL Server.

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

Syntaxe

sp_dropserver [ @server = ] 'server' 
     [ , [ @droplogins = ] { 'droplogins' | NULL} ]

Arguments

  • [ @server = ] 'server'
    Serveur à supprimer. server et de type sysname et n'a pas de valeur par défaut. server doit exister.

  • [ @droplogins = ] 'droplogins' | NULL
    Indique qu'il faudra également supprimer les connexions d'accès des serveurs lié et distant associés à server si droplogins est spécifié. @droplogins est de type char(10), avec NULL comme valeur par défaut.

Valeurs des codes de retour

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

Notes

Si vous exécutez sp_dropserver sur un serveur qui a des entrées de connexion de serveur lié et distant associées, ou qui est configuré en tant qu'éditeur de réplication, un message d'erreur est retourné. Pour supprimer toutes les connexions d'accès aux serveurs lié et distant associés à un serveur lorsque vous supprimez ce serveur, utilisez l'argument droplogins.

La procédure sp_dropserver ne peut pas être exécutée dans une transaction définie par l'utilisateur.

Autorisations

ALTER ANY LINKED SERVER sur le serveur.

Exemple

L'exemple suivant supprime le serveur distant ACCOUNTS et toutes les connexions d'accès distant qui lui sont associées dans l'instance locale de SQL Server.

sp_dropserver 'ACCOUNTS', 'droplogins';