sp_delete_targetserver (Transact-SQL)

Aplica-se a: SQL Server

Remove o servidor especificado da lista de servidores de destino disponíveis.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@server_name [ = ] N'server_name'

O nome do servidor a ser removido como um servidor de destino disponível. @server_name é sysname, sem padrão.

@clear_downloadlist [ = ] clear_downloadlist

Especifica se a lista de download para o servidor de destino deve ser limpa. @clear_downloadlist é bit, com um padrão de 1.

  • Quando @clear_downloadlist é 1, o procedimento limpa a lista de downloads do servidor antes de excluí-lo.
  • Quando @clear_downloadlist é 0, a lista de downloads não é limpa.

@post_defection [ = ] post_defection

Especifica se uma instrução de defeito deve ser postada para o servidor de destino. @post_defection é bit, com um padrão de 1.

  • Quando @post_defection é 1, o procedimento posta uma instrução de defeito no servidor de destino antes de excluir o servidor.
  • Quando @post_defection é 0, o procedimento não posta uma instrução de defeito no servidor de destino.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

A maneira normal de excluir um servidor de destino é chamar sp_msx_defect o servidor de destino. Use sp_delete_targetserver somente quando uma deserção manual for necessária.

Permissões

Para executar esse procedimento armazenado, os usuários devem receber a função de servidor fixa sysadmin .

Exemplos

O exemplo a seguir remove o servidor LONDON1 dos servidores de trabalho disponíveis.

USE msdb;
GO

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