sp_dropserver (Transact-SQL)
Applies to:
SQL Server
Azure SQL Managed Instance
Removes a server from the list of known remote and linked servers on the local instance of SQL Server.
Transact-SQL syntax conventions
Syntax
sp_dropserver [ @server = ] 'server'
[ , [ @droplogins = ] { 'droplogins' | NULL} ]
Arguments
server
Is the server to be removed. server is sysname, with no default. server must exist.
droplogins
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.
sp_dropserver to change the local server name may cause unintended effects or unsupported configurations.
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)