sp_dropserver (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server Azure SQL Managed Instance

Entfernt einen Server aus der Liste bekannter Remote- und verknüpfter Server in der lokalen Instanz von SQL Server.

Syntax

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

Argumente

[ @server = ] N'server'

Der server, der entfernt werden soll. @server ist "sysname" ohne Standard. @server müssen vorhanden sein.

[ @droplogins = ] 'droplogins'

Gibt an, dass verwandte Remote- und verknüpfte Serveranmeldungen für @server auch entfernt werden müssen, wenn @droplogins angegeben ist. @droplogins ist Char(10) mit einem Standardwert von NULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

Es wird ein Fehler zurückgegeben, wenn Sie auf einem Server mit zugeordneten Remote- und verknüpften Serveranmeldungseinträgen oder sp_dropserver als Replikationsherausgeber konfiguriert werden. Um alle Remote- und verknüpften Serveranmeldungen für einen Server zu entfernen, wenn Sie den Server entfernen, verwenden Sie das Argument @droplogins .

sp_dropserver kann nicht innerhalb einer benutzerdefinierten Transaktion ausgeführt werden.

Die Verwendung sp_dropserver zum Ändern des lokalen Servernamens kann zu unbeabsichtigten Auswirkungen oder nicht unterstützten Konfigurationen führen.

Berechtigungen

Erfordert die ALTER ANY LINKED SERVER-Berechtigung auf dem Server.

Beispiele

Im folgenden Beispiel werden der Remoteserver ACCOUNTS und alle zugeordneten Remoteanmeldungen aus der lokalen Instanz von SQL Server entfernt.

EXEC sp_dropserver 'ACCOUNTS', 'droplogins';

Freigeben über