sp_dropserver (Transact-sql)sp_dropserver (Transact-SQL)

適用対象: ○SQL Server ○Azure SQL Database (Managed Instance のみ) XAzure Synapse Analytics (SQL DW) XParallel Data Warehouse APPLIES TO: YesSQL Server YesAzure SQL Database (Managed Instance only) NoAzure Synapse Analytics (SQL DW) NoParallel Data Warehouse

SQL ServerSQL Server のローカル インスタンスにある、既知のリモート サーバーおよびリンク サーバーの一覧からサーバーを削除します。Removes a server from the list of known remote and linked servers on the local instance of SQL ServerSQL Server.

リンク アイコン Transact-SQL 構文表記規則link icon Transact-SQL Syntax Conventions

構文Syntax

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

引数Arguments

serverserver
削除するサーバーを指定します。Is the server to be removed. server のデータ型は sysnameで、既定値はありません。server is sysname, with no default. サーバーが存在している必要があります。server must exist.

droploginsdroplogins
Droploginsを指定した場合に、サーバーの関連するリモートサーバーおよびリンクサーバーログインも削除する必要があることを示します。Indicates that related remote and linked server logins for server must also be removed if droplogins is specified. @droplogins の型はchar (10) で、既定値は NULL です。@droplogins is char(10), with a default of NULL.

リターン コードの値Return Code Values

0 (成功) または 1 (失敗)0 (success) or 1 (failure)

解説Remarks

リモートおよびリンクサーバーのログインエントリが関連付けられているサーバーでsp_dropserverを実行した場合、またはレプリケーションパブリッシャーとして構成されている場合は、エラーメッセージが返されます。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. サーバーを削除するときに、サーバーのすべてのリモートおよびリンクサーバーのログインを削除するには、 droplogins引数を使用します。To remove all remote and linked server logins for a server when you remove the server, use the droplogins argument.

sp_dropserverは、ユーザー定義のトランザクション内では実行できません。sp_dropserver cannot be executed inside a user-defined transaction.

アクセス許可Permissions

サーバーに対する ALTER ANY LINKED SERVER 権限が必要です。Requires ALTER ANY LINKED SERVER permission on the server.

使用例Examples

次の例では、リモート サーバー ACCOUNTS とそれに関連するすべてのリモート ログインを、SQL ServerSQL Server のローカル インスタンスから削除します。The following example removes the remote server ACCOUNTS and all associated remote logins from the local instance of SQL ServerSQL Server.

sp_dropserver 'ACCOUNTS', 'droplogins';  

参照See Also

セキュリティストアドプロシージャ (Transact-sql) Security Stored Procedures (Transact-SQL)
sp_addserver (Transact-sql) sp_addserver (Transact-SQL)
sp_dropremotelogin (Transact-sql) sp_dropremotelogin (Transact-SQL)
sp_helpremotelogin (Transact-sql) sp_helpremotelogin (Transact-SQL)
sp_helpserver (Transact-sql) sp_helpserver (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)System Stored Procedures (Transact-SQL)