sp_dropserver (Transact-SQL)

适用于SQL Server Azure SQL 托管实例

从 SQL Server 本地实例上的已知远程服务器和链接服务器列表中删除服务器。

Transact-SQL 语法约定

语法

sp_dropserver
    [ @server = ] N'server'
    [ , [ @droplogins = ] 'droplogins' ]
[ ; ]

参数

[ @server = ] N'server'

要删除的服务器。 @server为 sysname,无默认值。 @server 必须存在。

[ @droplogins = ] 'droplogins'

指示如果指定了@droplogins,还必须删除@server的相关远程和链接服务器登录名。 @droplogins为 char(10),默认值为 NULL.

返回代码值

0(成功)或 1(失败)。

注解

如果在具有关联远程和链接服务器登录条目的服务器上运行 sp_dropserver ,或配置为复制发布服务器,则返回错误。 若要在删除服务器时删除服务器的所有远程和链接服务器登录名,请使用 @droplogins 参数。

sp_dropserver 不能在用户定义的事务内执行。

用于 sp_dropserver 更改本地服务器名称可能会导致意外影响或不受支持的配置。

权限

要求具有对服务器的 ALTER ANY LINKED SERVER 权限。

示例

以下示例从 SQL Server 的本地实例中删除远程服务器 ACCOUNTS 和所有关联的远程登录名。

EXEC sp_dropserver 'ACCOUNTS', 'droplogins';