sp_delete_targetserver (Transact-SQL)

S'applique à : SQL Server

Supprime le serveur spécifié de la liste des serveurs cibles disponibles.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_delete_targetserver
    [ @server_name = ] N'server_name'
    [ , [ @clear_downloadlist = ] clear_downloadlist ]
    [ , [ @post_defection = ] post_defection ]
[ ; ]

Arguments

[ @server_name = ] N’server_name'

Nom du serveur qui doit cesser d'être un serveur cible disponible. @server_name est sysname, sans valeur par défaut.

[ @clear_downloadlist = ] clear_downloadlist

Indique s'il faut effacer la liste de téléchargement du serveur cible. @clear_downloadlist est bit, avec la valeur par défaut 1.

  • Lorsque @clear_downloadlist est 1, la procédure efface la liste de téléchargement du serveur avant de supprimer le serveur.
  • Lorsque @clear_downloadlist est 0, la liste de téléchargement n’est pas effacée.

[ @post_defection = ] post_defection

Indique s'il faut publier une instruction de désinscription sur le serveur cible. @post_defection est bit, avec la valeur par défaut 1.

  • Lorsque @post_defection est 1, la procédure publie une instruction de défaut sur le serveur cible avant de supprimer le serveur.
  • Lorsque @post_defection est 0, la procédure ne publie pas d’instruction de défaut sur le serveur cible.

Valeurs des codes de retour

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

Jeu de résultats

Aucune.

Notes

La méthode normale de suppression d’un serveur cible consiste à appeler sp_msx_defect sur le serveur cible. Utilisez sp_delete_targetserver uniquement lorsqu’une défection manuelle est nécessaire.

autorisations

Pour exécuter cette procédure stockée, les utilisateurs doivent disposer du rôle serveur fixe sysadmin .

Exemples

L'exemple ci-dessous supprime le serveur LONDON1 de la liste des serveurs de travail disponibles.

USE msdb;
GO

EXEC dbo.sp_delete_targetserver
    @server_name = N'LONDON1';
GO