sp_dropserver (Transact-SQL)

THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)yesAzure SQL Database (Managed Instance only)noAzure SQL Data Warehouse noParallel Data Warehouse

Removes a server from the list of known remote and linked servers on the local instance of SQL Server.

Important

On Azure SQL Database Managed Instance, this T-SQL feature has certain behavior changes. See Azure SQL Database Managed Instance T-SQL differences from SQL Server for details for all T-SQL behavior changes.

Topic link icon Transact-SQL Syntax Conventions

Syntax


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

Arguments

[ @server = ] 'server'
Is the server to be removed. server is sysname, with no default. server must exist.

[ @droplogins = ] 'droplogins' | NULL
Indicates that related remote and linked server logins for server must also be removed if droplogins is specified. @droplogins is char(10), with a default of NULL.

Return Code Values

0 (success) or 1 (failure)

Remarks

If you run sp_dropserver on a server that has associated remote and linked server login entries, or is configured as a replication publisher, an error message is returned. To remove all remote and linked server logins for a server when you remove the server, use the droplogins argument.

sp_dropserver cannot be executed inside a user-defined transaction.

Permissions

Requires ALTER ANY LINKED SERVER permission on the server.

Examples

The following example removes the remote server ACCOUNTS and all associated remote logins from the local instance of SQL Server.

sp_dropserver 'ACCOUNTS', 'droplogins';  

See Also

Security Stored Procedures (Transact-SQL)
sp_addserver (Transact-SQL)
sp_dropremotelogin (Transact-SQL)
sp_helpremotelogin (Transact-SQL)
sp_helpserver (Transact-SQL)
System Stored Procedures (Transact-SQL)